Plasma Docs - Build on Plasma

Connect Bridge Kit to move native USDC from CCTP-supported chains to Plasma, or from Plasma to another supported chain. Circle’s Cross-Chain Transfer Protocol (CCTP) enables native USDC transfers across blockchains through a secure burn-and-mint mechanism, without wrapped assets or liquidity pools. With Bridge Kit, you can integrate CCTP-powered transfers into Plasma applications with a lightweight SDK that abstracts contract interactions, attestations, and the full transfer flow into a few lines of code.

Supported Networks

Bridge Kit supports bridging between Plasma and other CCTP v2 chains.

Prerequisites

Before you begin, you must have:

Node.js 20+
A funded wallet with:
- Native USDC on the source chain (use the Circle Faucet for testnet)
- Gas on the source chain (for example, ETH on Ethereum Sepolia)
- XPL on Plasma for destination gas when your wallet signs the mint step (get testnet XPL)
Plasma added to your wallet. See Browser Wallet Setup.

Get Started

Install Bridge Kit

Install Bridge Kit and the Viem adapter for EVM chains, including Plasma:

npm install @circle-fin/bridge-kit @circle-fin/adapter-viem-v2 viem

yarn add @circle-fin/bridge-kit @circle-fin/adapter-viem-v2 viem

pnpm add @circle-fin/bridge-kit @circle-fin/adapter-viem-v2 viem

Create an adapter

Create one Viem adapter from a private key. The same adapter works across EVM chains, including Plasma:

import { BridgeKit } from "@circle-fin/bridge-kit";
import { createViemAdapterFromPrivateKey } from "@circle-fin/adapter-viem-v2";

const kit = new BridgeKit();

const adapter = createViemAdapterFromPrivateKey({
  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
});

For browser wallets such as MetaMask, Rabby, or Trust Wallet, use createViemAdapterFromProvider with your EIP-1193 provider instead of a private key. See the Bridge Kit documentation.

Bridging to or from Solana? Install @circle-fin/adapter-solana-kit and create a Solana adapter for that side of the transfer. Keep the Viem adapter for Plasma and other EVM chains. Pass both adapters into kit.bridge(), for example from: { adapter: solanaAdapter, chain: "Solana" } and to: { adapter, chain: "Plasma" }.

Bridge USDC to Plasma

Estimate fees, then bridge. This example moves 1 USDC from Ethereum Sepolia to Plasma Testnet:

// Optional: preview gas and protocol fees
const estimate = await kit.estimate({
  from: { adapter, chain: "Ethereum_Sepolia" },
  to: { adapter, chain: "Plasma_Testnet" },
  amount: "1.00",
});
console.dir(estimate, { depth: null });

// Transfer 1.00 USDC to Plasma Testnet
const result = await kit.bridge({
  from: { adapter, chain: "Ethereum_Sepolia" },
  to: { adapter, chain: "Plasma_Testnet" },
  amount: "1.00",
});

console.dir(result, { depth: null });

For mainnet, swap the chain identifiers:

const result = await kit.bridge({
  from: { adapter, chain: "Ethereum" },
  to: { adapter, chain: "Plasma" },
  amount: "10.00",
});

Monitor the transfer

Subscribe to lifecycle events to track approval, burn, attestation, and mint:

kit.on("*", (event) => {
  console.log(`[${event.method}]`, event.values);
});

After kit.bridge() resolves, inspect result.steps for transaction hashes and explorer URLs for each completed step.

Verify on Plasma

Open the mint step’s explorerUrl, or search the destination transaction hash on Plasma Explorer or Plasma Testnet Explorer.
Confirm native USDC arrived at your wallet on Plasma.
Confirm result.state is success.

Bridge from Plasma

The same kit call works in reverse. Burn USDC on Plasma and mint it on another CCTP chain:

const result = await kit.bridge({
  from: { adapter, chain: "Plasma" },
  to: { adapter, chain: "Base" },
  amount: "10.00",
});

Troubleshooting

Route Not Supported

Confirm both chains are available in Bridge Kit and that you are using the correct chain identifiers (Plasma, Plasma_Testnet). Check supported chains and domains.

Insufficient Balance or Gas

The source chain needs enough native USDC for the transfer amount, plus any Fast Transfer fee.
The source chain needs native gas, such as ETH, for the approval and burn transactions.
The destination Plasma wallet needs XPL when your adapter signs the mint transaction.

Transaction Stuck or Failed

Confirm RPC connectivity for both chains. Prefer a private Plasma RPC from an RPC provider in production.
Inspect result.steps to see which stage failed. Resume actionable failures with kit.retry(result, { from: adapter, to: adapter }).
Check network status on the Plasma status page.

Development

Asset Management

Network Configuration

Smart Contracts

Testing and Resources

Bridge USDC with Bridge Kit

Supported Networks

Prerequisites

Get Started

Bridge from Plasma

Troubleshooting

Route Not Supported

Insufficient Balance or Gas

Transaction Stuck or Failed

​Supported Networks

​Prerequisites

​Get Started

​Bridge from Plasma

​Troubleshooting

​Route Not Supported

​Insufficient Balance or Gas

​Transaction Stuck or Failed

Supported Networks

Prerequisites

Get Started

Bridge from Plasma

Troubleshooting

Route Not Supported

Insufficient Balance or Gas

Transaction Stuck or Failed