@debridge-finance/dln-client NPM

`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	Lamports
ExecuteExternalCall	rent return	externalCallStorage	+13906080
	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

deBridge DLN sdk solana ethereum

@coral-xyz/anchor @debridge-finance/debridge-external-call @debridge-finance/solana-contracts-client @debridge-finance/solana-transaction-parser bignumber.js buffer js-sha3 node-cache viem web3 web3-utils

@infinitebrahmanuniverse/nolb-_deb @everything-registry/sub-chunk-229 @debridge-finance/dln-taker @zalastax/nolb-_deb

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

12 months ago

12 months ago

1 year ago

12 months ago

12 months ago

1 year ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

12 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

12 months ago

1 year ago

1 year ago

12 months ago

12 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

6.5.2-calldata-beta.1

2 years ago

6.1.0

2 years ago

6.5.2-calldata-beta.2

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

6.5.3-optimized-deps-alpha

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3.2.0-dev--estimation-preswap-checks

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3.2.0-dev--fix-add-fulfill-preswap-check.1

2 years ago

3.2.0-dev--fix-add-fulfill-preswap-check.0

2 years ago

3.0.0-dev--custom-web3-fulfill-gas.2

2 years ago

3.0.0-dev--custom-web3-fulfill-gas.1

2 years ago

3.0.0-dev--custom-web3-fulfill-gas

2 years ago

2.1.0

2 years ago

2.1.0-dev--expose-bucket-selector.0

2 years ago

2.1.0-dev--expose-bucket-selector.1

2 years ago

3 years ago

3 years ago

3 years ago

2 years ago

2.0.0-dev--costs-and-fees-calculation-revised.5

3 years ago

2.0.0-dev--costs-and-fees-calculation-revised.4

3 years ago

2.0.0-dev--costs-and-fees-calculation-revised.3

3 years ago

1.1.2-beta

3 years ago

2.0.0-dev--costs-and-fees-calculation-revised.2

3 years ago

2.0.0-dev--costs-and-fees-calculation-revised.1

3 years ago

2.0.1

2 years ago

2.0.0-dev--costs-and-fees-calculation-revised.0

3 years ago

1.1.0

3 years ago

0.1.4

3 years ago

0.1.3

3 years ago

dln-client by deBridge

A note on calculating execution fees and take cost

DLN order creation and expenses

Solana to EVM

Order creation

Claim

Execution calldata

EVM to Solana

Fulfill

Send unlock

Cancel

`dln-client` by deBridge