@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

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months 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

11 months ago

11 months ago

11 months ago

1 year 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

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

1 year ago

1 year ago

12 months ago

12 months ago

1 year ago

11 months ago

11 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 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

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

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

2 years ago

2 years ago

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

2 years ago

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

2 years ago

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

2 years ago

1.1.2-beta

3 years ago

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

2 years ago

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

2 years ago

2.0.1

2 years ago

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

2 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