Skip to content
docs

Usdt0Swap2Config

Defined in: protocol-swap2-usdt0/src/protocol.ts:6

optional accountChain?: string

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:66

Optional account chain identity when the account does not expose a provider.

Swap2EngineConfig.accountChain


optional allowUnlistedTokens?: boolean

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:107

Accept tokens the swap catalog does not list, named by their contract (EVM) or mint (Solana): tokens the user added at their own risk. Off by default. The source token’s decimals are read with the account’s getTokenInfo (a fromTokenDecimals that disagrees is refused); an account without it must be given fromTokenDecimals. Only providers that trade any token (LI.FI, Uniswap, Balancer, Fynd, Jupiter) quote them, and they have no USD value: the router cannot judge their price, so show the user the amounts.

Swap2EngineConfig.allowUnlistedTokens


optional decodeTonBody?: (bocBase64) => unknown

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:74

Decodes a base64 BoC into a TON Cell for deposits that carry a cell body (e.g. Omniston escrow payloads). The package deliberately does not depend on @ton/core; the caller supplies e.g. (b) => Cell.fromBase64(b). Without it, cell-body deposits fail closed — a TON account treats a string body as a TEXT COMMENT, which would strand the swap.

string

unknown

Swap2EngineConfig.decodeTonBody


optional enabled?: boolean

Defined in: protocol-swap2-usdt0/src/provider.ts:73

Usdt0ProviderConfig.enabled


optional fetchImpl?: {(input, init?): Promise<Response>; (input, init?): Promise<Response>; }

Defined in: protocol-swap2-usdt0/src/provider.ts:85

Injectable for tests (also used by the RPC transport).

(input, init?): Promise<Response>

MDN Reference

RequestInfo | URL

RequestInit

Promise<Response>

(input, init?): Promise<Response>

MDN Reference

string | Request | URL

RequestInit

Promise<Response>

Usdt0ProviderConfig.fetchImpl


fromChain: string

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:60

CAIP-2 of the chain the bound account lives on (the swap2 source).

Swap2EngineConfig.fromChain


optional maxNetworkFeeBps?: number | bigint

Defined in: core/dist/index-QWdcwE6y.d.ts:429

Maximum acceptable network fee, basis points of the input amount.

Swap2EngineConfig.maxNetworkFeeBps


optional maxProtocolFeeBps?: number | bigint

Defined in: core/dist/index-QWdcwE6y.d.ts:431

Maximum acceptable protocol fee, basis points of the input amount.

Swap2EngineConfig.maxProtocolFeeBps


optional onExecutionPhase?: (phase, detail?) => void

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:62

Progress observer, see Swap2ExecutionPhase.

Swap2ExecutionPhase

Swap2ExecutionPhaseDetail

void

Swap2EngineConfig.onExecutionPhase


optional quoteTtlMs?: number

Defined in: protocol-swap2-usdt0/src/provider.ts:83

Local lifetime of a quote (default 60 s; the sealed fee is re-checked at preflight).

Usdt0ProviderConfig.quoteTtlMs


optional reviewExecution?: (plan) => void | Promise<void>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:98

Review gate: called once the live quote is built and every payload/value check has passed, BEFORE any approval or signature. It receives a copy of exactly what will be signed; throwing (the user cancelled) aborts with nothing sent. A quote that expires while the gate is open is refused before the first approval. When the quote expires while the engine’s own approval is being mined, the engine re-quotes once; if the fresh quote differs from the reviewed one (payload, gas, a worse output) the gate is called again with requoted: true, and throwing then revokes the allowance.

Swap2ExecutionPlan

void | Promise<void>

Swap2EngineConfig.reviewExecution


optional rpcUrls?: Readonly<Record<string, string | readonly string[]>>

Defined in: protocol-swap2-usdt0/src/provider.ts:79

JSON-RPC URL(s) per CAIP-2 chain. REQUIRED for every chain the provider should quote from: the fee and the received amount come from the OFT itself. The destination RPC is optional (used for the stored-payload retry).

Usdt0ProviderConfig.rpcUrls


optional scanUrl?: string

Defined in: protocol-swap2-usdt0/src/provider.ts:81

LayerZero Scan base (default https://scan.layerzero-api.com).

Usdt0ProviderConfig.scanUrl


optional serializedNativeAllowance?: string | number | bigint

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:81

Provider-SERIALIZED legs (a swap aggregator’s fully built Solana transaction): how much native coin, in base units, the account may lose on top of the swap input — rent for a destination token account, wrapped SOL juggling, priority fees. Default 20 000 000 lamports (0.02 SOL).

Swap2EngineConfig.serializedNativeAllowance


optional skipAccountChainCheck?: boolean

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:64

Explicit escape hatch for adapters that can prove chain binding elsewhere.

Swap2EngineConfig.skipAccountChainCheck


optional tonGasCeiling?: string | number | bigint

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:87

The most nanoTON a TON cell-body deposit may attach as gas: on top of the input for a native source, the whole attached value for a jetton source (default 1 TON; live Omniston swaps attach 0.1–0.4). A build attaching more is refused (scan 2026-10-27 modules, F7).

Swap2EngineConfig.tonGasCeiling