@debridge-finance/dln-client

dln-client by deBridge

A client SDK that facilitates interaction deSwap Liquidity Network (DLN) contracts on Solana and EVM blockchains. DLN is built on top of the deBridge cross-chain messaging protocol.

A note on calculating execution fees and take cost

Consider looking at https://github.com/debridge-finance/dln-ts-client/pull/63 for definitions

DLN order creation and expenses

Main flow:

Order creation -> Fulfill / Cancel -> Send unlock -> Claim

After order creation you need to send fulfill, unlock transactions. Also, if order has calldata you need to store and execute it.

Solana to EVM

Transactions order:

1. Order creation (Solana)
2. Fulfill (EVM) / Cancel (EVM)
3. Send unlock (EVM)
4. Claim (Solana)
5. Execution calldata (Solana)

Order creation

Transaction example. This transaction contains the following expenses and returns:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
CreateOrderWithNonce	rent	giveOrderState	176	-2115840
	rent	giveOrderWallet	165	-2039280
	rent	nonceMaster	16	-1002240	Is added when dln nonce account doesn't exists
	tx fee			-5000
	priority fee

Claim

Claim transaction follows after fulfill/cancel and send unlock transactions in source chain. Transaction example. This transaction contains the following expenses and returns:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
Claim	rent	claimToWallet	165	-2039280	Should be returned after claim
	rent	submission	194	-2241120	Should be returned after claim
	rent return	confirmationStorage		+5909040
	tx fee			-5000
	priority fee

Execution calldata

Before calldata execution you need to fulfill order. Transaction example. This transaction contains the following expenses and returns:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
ExecuteExternalCall	rent return	externalCallStorage		[phone]
	rent return	externalCallMeta		+1085760
	rent return	submissionWallet		+2039280
	tx fee			-5000
	priority fee

EVM to Solana

Transactions order:

1. Order creation (EVM)
2. Fulfill (Solana) / Cancel (Solana)
3. Send unlock (Solana)
4. Claim (EVM)
5. Execution calldata (EVM)

Fulfill

Creates accounts for on-chain data storing which contains order state and additional accounts for calldata.
Transaction example. This transaction contains the following expenses and returns:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
FulfillOrder	rent	takeOrderState	106	-1628640
InitializeExtcallMeta	rent	externalCallMeta	200	-2282880	Creates if order contains calldata
	rent	executeWallet	165	-2039280	Adds if take order token on Solana is SPL and calldata exists
	tx fee			-5000
	priority fee

Send unlock

For availability to claim order in destination chain. Transaction example. This transaction contains the following expenses and returns:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
PrepareSend	transfer	sendFrom			= externalCallStorage + externalCallMeta + debridge fix fee (transferred to debridge feeBeneficiary)
	transfer	sendFromWallet			= execution fee
SendUnlock / SendBatchUnlock	rent	nonceStorage	16	-1002240	Is added when debridge nonce account doesn't exist
	rent	externalCallStorage	76	-1419840	If batch unlock it would be 108 + (32 * n), where n - amount of orders in batch
	rent	externalCallMeta	28	-1085760
	protocol fee			-30000000	Transfers to feeBeneficiary (prod value, hanoi value is 100000)
	execution fee			-57823	Depends from give chain, transfers to stakingWallet
	tx fee			-5000
	priority fee

Cancel

Calls instead of fulfill if you want to cancel an order. Transaction example. This transaction contains the following expenses:

Instruction	Spend type	Account name	Bytes (for alloc)	Lamports	Comment
CancelOrder	rent	takeOrderState	106	-1628640
PrepareSend	transfer	sendFrom			= externalCallStorage + externalCallMeta + debridge fix fee (transferred to debridge feeBeneficiary)
	transfer	sendFromWallet			= execution fee
SendUnlock	rent	nonceStorage	16	-1002240	Is added when debridge nonce account doesn't exist
	rent	externalCallStorage	76	-1419840
	rent	externalCallMeta	28	-1085760
	protocol fee			-30000000	Transfers to feeBeneficiary (prod value, hanoi value is 100000)
	execution fee			-364728	Depends from give chain, transfers to stakingWallet
	tx fee			-5000
	priority fee