Swapper<T>

Defined in: atomiq-sdk/src/swapper/Swapper.ts:246

Core orchestrator for all atomiq swap operations

Extends

• EventEmitter<{ lpsAdded: [Intermediary[]]; lpsRemoved: [Intermediary[]]; swapLimitsChanged: []; swapState: [ISwap]; }>

Type Parameters

Type Parameter
T extends MultiChain

Properties

intermediaryDiscovery

readonly intermediaryDiscovery: IntermediaryDiscovery;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:304

Intermediary discovery instance

---

prices

readonly prices: ISwapPrice<T>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:300

Pricing API used by the SDK

---

SwapTypeInfo

readonly SwapTypeInfo: Record<SwapType, {
  requiresInputWallet: boolean;
  requiresOutputWallet: boolean;
  supportsGasDrop: boolean;
}>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2140

Helper information about various swap protocol and their features:

• requiresInputWallet: Whether a swap requires a connected wallet on the input chain able to sign arbitrary transaction
• requiresOutputWallet: Whether a swap requires a connected wallet on the output chain able to sign arbitrary transactions
• supportsGasDrop: Whether a swap supports the "gas drop" feature, allowing to user to receive a small amount of native token as part of the swap when swapping to smart chains

Uses a Record type here, use the SwapProtocolInfo import for a literal readonly type, with pre-filled exact values in the type.

---

Utils

readonly Utils: SwapperUtils<T>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:308

Miscellaneous utility functions

Methods

_syncSwaps()

_syncSwaps<C>(chainId?, signer?): Promise<void>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1842

Synchronizes swaps from on-chain, this is ran automatically when SDK is initialized, hence should only be ran manually when dontCheckPastSwaps=true is passed in the swapper options, also deletes expired quotes

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
chainId?	C	Optional chain identifier to only run swap sync for a single smart chain
signer?	string	Optional signer to only run swap sync for swaps initiated by this signer

Returns

Promise<void>

---

create()

