cross-chain

Routes Stellar cross-chain tasks to CCTP, Axelar GMP/ITS, or NEAR Intents integration guidance.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/stellar-zk/stellar-zk --skill cross-chain-stellar-zk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cross-chain
Source: https://github.com/stellar-zk/stellar-zk/tree/main/.claude/skills/cross-chain
Command: npx skills add https://github.com/stellar-zk/stellar-zk --skill cross-chain-stellar-zk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and correctly implementing a cross-chain rail for Stellar is error-prone: wrong rail selection wastes engineering effort, and mistakes like misencoded CCTP hook data or missing trustlines can permanently destroy funds. This Skill routes each cross-chain task to the right protocol and documents the exact contract calls, encodings, and pitfalls. ## Core Features & Use Cases - Rail selection routing: A decision table maps tasks to Circle CCTP V2 (native USDC burn-and-mint, Stellar domain 27), Axelar GMP (contract-to-contract messaging), Axelar ITS (multichain tokens), or NEAR Intents (intent-based swaps into XLM/USDC). - CCTP V2 deep dive: Verified mainnet/testnet contract addresses, the mandatory CctpForwarder pattern for Stellar recipients, hook-data byte layout with a TypeScript builder, 7-vs-6 decimal handling, and Iris attestation polling. - Axelar GMP and ITS reference: Compile-verified Soroban signatures for pay_gas, call_contract, the AxelarExecutable derive pattern, interchain token deployment, canonical token registration, and flow limits. - Use Case: A user asks to bridge USDC from Base to a Stellar wallet. The Skill routes to cctp.md, which specifies depositForBurnWithHook with the CctpForwarder as mintRecipient, the recipient strkey encoded in hook data, and mint_and_forward on Stellar — avoiding the permanent fund-loss mistake of sending directly to a G… account. ## Quick Start Ask how to bridge USDC from Ethereum to a Stellar account and follow the routed guidance for encoding the forwarder hook data and polling the Iris attestation API.

Frequently Asked Questions about cross-chain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bridge USDC from Ethereum or Base to Stellar?▼

Use Circle CCTP V2: call depositForBurnWithHook on the source chain with Stellar domain 27, set both mintRecipient and destinationCaller to the CctpForwarder contract, and encode the recipient strkey in the hook data. Then poll Circle's Iris API for the attestation and call mint_and_forward on Stellar.

CCTP vs Axelar vs NEAR Intents for Stellar cross-chain transfers?▼

Use CCTP when moving native USDC between CCTP-supported chains, since it burns and mints Circle-issued USDC with no wrapping. Use Axelar GMP when a Stellar contract must call contracts on other chains, Axelar ITS for multichain tokens, and NEAR Intents for swap-any-asset UX without bridge integration.

Why did my bridged USDC never arrive in my Stellar account?▼

CCTP always treats mintRecipient as a contract, so sending directly to a G… account mints into an uncontrollable address and funds are permanently stuck. You must route through the CctpForwarder with the recipient strkey in the hook data, and the recipient needs a USDC trustline beforehand.

How do I send a message from a Soroban contract to another chain?▼

Use Axelar GMP: first call pay_gas on the Gas Service with a token struct, then call_contract on the Gateway with the destination chain name, destination address string, and payload bytes. On the receiving side, use the AxelarExecutable derive macro rather than implementing the executable interface manually.

Does Stellar USDC use the same decimals as other chains in CCTP?▼

No. Stellar represents USDC with 7 decimals while every other CCTP chain uses 6, and CCTP message amounts are always 6-decimal. Outbound Stellar burns truncate the seventh digit; inbound mints scale the message amount by 10.

Can I test NEAR Intents swaps on a Stellar testnet?▼

No. NEAR Intents are filled by real market makers with real liquidity, so there is no testnet. Rehearse with dry quotes using the 1Click API's dry parameter, then execute a dust-sized real swap before committing larger amounts.