🛤️CCIP
CCIP
Chainlink CCIP provides a single simple interface through which dApps and web3 entrepreneurs can securely meet all their cross-chain needs. You can use CCIP to transfer data, tokens, or both data and tokens across chains.
Read more about Chainlink CCIP
Before you begin
Before you begin, you need to ensure that you have a sufficient LINK.
Instantiate Cryptum SDK first:
const sdk = new CryptumSdk({
environment: 'testnet',
apiKey: 'YOUR-API-KEY'
})
Transfer Tokens between EOAs
In this example, you will transfer CCIP-BnM tokens from your EOA on Arbitrum to an account on Avalanche Fuji. The destination account could be an EOA (Externally Owned Account) or a smart contract.
const getWallet = async () => await sdk.wallet.generateWallet({
protocol,
mnemonic: process.env.MNEMONIC
})
const wallet = await getWallet();
await sdk.chainlink.sendTokenCCIPEoa({
protocol: "ARBITRUM",
wallet,
to: "0x91438...6623", // destination wallet
amount: '1',
tokenAddress: 'CCIP-BnM',
destinationProtocol: "AVAXCCHAIN",
// feeTokenAddress: '0x' // 0x for native token or token address or null for LINK token
})
/* Response:
TransactionResponse {
hash: '0x082a35d8172700ec2c97538034d774feb44ec5d4e81b45116c4c368fc3bb79cc'
}
*/
Get Status By Message ID
const getStatusCCIP = async (messageId, destinationProtocol) => {
const data = await sdk.chainlink.getStatusCCIP({
protocol,
messageId,
destinationProtocol
})
return data
}
Get Status By Transaction Hash
const getStatusCCIPByHash = async(hash) => {
const data = await sdk.chainlink.getStatusCCIPByHash({
hash
})
return data
}
/* Response:
{
nodes: [
{
transactionHash: '0x24442dd3252b9d21f70f9bf336a9acf9f386250085ad2ac7b67284da3e1f4dc6',
destTransactionHash: '0x3aa9d998ddb97e099df597e068eab4f0fe336df05319605fc8bade13f8862091',
onrampAddress: '0x0477ca0a35ee05d3f9f424d88bc0977cecf339d4',
offrampAddress: '0x9e5e4324f8608d54a50a317832d456a392e4f8c2',
commitStoreAddress: '0x92a51ed3f041b39ebd1e464c1f7cb1e8f8a8c63f',
state: 2,
sourceChainId: '11155111',
sourceNetworkName: 'ethereum-testnet-sepolia',
sender: '0xb9f97a89a378aaa1a1e6811eb17807cc60411322',
receiver: '0x91438e6149891941c3da2e36b0aceb84f30f6623',
messageId: '0xfbc7cb335e0abf9abb86c81ee538419fe5fad5983c2a4eeecd36f60876cd27d8',
destChainId: '43113',
destNetworkName: 'avalanche-testnet-fuji',
blockTimestamp: '2024-07-18T05:22:00',
data: '',
strict: false,
nonce: 1,
gasLimit: '0',
sequenceNumber: 9353,
feeToken: '0x779877a7b0d9e8603169ddbd7836e478b4624789',
feeTokenAmount: '33890460193260785',
tokenAmounts: [Array]
}
]
}
*/
OnChain
Deploy Contract
Retrieve your wallet using the following command:
const wallet = await sdk.wallet.generateWallet({
protocol: "ETHEREUM",
mnemonic: process.env.MNEMONIC
})
For more information about wallets, see: Wallet
Now, deploy your contract on the desired source and destination networks. In our example, we will use the Ethereum Sepolia and Avalanche Fuji networks.
const { hash } = await sdk.chainlink.createCCIP({
protocol: "ETHEREUM",
wallet
})
/* Example Response:
TransactionResponse {
hash: '0x500f9948df4dacd92e71bde7b99934661fe5776f4a6289aba84a423c15a932a4'
}
*/
Get Contract Address By Hash
Use the getTransactionReceiptByHash function to obtain the newly generated contract address.
const { contractAddress } = await sdk.transaction.getTransactionReceiptByHash({
protocol: "ETHEREUM",
hash
})
console.log('contractAddress: ', contractAddress)
Add Founds
You need to add funds to the generated contracts. Add ETH, LINK, and CCIP-BnM to your wallet.
You can obtain faucets through the link: https://docs.chain.link/ccip/test-tokens
CCIP-BnM: https://docs.chain.link/ccip/test-tokens
Note: The CCIP-BnM token is what we will send across networks, so it can be added only to the source contract. The other tokens should be added to all contracts.
For the contract on the Ethereum network, add ETH and LINK; for the contract created on the Avalanche Fuji network, add AVAX and LINK; and so on for the other networks.
This is necessary to ensure we have sufficient funds for gas payments.
// native token
const { hash } = await sdk.token.transfer({
wallet,
protocol: 'ETHEREUM',
token: 'ETH',
destination: '0x31ec6686ee15...931b5e12cacb920e', // contractAddress
amount: '17.44',
})
// custom ERC20 token LINK
const { hash } = await sdk.token.transfer({
wallet,
protocol: 'ETHEREUM',
token: '0x779877A7B0D9E8603169DdbD7836e478b4624789', // Address LINK
destination: '0x31ec6686ee15...07A931b5e12cacb920e', // contractAddress
amount: '10',
})
// custom ERC20 token CCIP-BnM
const { hash } = await sdk.token.transfer({
wallet,
protocol: 'ETHEREUM',
token: '0xFd57b4ddBf88a4e07fF4e34C487b99af2Fe82a05', // Address CCIP-BnM
destination: '0x31ec6686ee15...07A931b5e12cacb920e', // contractAddress
amount: '1',
})
Get Last Received Message
Retrieving the last received message.
await sdk.chainlink.getLastReceivedMessageDetailsCCIP({
protocol: "ETHEREUM",
address: contractAddress
})
/*
Example Response:
{
messageId: '0xad4273f646ef81c993bebb35b2d7d4daf9c8871ed6fcb6bf446b6a79b661e2ba',
text: '',
tokenAddress: '0xD21341536c5cF5EB1bcb58f6723cE26e8D8E90e4',
tokenAmount: '100000000000000000'
}
*/
Get Last send Message
Retrieving the last sent message.
await sdk.chainlink.getLastSendMessageDetailsCCIP({
protocol,
address: contractAddress
})
/*
Example Response:
{
messageId: '0xc9b6cc4c272a5c728c1513188360fa27c528fbf4c6e1b5c0395361bf54a72c86',
text: '',
tokenAddress: '0xFd57b4ddBf88a4e07fF4e34C487b99af2Fe82a05',
tokenAmount: '100000000000000000'
}
*/
Get Received Messages Id
Retrieving the list of received message IDs.
await sdk.chainlink.getReceivedMessagesIdCCIP({
protocol: "ETHEREUM",
address: contractAddress
})
/*
Example Response:
[
'0xeb278fe6a4bc362....0a680e791b085d9bb',
'0x108621b1c2f....1f3ba2442f55c',
'0xc9b6cc4c27.....b5c0395361bf54a72c86',
'0xad4273f646ef81c993bebb35b2d7d4daf9c8871ed6fcb6bf446b6a79b661e2ba'
]
*/
Get Sended Messages Id
Retrieving the list of sent message IDs.
await sdk.chainlink.getSendMessagesIdCCIP({
protocol,
address: contractAddress
})
/*
Example Response:
[
'0xeb278fe6a4bc362....0a680e791b085d9bb',
'0x108621b1c2f....1f3ba2442f55c',
'0xc9b6cc4c27.....b5c0395361bf54a72c86',
'0xad4273f646ef81c993bebb35b2d7d4daf9c8871ed6fcb6bf446b6a79b661e2ba'
]
*/
Allow Listed Senders
To receive messages sent from another contract, we need to authorize the origin contract address on the destination contract.
In the allowlistedSendersCCIP
function, we check whether the specified origin contract is authorized to send messages to the destination contract.
await sdk.chainlink.allowlistedSendersCCIP({
protocol,
address: contractAddress,
senderAddress
})
// response true or false
Allow Sender
In the allowSenderCCIP
function, we can authorize or revoke authorization for the specified contract.
await sdk.chainlink.allowSenderCCIP({
protocol,
wallet,
address: contractAddress,
senderAddress,
allowed // true or false
})
Send Message
Using the sendMessageCCIP
function, you can send tokens, tokens with data, and just data across different networks.
Note: Follow all the previous steps carefully to ensure there are sufficient funds for gas payments on both the source and destination networks.
Token
Sending tokens across blockchains.
await sdk.chainlink.sendMessageCCIP({
protocol,
destinationProtocol,
wallet,
tokenAddress: '0xFd57b4ddBf88a4e07fF4e34C487b99af2Fe82a05', //
amount: '0.1',
payLink: true, // If true, we indicate that we want to pay the gas fee with LINK.
contractAddress: senderContractAddress, // Origin contract address.
to: receiveContractAddress // Destination contract address.
})
/* Example Response:
TransactionResponse {
hash: '0x500f9948df4dacd92e71bde7b99934661fe5776f4a6289aba84a423c15a932a4'
}
*/
Data
Sending data across blockchains.
await sdk.chainlink.sendMessageCCIP({
protocol,
destinationProtocol,
wallet,
text: "Cryptum Sdk",
payLink: true, // If true, we indicate that we want to pay the gas fee with LINK.
contractAddress: senderContractAddress, // Origin contract address.
to: receiveContractAddress // Destination contract address.
})
/* Example Response:
TransactionResponse {
hash: '0x500f9948df4dacd92e71bde7b99934661fe5776f4a6289aba84a423c15a932a4'
}
*/
Token with Data
Sending tokens with data across blockchains.
await sdk.chainlink.sendMessageCCIP({
protocol,
destinationProtocol,
wallet,
tokenAddress: '0xFd57b4ddBf88a4e07fF4e34C487b99af2Fe82a05',
amount: '0.1',
text: "Cryptum Sdk",
payLink: true, // If true, we indicate that we want to pay the gas fee with LINK.
contractAddress: senderContractAddress, // Origin contract address.
to: receiveContractAddress // Destination contract address.
})
/* Example Response:
TransactionResponse {
hash: '0x500f9948df4dacd92e71bde7b99934661fe5776f4a6289aba84a423c15a932a4'
}
*/
After sending, if everything goes well, you will receive a hash. With this hash, you can check the status of the operation using the sdk.chainlink.getStatusCCIPByHash
function or by visiting: https://ccip.chain.link.
Withdraw
To withdraw the tokens contained in your contract, use the withdrawCCIP
function.
await sdk.chainlink.withdrawCCIP({
protocol,
wallet,
contractAddress:address,
to: wallet.address,
tokenAddress
})
/* Example Response:
TransactionResponse {
hash: '0x500f9948df4dacd92e71bde7b99934661fe5776f4a6289aba84a423c15a932a4'
}
*/
Last updated