create<C>(
   signer, 
   srcToken, 
   dstToken, 
   amount, 
   exactIn, 
addressLnurlLightningInvoice?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1400

Creates a swap from srcToken to dstToken, of a specific token amount, either specifying input amount (exactIn=true) or output amount (exactIn=false), NOTE: For regular -> BTC-LN (lightning) swaps the passed amount is ignored and invoice's pre-set amount is used instead.

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
signer	string	Smartchain (Solana, Starknet, etc.) address of the user
srcToken	Token<C>	Source token of the swap, user pays this token
dstToken	Token<C>	Destination token of the swap, user receives this token
amount	bigint	Amount of the swap
exactIn	boolean	Whether the amount specified is an input amount (exactIn=true) or an output amount (exactIn=false)
addressLnurlLightningInvoice?	| string | LNURLPay | LNURLWithdraw	Bitcoin on-chain address, lightning invoice, LNURL-pay to pay or LNURL-withdrawal to withdraw money from

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>

Deprecated

Use swap instead

---

createFromBTCLNSwap()

createFromBTCLNSwap<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<FromBTCLNSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1150

Creates LEGACY Bitcoin Lightning -> Smart chain (SwapType.FROM_BTCLN) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	FromBTCLNOptions	undefined	Additional options for the swap

Returns

Promise<FromBTCLNSwap<T[ChainIdentifier]>>

---

createFromBTCLNSwapNew()

createFromBTCLNSwapNew<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<FromBTCLNAutoSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1241

Creates Bitcoin Lightning -> Smart chain (SwapType.FROM_BTCLN_AUTO) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	FromBTCLNAutoOptions	undefined	Additional options for the swap

Returns

Promise<FromBTCLNAutoSwap<T[ChainIdentifier]>>

---

createFromBTCLNSwapNewViaLNURL()

createFromBTCLNSwapNewViaLNURL<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   lnurl, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<FromBTCLNAutoSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1286

Creates Bitcoin Lightning -> Smart chain (SwapType.FROM_BTCLN_AUTO) swap, withdrawing from an LNURL-withdraw link

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
lnurl	string | LNURLWithdraw	undefined	LNURL-withdraw link to pull the funds from
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	FromBTCLNAutoOptions	undefined	Additional options for the swap

Returns

Promise<FromBTCLNAutoSwap<T[ChainIdentifier]>>

---

createFromBTCLNSwapViaLNURL()

createFromBTCLNSwapViaLNURL<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   lnurl, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<FromBTCLNSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1195

Creates LEGACY Bitcoin Lightning -> Smart chain (SwapType.FROM_BTCLN) swap, withdrawing from an LNURL-withdraw link

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
lnurl	string | LNURLWithdraw	undefined	LNURL-withdraw link to pull the funds from
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	FromBTCLNOptions	undefined	Additional options for the swap

Returns

Promise<FromBTCLNSwap<T[ChainIdentifier]>>

---

createFromBTCSwap()

createFromBTCSwap<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<FromBTCSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1107

Creates LEGACY Bitcoin -> Smart chain (SwapType.FROM_BTC) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	FromBTCOptions	undefined	Additional options for the swap

Returns

Promise<FromBTCSwap<T[ChainIdentifier]>>

---

createFromBTCSwapNew()

createFromBTCSwapNew<ChainIdentifier>(
   chainIdentifier, 
   recipient, 
   tokenAddress, 
   amount, 
   exactOut, 
   additionalParams, 
options?): Promise<SpvFromBTCSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1064

Creates Bitcoin -> Smart chain (SwapType.SPV_VAULT_FROM_BTC) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the destination smart chain
recipient	string	undefined	Recipient address on the destination chain
tokenAddress	string	undefined	Token address to receive
amount	bigint	undefined	Amount to send in satoshis (if exactOut=false) or receive in token based units (if exactOut=true)
exactOut	boolean	false	Whether to use a exact out instead of exact in
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	SpvFromBTCOptions	undefined	Additional options for the swap

Returns

Promise<SpvFromBTCSwap<T[ChainIdentifier]>>

---

createToBTCLNSwap()

createToBTCLNSwap<ChainIdentifier>(
   chainIdentifier, 
   signer, 
   tokenAddress, 
   paymentRequest, 
   additionalParams, 
options?): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:924

Creates Smart chain -> Bitcoin Lightning (SwapType.TO_BTCLN) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Description
chainIdentifier	ChainIdentifier	Chain identifier string of the source smart chain
signer	string	Signer's address on the source chain
tokenAddress	string	Token address to pay with
paymentRequest	string	BOLT11 lightning network invoice to be paid (needs to have a fixed amount), and the swap amount is taken from this fixed amount, hence only exact output swaps are supported
additionalParams	Record<string, any>	Additional parameters sent to the LP when creating the swap
options?	ToBTCLNOptions	Additional options for the swap

Returns

Promise<ToBTCLNSwap<T[ChainIdentifier]>>

---

createToBTCLNSwapViaInvoiceCreateService()

createToBTCLNSwapViaInvoiceCreateService<ChainIdentifier>(
   chainIdentifier, 
   signer, 
   tokenAddress, 
   service, 
   amount, 
   exactIn, 
   additionalParams, 
options?): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1019

Creates Smart chain -> Bitcoin Lightning (SwapType.TO_BTCLN) swap via LightningInvoiceCreateService

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the source smart chain
signer	string	undefined	Signer's address on the source chain
tokenAddress	string	undefined	Token address to pay with
service	LightningInvoiceCreateService	undefined	Invoice create service object which facilitates the creation of fixed amount LN invoices
amount	bigint	undefined	Amount to send in token based units (if exactIn=true) or receive in satoshis (if exactIn=false)
exactIn	boolean	false	Whether to do an exact in swap instead of exact out
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	ToBTCLNOptions	undefined	Additional options for the swap

Returns

Promise<ToBTCLNSwap<T[ChainIdentifier]>>

---

createToBTCLNSwapViaLNURL()

createToBTCLNSwapViaLNURL<ChainIdentifier>(
   chainIdentifier, 
   signer, 
   tokenAddress, 
   lnurlPay, 
   amount, 
   exactIn, 
   additionalParams, 
options?): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:972

Creates Smart chain -> Bitcoin Lightning (SwapType.TO_BTCLN) swap via LNURL-pay link

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the source smart chain
signer	string	undefined	Signer's address on the source chain
tokenAddress	string	undefined	Token address to pay with
lnurlPay	string | LNURLPay	undefined	LNURL-pay link to use for the payment
amount	bigint	undefined	Amount to send in token based units (if exactIn=true) or receive in satoshis (if exactIn=false)
exactIn	boolean	false	Whether to do an exact in swap instead of exact out
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	ToBTCLNOptions & object	undefined	Additional options for the swap

Returns

Promise<ToBTCLNSwap<T[ChainIdentifier]>>

---

createToBTCSwap()

createToBTCSwap<ChainIdentifier>(
   chainIdentifier, 
   signer, 
   tokenAddress, 
   address, 
   amount, 
   exactIn, 
   additionalParams, 
options?): Promise<ToBTCSwap<T[ChainIdentifier]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:875

Creates Smart chain -> Bitcoin (SwapType.TO_BTC) swap

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Default value	Description
chainIdentifier	ChainIdentifier	undefined	Chain identifier string of the source smart chain
signer	string	undefined	Signer's address on the source chain
tokenAddress	string	undefined	Token address to pay with
address	string	undefined	Recipient's bitcoin address
amount	bigint	undefined	Amount to send in token based units (if exactIn=true) or receive in satoshis (if exactIn=false)
exactIn	boolean	false	Whether to use exact in instead of exact out
additionalParams	Record<string, any>	...	Additional parameters sent to the LP when creating the swap
options?	ToBTCOptions	undefined	Additional options for the swap

Returns

Promise<ToBTCSwap<T[ChainIdentifier]>>

---

createTrustedLNForGasSwap()

createTrustedLNForGasSwap<C>(
   chainIdentifier, 
   recipient, 
   amount, 
trustedIntermediaryOrUrl?): Promise<LnForGasSwap<T[C]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1330

Creates a trusted Bitcoin Lightning -> Smart chain (SwapType.TRUSTED_FROM_BTCLN) gas swap

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
chainIdentifier	C	Chain identifier string of the destination smart chain
recipient	string	Recipient address on the destination chain
amount	bigint	Amount of native token to receive, in base units
trustedIntermediaryOrUrl?	string | Intermediary	URL or Intermediary object of the trusted intermediary to use, otherwise uses default

Returns

Promise<LnForGasSwap<T[C]>>

Throws

If no trusted intermediary specified

---

createTrustedOnchainForGasSwap()

createTrustedOnchainForGasSwap<C>(
   chainIdentifier, 
   recipient, 
   amount, 
   refundAddress?, 
trustedIntermediaryOrUrl?): Promise<OnchainForGasSwap<T[C]>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1351

Creates a trusted Bitcoin -> Smart chain (SwapType.TRUSTED_FROM_BTC) gas swap

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
chainIdentifier	C	Chain identifier string of the destination smart chain
recipient	string	Recipient address on the destination chain
amount	bigint	Amount of native token to receive, in base units
refundAddress?	string	Bitcoin refund address, in case the swap fails the funds are refunded here
trustedIntermediaryOrUrl?	string | Intermediary	URL or Intermediary object of the trusted intermediary to use, otherwise uses default

Returns

Promise<OnchainForGasSwap<T[C]>>

Throws

If no trusted intermediary specified

---

getActionableSwaps()

Call Signature

getActionableSwaps(): Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1566

Returns all swaps where an action is required (either claim or refund)

Returns

Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>[]>

Call Signature

getActionableSwaps<C>(chainId, signer?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1570

Returns swaps where an action is required (either claim or refund) for the specific chain, and optionally also for a specific signer's address

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type
chainId	C
signer?	string

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>

---

getAllSwaps()

Call Signature

getAllSwaps(): Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1542

Returns all swaps

Returns

Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>[]>

Call Signature

getAllSwaps<C>(chainId, signer?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1546

Returns all swaps for the specific chain, and optionally also for a specific signer's address

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type
chainId	C
signer?	string

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>

---

getClaimableSwaps()

Call Signature

getClaimableSwaps(): Promise<IClaimableSwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, IClaimableSwap<ChainType, any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1639

Returns all swaps that are manually claimable

Returns

Promise<IClaimableSwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, IClaimableSwap<ChainType, any, any>>, number>[]>

Call Signature

getClaimableSwaps<C>(chainId, signer?): Promise<IClaimableSwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, IClaimableSwap<T[C], any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1643

Returns all swaps that are manually claimable for the specific chain, and optionally also for a specific signer's address

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type
chainId	C
signer?	string

Returns

Promise<IClaimableSwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, IClaimableSwap<T[C], any, any>>, number>[]>

---

getRefundableSwaps()

Call Signature

getRefundableSwaps(): Promise<IToBTCSwap<ChainType, IToBTCDefinition<ChainType, IToBTCWrapper<ChainType, any, ISwapWrapperOptions>, IToBTCSwap<ChainType, any>>>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1603

Returns all swaps that are refundable

Returns

Promise<IToBTCSwap<ChainType, IToBTCDefinition<ChainType, IToBTCWrapper<ChainType, any, ISwapWrapperOptions>, IToBTCSwap<ChainType, any>>>[]>

Call Signature

getRefundableSwaps<C>(chainId, signer?): Promise<IToBTCSwap<T[C], IToBTCDefinition<T[C], IToBTCWrapper<T[C], any, ISwapWrapperOptions>, IToBTCSwap<T[C], any>>>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1607

Returns swaps which are refundable for the specific chain, and optionally also for a specific signer's address

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type
chainId	C
signer?	string

Returns

Promise<IToBTCSwap<T[C], IToBTCDefinition<T[C], IToBTCWrapper<T[C], any, ISwapWrapperOptions>, IToBTCSwap<T[C], any>>>[]>

---

getSmartChains()

getSmartChains(): ChainIds<T>[];

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2055

Returns an array of all the supported smart chains

Returns

ChainIds<T>[]

---

getSupportedTokens()

getSupportedTokens(input): Token[];

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2188

Returns an array of supported tokens either on the input or on the output of a swap

Parameters

Parameter	Type	Description
input	boolean | SwapSide	Whether to return input tokens or output tokens

Returns

Token[]

---

getSwapById()

Call Signature

getSwapById(id): Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1677

Returns swap with a specific id (identifier)

Parameters

Parameter	Type
id	string

Returns

Promise<ISwap<ChainType, SwapTypeDefinition<ChainType, ISwapWrapper<ChainType, any, ISwapWrapperOptions>, ISwap<ChainType, any, any>>, number>>

Call Signature

getSwapById<C>(
   id, 
   chainId, 
signer?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1681

Returns swap with a specific id (identifier) on a specific chain and optionally with a signer

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type
id	string
chainId	C
signer?	string

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>

---

getSwapCounterTokens()

getSwapCounterTokens(token, input): Token[];

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2291

Returns tokens that you can swap to (if input=true) from a given token, or tokens that you can swap from (if input=false) to a given token

Parameters

Parameter	Type
token	Token
input	boolean | SwapSide

Returns

Token[]

---

getSwapLimits()

getSwapLimits<C, A, B>(srcToken, dstToken): object;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2152

Returns minimum/maximum limits for inputs and outputs for a swap between given tokens

Type Parameters

Type Parameter
C extends string
A extends Token<C>
B extends Token<C>

Parameters

Parameter	Type	Description
srcToken	A	Source token
dstToken	B	Destination token

Returns

object

Name	Type	Defined in
input	object	atomiq-sdk/src/swapper/Swapper.ts:2153
input.max?	TokenAmount<A>	atomiq-sdk/src/swapper/Swapper.ts:2153
input.min	TokenAmount<A>	atomiq-sdk/src/swapper/Swapper.ts:2153
output	object	atomiq-sdk/src/swapper/Swapper.ts:2154
output.max?	TokenAmount<B>	atomiq-sdk/src/swapper/Swapper.ts:2154
output.min	TokenAmount<B>	atomiq-sdk/src/swapper/Swapper.ts:2154

---

getSwapType()

getSwapType<C>(srcToken, dstToken): 
  | FROM_BTC
  | FROM_BTCLN
  | TO_BTC
  | TO_BTCLN
  | SPV_VAULT_FROM_BTC
  | FROM_BTCLN_AUTO;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2094

Returns type of the swap based on input and output tokens specified

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
srcToken	Token<C>	Source token
dstToken	Token<C>	Destination token

Returns

| FROM_BTC | FROM_BTCLN | TO_BTC | TO_BTCLN | SPV_VAULT_FROM_BTC | FROM_BTCLN_AUTO

---

getToken()

Returns the Token object for a given token

Param

Token to return the object for, can use multiple formats:

• a) token ticker, such as "BTC", "SOL", etc.
• b) token ticker prefixed with smart chain identifier, such as "SOLANA-SOL", "SOLANA-USDC", etc.
• c) token address

Call Signature

getToken(ticker): BtcToken<false>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1997

Parameters

Parameter	Type
ticker	"BTC" | "BITCOIN-BTC"

Returns

BtcToken<false>

Call Signature

getToken(ticker): BtcToken<true>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1998

Parameters

Parameter	Type
ticker	"BTCLN" | "BTC-LN" | "LIGHTNING-BTC"

Returns

BtcToken<true>

Call Signature

getToken<ChainIdentifier>(ticker): SCToken<ChainIdentifier>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1999

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type
ticker	`${ChainIdentifier}-${string}`

Returns

SCToken<ChainIdentifier>

Call Signature

getToken(tickerOrAddress): Token<ChainIds<T>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2000

Parameters

Parameter	Type
tickerOrAddress	string

Returns

Token<ChainIds<T>>

---

getTypedSwapById()

getTypedSwapById<C, S>(
   id, 
   chainId, 
   swapType, 
signer?): Promise<SwapTypeMapping<T[C]>[S]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1735

Returns the swap with a proper return type, or undefined if not found or has wrong type

Type Parameters

Type Parameter
C extends string
S extends SwapType

Parameters

Parameter	Type	Description
id	string	An ID of the swap (ISwap.getId)
chainId	C	Chain identifier of the smart chain where the swap was initiated
swapType	S	Type of the swap
signer?	string	An optional required smart chain signer address to fetch the swap for

Returns

Promise<SwapTypeMapping<T[C]>[S]>

---

init()

init(): Promise<void>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:656

Initializes the swap storage and loads existing swaps, needs to be called before any other action

Returns

Promise<void>

---

recoverSwaps()

recoverSwaps<C>(
   chainId, 
   signer, 
startBlockheight?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1864

Recovers swaps from on-chain historical data.

Please note that the recovered swaps might not be complete (i.e. missing amounts or addresses), as some of the swap data is purely off-chain and can never be recovered purely from on-chain data. This functions tries to recover as much swap data as possible.

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
chainId	C	Smart chain identifier string to recover the swaps from
signer	string	Signer address to recover the swaps for
startBlockheight?	number	Optional starting blockheight for swap data recovery, will only check swaps initiated after this blockheight

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>[]>

---

stop()

stop(): Promise<void>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:675

Stops listening for onchain events and closes this Swapper instance

Returns

Promise<void>

---

supportsSwapType()

supportsSwapType<ChainIdentifier, Type>(chainId, swapType): SupportsSwapType<T[ChainIdentifier], Type>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2065

Returns whether the SDK supports a given swap type on a given chain based on currently known LPs

Type Parameters

Type Parameter
ChainIdentifier extends string
Type extends SwapType

Parameters

Parameter	Type	Description
chainId	ChainIdentifier	Smart chain identifier string
swapType	Type	Swap protocol type

Returns

SupportsSwapType<T[ChainIdentifier], Type>

---

swap()

swap<C>(
   srcToken, 
   dstToken, 
   amount, 
   exactIn, 
   src, 
   dst, 
options?): Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1456

Creates a swap from srcToken to dstToken, of a specific token amount, either specifying input amount (if exactIn=true) or output amount (if exactIn=false), NOTE: For regular Smart chain -> BTC-LN (lightning) swaps the passed amount is ignored and invoice's pre-set amount is used instead, use LNURL-pay links for dynamic amounts

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
srcToken	string | Token<C>	Source token of the swap, user pays this token
dstToken	string | Token<C>	Destination token of the swap, user receives this token
amount	string | bigint	Amount of the swap either in base units as {bigint} or in human readable format (with decimals) as {string}
exactIn	boolean | SwapAmountType	Whether the amount specified is an input amount (exactIn=true) or an output amount (exactIn=false)
src	string | LNURLWithdraw	Source wallet/lnurl-withdraw of the swap
dst	| string | LNURLPay | LightningInvoiceCreateService	Destination smart chain address, bitcoin on-chain address, lightning invoice, LNURL-pay
options?	| ToBTCOptions | SpvFromBTCOptions | FromBTCOptions | FromBTCLNOptions | FromBTCLNAutoOptions | ToBTCLNOptions & object	Options for the swap

Returns

Promise<ISwap<T[C], SwapTypeDefinition<T[C], ISwapWrapper<T[C], any, ISwapWrapperOptions>, ISwap<T[C], any, any>>, number>>

---

wipeStorage()

wipeStorage<C>(chainId?, signer?): Promise<void>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:1810

Deletes the swaps from the persistent storage backend. Note that some data (like lightning network amounts and bolt11 invoices) are purely off-chain and can never be recovered later just from on-chain data!

Type Parameters

Type Parameter
C extends string

Parameters

Parameter	Type	Description
chainId?	C	Optional, to only delete swaps for this smart chain
signer?	string	Optional, to only delete swaps for this smart chain signer (chainId param must be set to delete only signer's swaps)

Returns

Promise<void>

---

withChain()

withChain<ChainIdentifier>(chainIdentifier): SwapperWithChain<T, ChainIdentifier>;

Defined in: atomiq-sdk/src/swapper/Swapper.ts:2047

Creates a child swapper instance with a given smart chain

Type Parameters

Type Parameter
ChainIdentifier extends string

Parameters

Parameter	Type	Description
chainIdentifier	ChainIdentifier	Smart chain identifier for the created child swapper instance

Returns

SwapperWithChain<T, ChainIdentifier>