USDC + CCTPチュートリアル

このチュートリアルでは、以下を行います:

CCTPのburn-attest-mintプロトコルの仕組みを学ぶ
クロスチェーン送金を開始するために、ソースチェーン上でUSDCをburnする
デスティネーションチェーン上でのmintを認可するCircleのattestationを取得する
デスティネーションチェーン上でUSDCをmintして送金を完了する

Injective上のCCTPとは？ Cross-Chain Transfer Protocol (CCTP) を使うと、Injectiveと他のネットワーク間でUSDCを1:1で移転できます。 USDCはInjective上でネイティブステーブルコインとして利用可能です。これは CCTP を通じて提供されます。 CCTPはサポート対象ネットワーク間でUSDCを1:1で移転します。プロセスは以下の通りです:

ソースチェーン上でUSDCをburnする。
attestation を受け取る。
デスティネーションチェーン上で同等量のUSDCをmintする。

wrappingやbridgingは不要です。

前提条件

このチュートリアルを始める前に、以下がインストールされていることを確認してください:

ツール	最低バージョン	確認	インストール
Node.js	22+	`node --version`	nodejs.org
npm	11+	`npm --version`	Node.jsに同梱

加えて、以下が必要です:

ブラウザにインストールされた MetaMask
- Injective Testnetに接続済み
- Sepoliaにも接続済み
Injective Faucet または Google Cloud Faucet から取得したテストネットINJ
Sepolia faucet から取得したテストネットSepolia ETH
Circle Faucet から取得したテストネットUSDC

はじめに

このチュートリアルに付属するコードは USDC CCTP demo リポジトリで利用可能です。リポジトリをクローンし、依存関係をインストールします:

git clone https://github.com/injective-dev/usdc-cctp-injective-demo
cd usdc-cctp-injective-demo
npm install

開発サーバーを起動します:

npm run dev

ブラウザで http://localhost:5173 を開いてdAppを表示します。

CCTPはどのように動作するか？

CCTPは、ソースチェーン上でUSDCをburnし、CircleのAPIから署名付きattestationを取得し、デスティネーションチェーン上で同等量をmintすることで、チェーン間でUSDCを移転します。 CCTPは以下の3ステップでUSDCをチェーン間で移転します:

Burn: ソースチェーンの TokenMessengerV2 コントラクトが指定されたUSDC量をburnします。その後、送金詳細を含む MessageSent イベントを発行します。
Attest: CircleのIris APIがオンチェーンイベントを監視し、メッセージに署名します。 burnの確定後、attestationを生成します。
Mint: デスティネーションチェーンの MessageTransmitterV2 コントラクトがattestationを検証し、同等量のUSDCをrecipientアドレスへmintします。

このチュートリアルに付属するデモアプリケーションは、ステップ2と3を自動化し、attestationの準備が整うまでCircleのAPIをポーリングし、その後mintアクションをアンロックします。

dAppは各ステップを以下の呼び出しで実装しています:

// Step 1 — src/components/CCTPTransfer.tsx
writeBurn({ functionName: 'depositForBurn', args: [amount, destDomain, mintRecipient, burnToken, ...] })

// Step 2 — src/hooks/useAttestation.ts
const { messages } = await fetch(`${CIRCLE_ATTESTATION_API}/${sourceDomain}?transactionHash=${txHash}`).then(r => r.json())

// Step 3 — src/components/CCTPTransfer.tsx
writeMint({ functionName: 'receiveMessage', args: [messages[0].message, messages[0].attestation] })

Injective上で使用されるコントラクトアドレスについては、Injective上のUSDC を参照してください。

ソースチェーン上でUSDCをburnする

dAppが http://localhost:5173 で開かれた状態で:

Connect Wallet を選択し、MetaMaskの接続プロンプトを承認します。
ソースチェーン（例えば Ethereum Sepolia）とデスティネーションチェーン（Injective EVM Testnet）を選択し、移転するUSDC量を入力します。
Approve USDC を選択し、MetaMaskで承認トランザクションを確認します。
Burn USDC を選択し、burnトランザクションを確認します。

dAppはトランザクションハッシュを表示し、burnトランザクションがオンチェーンで確定すると自動的にattestationステップへ進みます。

Burn USDC を選択すると、dAppは TokenMessengerV2 コントラクトの depositForBurn を呼び出します:

