BoltzApiClientV2 and SwapScript. React Native exposes the same surface as Python with camelCase names, generated from the same bindings. The published TypeScript declarations (dist/index.d.ts) document every type in full.
KaleidoSwap
Quote, start, and resume swaps, with claims and refunds done by the SDK. The KaleidoSwap API explains each call.
Swap
Stores, signers, and helpers
The
Asset values are bitcoin:BTC, lightning:BTC, liquid:BTC, liquid:USDT, arkade:BTC, spark:BTC, bitcoin:rgb:<contract>, lightning:rgb:<contract>, and spark:<token>. Python builds them with Asset.BTC_ONCHAIN(), Asset.BTC_LIGHTNING(), Asset.BTC_LIQUID(), and so on. Every asset can be named; the routes served today are a subset.
React Native exposes the same classes as Python with camelCase names.
SwapClient
The maker API client. In TypeScript it comes from SwapClient.forNetwork, new SwapClient(baseUrl, timeoutSecs?), createKaleidoOrgClient, or createKaleidoMakerClient. In Python: SwapClient.default(network), SwapClient(base_url, timeout), SwapClient.kaleido_org(...), or SwapClient.kaleido_maker(...).
Pairs and chain data
Swaps
In Python, RGB swaps set
rgb_contract_id (and optionally rgb_max_htlc_sat) on the request instead of passing extra arguments, and L-USDT swaps set lusdt_asset_id. lusdtAssetId is required for L-USDT on testnet and regtest.
Corridor and atomic routes
Partner credentials
SwapScript
The swap script rebuilt on your side, and the claim and refund builder.
chain is "bitcoin" or "liquid". Python uses snake_case and takes a SwapTransactionParams with a Fee.RELATIVE(sat_per_vb) or Fee.ABSOLUTE(sats).
SwapMasterKey
SwapWsApi
Higher-level helpers (TypeScript)
Numbers in TypeScript
- Parameters declared
bigintneed aBigInt(0n); a plain number throws aTypeErrorbefore the SDK can attach a code. - 64-bit fields inside request objects accept
bigint | number. Unsafe numbers aboveNumber.MAX_SAFE_INTEGERare rejected before the request is sent. - 64-bit response fields are always
bigint, including amounts, timestamps, and the restore index. 32-bit fields (key indexes, output indexes, reverse and chain timeout heights) staynumber. - Serialize responses with
toJson, notJSON.stringify.