ccip-sdk
Advanced tools
The simplest Python SDK for Chainlink CCIP that turns complex cross-chain operations into 15 lines of code.
A simple Python SDK for Chainlink CCIP (Cross-Chain Interoperability Protocol) that enables seamless cross-chain token transfers and messaging.
pip install ccip-sdk
virtual environmentpython -m venv env
source env/bin/activate
pip install ccip-sdk python-dotenv
Create a .env file in your project root:
PRIVATE_KEY=your_private_key_here
Note: Make sure your account has ETH, CCIP-BnM(or any other token) to pay for gas and transfer tokens
from ccip_sdk import CCIPClient
from dotenv import load_dotenv
import os
load_dotenv()
client = CCIPClient(private_key=os.environ.get("PRIVATE_KEY"))
# Step 1: Deploy sender contract on Ethereum Sepolia
contract = client.deploy_sender_contract("ethereum_sepolia")
print(f"Deployed contract address: {contract}\n")
# Step 2: Fund sender contract with tokens
txn_hash = client.send_tokens_to_sender_contract("ethereum_sepolia", "CCIP-BnM", 0.1)
print(f"Token sent via this transaction hash : {txn_hash}\n")
# Step 3: Fund sender contract with ETH (for gas fees)
txn_hash = client.send_eth_to_contract("ethereum_sepolia", 0.05)
print(f"ETH sent via this transaction hash : {txn_hash}\n")
# Step 4: Allow destination chain for cross-chain messaging
txn_hash = client.allow_destination_chain(current_chain="ethereum_sepolia", destination_chain="arbitrum_sepolia")
print(f"Allowed destination chain arbitrum_sepolia done with txnHash : {txn_hash}\n")
# Step 5: Deploy receiver contract on Arbitrum Sepolia
contract = client.deploy_receiver_contract("arbitrum_sepolia")
print(f"Deployed contract address: {contract}\n")
# Step 6: Allow source chain on receiver
txn_hash = client.allow_source_chain(current_chain="arbitrum_sepolia", sender_chain="ethereum_sepolia")
print(f"Allowed sender chain ethereum_sepolia done with txnHash : {txn_hash}\n")
# Step 7: Allow sender contract to send messages to receiver
txn_hash = client.allow_sender_on_receiver(sender_chain="ethereum_sepolia", receiver_chain="arbitrum_sepolia")
print(f"Allowed the sender contract to send messages on reciever chain with txnHash : {txn_hash}\n")
# Step 8: Execute cross-chain transfer
txn_url = client.transfer(sender_chain="ethereum_sepolia", receiver_chain="arbitrum_sepolia", text="Hi dj boi", amount=0.069, token="CCIP-BnM")
print(f"You can watch the CCIP Transfer here : {txn_url}\n")
deploy_sender_contract(): Deploys a contract that can send cross-chain messagesdeploy_receiver_contract(): Deploys a contract that can receive cross-chain messagessend_tokens_to_sender_contract(): Funds the sender with tokens for transfersend_eth_to_contract(): Funds the sender with ETH for transaction feesallow_destination_chain(): Authorizes the sender to communicate with a specific destination chainallow_source_chain(): Authorizes the receiver to accept messages from a specific source chainallow_sender_on_receiver(): Links sender and receiver contracts for communicationtransfer(): Executes the cross-chain token transfer with optional messagewithdraw_token_to_wallet(): Withdraws the given token to beneficiary| Chain Name | Network | Purpose |
|---|---|---|
ethereum_sepolia | Ethereum Sepolia Testnet | Primary testing network |
arbitrum_sepolia | Arbitrum Sepolia Testnet | L2 scaling solution |
base_sepolia | Base Sepolia Testnet | Coinbase L2 network |
avalanche_fuji | Avalanche Fuji Testnet | High-performance blockchain |
| Token | Description | Use Case |
|---|---|---|
LINK | Chainlink Token | Network fees and staking |
CCIP-BnM | Burn and Mint Token | Cross-chain transfers |
USDC | USD Coin | Stable value transfers |
CCIP-LnM | Lock and Mint Token | Alternative transfer mechanism |
⚠️ Never commit your private key to version control. Always use environment variables or secure key management solutions.
We welcome contributions! Here's how you can help:
git checkout -b feature-namegit clone https://github.com/dhananjaypai08/ccip_sdk.git
cd ccip_sdk
pip install -e .
pip install -r requirements-dev.txt
The CCIP SDK includes a Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop to perform cross-chain transfers using natural language.
pip install mcp ccip-sdk python-dotenv
# Save the MCP server file as ccip_mcp_server.py
curl -o ccip_mcp_server.py https://raw.githubusercontent.com/dhananjaypai08/CCIP-SDK/blob/master/mcp-server.py
# Create .env file with your private key
echo "PRIVATE_KEY=your_private_key_here" > .env
Add the MCP server to your Claude Desktop configuration:
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"ccip": {
"command": "python",
"args": ["/path/to/your/ccip_mcp_server.py"],
"env": {
"PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Close and reopen Claude Desktop to load the MCP server.
Now you can chat with Claude using natural language:
👤 You: "Send 0.1 CCIP-BnM from Ethereum to Arbitrum with message 'Hello Cross-Chain!'"
🤖 Claude: I'll help you execute a cross-chain transfer from Ethereum to Arbitrum. Let me set this up...
✅ Transfer setup complete!
🔄 Executing all 8 steps...
...
🎉 Transfer complete! Track here: https://ccip.chain.link/tx/...
# Create a dedicated .env file for MCP
cat > ccip_mcp.env << EOF
PRIVATE_KEY=your_private_key_here
EOF
{
"mcpServers": {
"ccip": {
"command": "python",
"args": ["/path/to/ccip_mcp_server.py"],
"env": {
"PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Send 0.05 CCIP-BnM from Ethereum to Base
Execute a cross-chain transfer of 0.1 USDC from Arbitrum to Avalanche with message "Payment for services" and fund the contract with 0.2 tokens and 0.08 ETH
What's the status of my current CCIP transfer?
What chain matches "arb"?
MCP Server Not Loading:
claude_desktop_config.jsonTransfer Failures:
Permission Issues:
chmod +x ccip_mcp_server.pyAdd debug logging to your MCP server:
{
"mcpServers": {
"ccip": {
"command": "python",
"args": ["/path/to/mcp-server.py", "--debug"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"LOG_LEVEL": "DEBUG"
}
}
}
}
Besides Claude Desktop, you can use the MCP server with:
MIT License - see LICENSE for details.
FAQs
The simplest Python SDK for Chainlink CCIP that turns complex cross-chain operations into 15 lines of code.
The pypi package ccip-sdk receives a total of 16 weekly downloads. As such, ccip-sdk popularity was classified as not popular.
We found that ccip-sdk demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
/Research
Mini Shai-Hulud expands into the Go ecosystem after hitting LeoPlatform npm packages and targeting GitHub Actions workflows.
Security News
The Fable shutdown shows how quickly model access can become a business continuity risk for AI-dependent engineering teams.
Security News
AI agents are pulling packages into environments no scanner is watching, creating exposure before security teams can see it.