// src/components/CCTPTransfer.tsx
writeBurn({
  address: messengerAddr,
  abi: tokenMessengerAbi,
  functionName: 'depositForBurn',
  args: [
    amountParsed,                                       // USDC amount (6 decimals)
    destDomain,                                         // 0 = Sepolia, 29 = Injective
    padHex(destAddress as `0x${string}`, { size: 32 }), // 32-byte-padded recipient
    usdcContract,                                       // USDC token address
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    maxFee,                                             // relay fee (fast mode on Sepolia)
    minFinalityThreshold,                               // 1 = Sepolia, 2000 = Injective
  ],
})

minFinalityThreshold の値はどのように選べばよいですか？

minFinalityThreshold の値は以下のように設定する必要があります:

値が1000以下の場合は「fast」メッセージとなり、
値が1000より大きい場合は「standard」メッセージとなります。

Sepolia上では、standardメッセージとfastメッセージの両方がサポートされており、 standardメッセージは約15〜19分、 fastメッセージは約20秒かかります。Injective上では、standardメッセージのみがサポートされており、 standardメッセージは約0.65秒かかります。 Injectiveの高速なブロックタイムと即時ファイナリティのおかげで、fastメッセージは不要なためサポートされていません。これに関する正式なリファレンスとして、Circleドキュメントの Block confirmation requirements and attestation timing for CCTP を参照してください。

Circle attestationとは？

Circle attestationは、ソースチェーン上でUSDCのburnが発生したことを証明する、CircleのIris APIからの暗号学的署名です。 attestationは、デスティネーションチェーン上での対応するmintを認可するために使用されます。 burnの後、CircleのIris APIは ソースチェーン 上の MessageSent イベントを監視します。必要な数のブロック確認が完了すると、Circleはメッセージに署名し、attestationを発行します。 attestationの所要時間はソースチェーンによって異なります:

Ethereum Sepolia (standardモード): 15〜20分
Injective EVM Testnet: 通常数分

Sepoliaからの送金は、待ち時間を大幅に短縮するfastモードをサポートしていますが、十分な maxFee の設定が必要です。手数料が低すぎる場合、送金はstandardモードへフォールバックします。

attestationを待つ

このdAppは自動的にIris APIをポーリングします。ページを離れる必要はありません。 attestationの準備が整うと、UIが通知します。

dAppはburnステップのトランザクションハッシュを使ってattestationを取得します:

// src/hooks/useAttestation.ts
const url = `${CIRCLE_ATTESTATION_API}/${sourceDomain}?transactionHash=${txHash}`
const { messages } = await fetch(url).then(r => r.json())

if (messages[0]?.status === 'complete') {
  setResult({ message: messages[0].message, attestation: messages[0].attestation })
} else {
  setResult({ status: 'pending_confirmations' }) // poll again in 15 s
}

デスティネーションチェーン上でUSDCをmintする

dAppに「Attestation received」が表示されたら:

プロンプトが表示されたら、MetaMaskを デスティネーションチェーン に切り替えます。
Mint USDC を選択し、MetaMaskでトランザクションを確認します。
dApp上に表示される残高、または Injective Testnet Blockscout もしくは Sepolia Etherscan でアドレスを確認することで、デスティネーションチェーン上のUSDC残高を確認します。

Mint USDC を選択すると、dAppは MessageTransmitterV2 コントラクトの receiveMessage を呼び出します:

// src/components/CCTPTransfer.tsx
writeMint({
  address: transmitterAddr,
  abi: messageTransmitterAbi,
  functionName: 'receiveMessage',
  args: [attMessage, attestation], // message bytes + Circle's ECDSA signature
})

次のステップ

Injective上でCCTPを使った初めてのクロスチェーンUSDC送金、おつかれさまでした！このチュートリアルで学んだ内容は以下の通りです:

CCTPのburn-attest-mintプロトコルが、wrappingやbridgingを 行わずに USDCを1:1でチェーン間で移転する方法
クロスチェーン送金を開始するために、ソースチェーン上でUSDCをburnする方法
Circleのattestationを取得し、それを使ってデスティネーションチェーン上でUSDCをmintする方法

USDCをチェーン間で移転できるようになったところで、次は以下を検討してみてください:

Injective上のUSDC: コントラクトアドレス、テストネットfaucet、よくある質問。
MultiVM Token Standard: bridgingなしで、Injective上のEVMとCosmosの両方でUSDCを使用します。

​前提条件

​はじめに

​CCTPはどのように動作するか？

​ソースチェーン上でUSDCをburnする

​Circle attestationとは？

​attestationを待つ

​デスティネーションチェーン上でUSDCをmintする

​次のステップ

前提条件

はじめに

CCTPはどのように動作するか？

ソースチェーン上でUSDCをburnする

Circle attestationとは？

attestationを待つ

デスティネーションチェーン上でUSDCをmintする

次のステップ