Gathering detailed insights and metrics for @debridge-finance/solana-contracts-client
Installations
npm install @debridge-finance/solana-contracts-clientDeveloper Guide
BETA
Typescript
Yes
Module System
CommonJS, ESM, UMD
Node Version
20.17.0
NPM Version
10.8.2
Score
52.8
Supply Chain
75.2
Quality
82.7
Maintenance
50
Vulnerability
76.1
License
Releases
Unable to fetch releases
Contributors
4
Download Statistics
Total Downloads
59,502
Last Day
91
Last Week
499
Last Month
2,955
Last Year
39,028
Bundle Size
588.24 kB
Minified
161.56 kB
Minified + Gzipped
Maintainers
4
Package Meta Information
Latest Version
4.1.4
Package Id
@debridge-finance/solana-contracts-client@4.1.4
Unpacked Size
1.86 MB
Size
255.56 kB
File Count
191
NPM Version
10.8.2
Node Version
20.17.0
Publised On
02 Dec 2024
Total Downloads
Cumulative downloads
Total Downloads
59,502
Last day
-49.2%
91
Compared to previous day
Last week
-53.4%
499
Compared to previous week
Last month
7.8%
2,955
Compared to previous month
Last year
103.2%
39,028
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
11
Peer Dependencies
4
Dev Dependencies
34
@rollup/plugin-commonjs@rollup/plugin-json@rollup/plugin-node-resolve@rollup/plugin-replace@rollup/plugin-typescript@solana/spl-token@types/bn.js@types/chai@types/mocha@types/node@types/secp256k1@typescript-eslint/eslint-plugin@typescript-eslint/parserassertaxiosbn.jschaidotenveslinteslint-config-airbnb-baseeslint-config-airbnb-typescripteslint-config-prettiereslint-plugin-importeslint-plugin-prettierjs-sha3mochaprettierrimrafrolluprollup-plugin-terserts-command-line-argsts-nodetypedoctypedoc-plugin-markdown
Versions
Client init
Since js doesn't support async constructors we have to initialize client object with const client = new DeBridgeSolanaClient() and then wait until it initializes (await client.init()) - loads program state, etc...
After initialization we can request data from blockchain and build transactions
How to wrap Sol->WSol (SPL-Sol)
We can't send native SOL tokens, we need to wrap them first into SPL-token form (SystemProgram.createAccount + SystemProgram.transfer native sol to created account + TokenProgram.InitializeAccount to convert system account into token account (SPL-wallet)). If we don't want to create new wallet we can call SystemProgram.transfer and then TokenProgram.SyncNative to convert transferred Sols into SPL-Sol
How to send token from Solana to other blockchain?
- Check if user's associated wallet exists and user have ehough tokens. We can get all user's wallets with
getAllWalletsWithBalances - Check if chain is supported - we can't send from Solana to unsupported chains, hence
chainSupportInfomust exist and be inSupportedstate, seegetChainSupportInfoSafefor details - Check if bridge exists (SPL-tokens are sent via Send bridge, deAssets are sent via Mint bridge which 100% exists) and in Working state - if bridge doesn't exist we can't send tokens and we need to init bridge first (see bridge initialization->send). We can check if bridge exists with getBridgeByDeBridgeId
- [Optional] If we want to pay fee with asset we're sending, we need to set
useAssetFeeflag to true and check if bridgeFeeInfo exists usingisBridgeFeeInfoInitialized. If bridgeFeeInfo->assetChainFee not exists we can't pay fee with assets and we also can't init bridgeFeeInfo. - [Optional] If we want to pass some additional data (external call data) we have two options - set SEND_HASHED flag and pass external call data off-chain (saves gas but automatic execution is unavailable) or save external call data into special Solana account (ExternalCallStorage) associated with send transaction
- ExtCallShortcut flow - we need to pass external call shortcut (
keccak256(ext call data)) and flags with 4th bit (8) set to send->submissionParams - ExtCallStorage flow - see externall call preparation section
- ExtCallShortcut flow - we need to pass external call shortcut (
- Send! If we have a discount we want to pass it into
sendinstruction, else we need to pass speical no_discount account (butbuildSendInstructioncalculates all the accounts under the hood). We also need to specify which wallet we want to use (user may have multiple wallets associated with same token mint), execution fee is a reward for automatic claim in target chain
How to claim token from other blockchain to Solana
- Check if chain is supported - we can't claim from unsupported chains, hence
chainSupportInfomust exist and be inSupportedstate, seegetChainSupportInfoSafefor details - Check if bridge exists -
getBridgeByDeBridgeId(deAssets are claimed via Send bridge, assets are claimed via Mint) and in Working state - if bridge doesn't exist we can't send tokens and we need to init bridge first (see bridge initialization->mint). - Check if submission wasn't already claimed with
isSubmissionUsed - Store confirmations from validators with
storeConfirmationsinstruction (one transaction can store up to 6 signatures) which can be built withbuildStoreSignaturesTransaction, this transactions can be signed and sent in a batch mode. - [Optional] If we have external call data we need to check if SEND_HASHED_FLAG is set. If flag is not set we need to fill ExternalCallStorage
- ExtCallStorage flow - see externall call preparation section
- All checks from steps 1,2 and 3 can be performed in automatic mode with function
checkClaimParams- check if submission is not already claimed, check bridge balance, check chainSupportInfo and Bridge. - Claim! just call
claiminstruction built withbuildClaimTransactionafter all signatures were saved - this can be checked withisTransactionConfirmedorgetConfirmationsCount - [Optional] if external call exists, we need to execute it, we could execute them by calling
buildOptimalExecuteExternalCallTransaction. This function tries to build tx with execution of as much as possible external instructions. Need to be called until external call is executed or fails to execute.
External call data preparation
Since solana's transaction size limit is 1232 bytes we can't store all external call data in single transaction, hence we need to split the data in chunks and send bunch of chunks in different transactions.
We need to call initExternalCallStorage instruction (storageKey = external call shortcut - claim/extCallShortcut - send, external call length = external call data length, source chain id = source chain - claim/solana id - send) to allocate memory and fill first chunk. If external call data is larger than ~800 bytes, we need to initialize externall call storage and fill it with data calling extendExternalCallStorage instruction buildExtendExternalCallStorageInstruction.
Function prepareExtCallTransactions splits data into chunks of optimal size and returns array of transactions to execute. First tx is initExternalCallStorage, rest (optional) are extendExternalCallStorage. initExternalCallStorage allocates required memory space in blockchain and fills it with initial data chunk. Since we can't write data to not-yet-allocated memory we have to wait until first transaction is finalized and extCallStorage is allocated. After that we can send rest transactions in a batch mode and wait until Solana processes them. We can check if storage was filled correctly using isExtCallStorageCorrect
Bridge initialization
- Send bridge - to init send bridge we need to call
initializeSendBridgeinstruction for SPL-token mint that we want to init -buildInitializeSendBridgeTransaction. - Mint bridge - to init mint bridge we need to
storeConfirmationsfor deploy info, wait until confirmations are saved and then callinitializeMintBridgeinstruction -buildInitializeMintBridgeTransaction
Entities
- State - unique, contains oracles, required oracles, min confirmations, if protocol is active and other system information.
- Bridge (general info) - contains bridge state (working/paused), collected fee and other system information.
- Send bridge - assocated with token, contains amount of locked tokens, native SPL-token address and general bridge info
- Mint bridge - associated with token in outter chain and outer chain id, contains amount of minted tokens, source chain id, source token address and general bridge info
- ChainSupportInfo - associated with chain, contains State (supported/unsupported) of target chain and fixedFee/transferFee values (if values are None globalFixedFee/globalTransferFee will be used)
- BridgeFeeInfo - associated with bridge, contains assetChainFee option (None or value, if None asset chain fee is unsupported)
Claim flow (with ext call) with affected accounts (Assuming that submission wasn't claimed, bridge/state/chainSupportInfo exists)
| Action | Initialized accounts | Updated Accounts | Closed Accounts | Comments |
|---|---|---|---|---|
storeConfirmations | [confirmationStorage] | confirmationStorage | store signatures into confirmationStorage, account is created if not exists yet | |
initExternalCallStorage | externalCallStorage, externalCallMeta | allocate externall call storage, set externalCallMeta = accumulation | ||
updateExternalCallStorage | externalCallStorage, externalCallMeta | fill external call storage with data, set externalCallMeta = accumulation | ||
claim | submission, [stakingWallet], [payerWallet], [claimToWallet] | bridge, stakingWallet, payerWallet, claimToWallet | confirmationStorage | create submission account, close confirmation storage, set externalCallMeta state = execution, update bridge locked/minted amount, move funds to/from wallets |
executeExternalCall | externalCallMeta | externalCallStorage | set externalCallMeta = executed, close external call storage |
Claim flow (without ext call) with affected accounts (Assuming that submission wasn't claimed, bridge/state/chainSupportInfo exists)
| Action | Initialized accounts | Updated Accounts | Closed Accounts | Comments |
|---|---|---|---|---|
storeConfirmations | [confirmationStorage] | confirmationStorage | store signatures into confirmationStorage, account is created if not exists yet | |
claim | submission, [stakingWallet], [payerWallet], [claimToWallet] | bridge, stakingWallet, payerWallet, claimToWallet | confirmationStorage | create submission account, close confirmation storage, update bridge locked/minted amount, move funds to/from wallets |
Examples
Claim flow
Send flow
No vulnerabilities found.
No security vulnerabilities found.