Migrate your CCT token pools from CCIP v1 to v2 (Burn & Mint) using Foundry

Guide Versions

This guide is available in multiple versions. Choose the one that matches your needs.

This migration guide helps you upgrade a deployed Burn & Mint Cross-Chain Token (CCT) setup from CCIP v1 (1.5.x / 1.6.x) to CCIP v2, while keeping your existing token addresses and minimizing disruption.

This guide uses Foundry scripts inside our docs-cct-foundry repository.

In this guide you will:

  1. Confirm prerequisites and record your existing CCIP v1 deployment details.
  2. Deploy new CCIP v2 Burn Mint token pools on each chain.
  3. Configure the v2 pools to accept messages from both the old v1 pools and the new v2 pools.
  4. Cut over CCIP routing by calling TokenAdminRegistry.setPool on each chain.
  5. Validate transfers end-to-end, then optionally clean up legacy configuration.

Before You Begin

1 Set up your development environment
  1. Install Node.js and npm:

    • Make sure you have Node.js v22.10.0 or above installed. If not, install Node.js v22.10.0 using their documentation.
    • npm is bundled with Node.js. If you can’t run npm, reinstall/update Node.js from the official installer.
  2. Install/Update Chainlink CCIP-CLI. You can also find the GitHub repository here.

Terminal
npm install -g @chainlink/ccip-cli

Verify the installation by running the following command:

Terminal
ccip-cli --version
  1. Install Foundry: If you haven't already, follow the instructions in the Foundry documentation to install Foundry.
    Verify the installation by running the following command:
Terminal
forge --version
  1. Clone the repository and navigate to the project directory:
CCIP 2.0 Foundry template

Clone the CCIP 2.0 Foundry template for a smoother CCT setup.

Terminal
git clone https://github.com/smartcontractkit/docs-cct-foundry.git
cd docs-cct-foundry
  1. Create an encrypted Foundry keystore, if you haven't already:
Terminal
cast wallet import your_keystore_name --interactive
  1. Create a .env file by copying the .env.example file, and fill in the required values:
Terminal
cp .env.example .env
.env
# Keystore name (created via `cast wallet import`)
KEYSTORE_NAME=your_keystore_name

# RPC URLs (lane used in this guide)
ETHEREUM_SEPOLIA_RPC_URL=your_eth_sepolia_rpc
ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL=your_arbitrum_sepolia_rpc

# Etherscan API key (required only if you pass --verify to deployment scripts)
ETHERSCAN_API_KEY=your_etherscan_api_key
Complete List of Supported Chains

View the complete list of supported chains in the HelperConfig.s.sol file.

  1. To make sure your terminal has access to these variables, run the following command:
Terminal
source .env
  1. Install dependencies and build the project:
Terminal
npm install && forge build
2 What this guide assumes
  • EVM-to-EVM only: this page is strictly for Ethereum Sepolia ↔ Arbitrum Sepolia. - Burn & Mint pools only: standard BurnMintTokenPool migrations (no custom pools). - You control the TokenAdminRegistry administrator role for the token on both chains. - You can grant the required mint/burn permissions to the new v2 pools on each chain. - You can execute pool-owner actions on both chains (for example, applyChainUpdates, removeRemotePool). - You are migrating an already-live CCIP v1 setup (1.5.x or 1.6.x), not doing a new registration.

Migration Guide


1 Step 1: Confirm the live CCIP v1 pool (and record v1 addresses)

This step answers two questions, on both chains:

  1. Which pool is currently live for your token? (read from TokenAdminRegistry.getTokenConfig)
  2. Is that pool a v1.5/v1.6 pool? (read typeAndVersion() from the pool)
GetTokenConfig.s.sol

View the token config query script on GitHub.

  1. Read the token config on Ethereum Sepolia:
Terminal
TOKEN=$ETHEREUM_SEPOLIA_TOKEN forge script \
  script/setup/GetTokenConfig.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
Token Config:
  administrator:        0xYourAdminAddress
  pendingAdministrator: 0x0000000000000000000000000000000000000000
  tokenPool:            0xOldSepoliaV1PoolAddress

Export the v1 pool address:

Terminal
export ETHEREUM_SEPOLIA_V1_POOL=0xOldSepoliaV1PoolAddress
  1. Repeat on Arbitrum Sepolia:
Terminal
TOKEN=$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_TOKEN forge script \
  script/setup/GetTokenConfig.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
Token Config:
  administrator:        0xYourAdminAddress
  pendingAdministrator: 0x0000000000000000000000000000000000000000
  tokenPool:            0xOldArbitrumV1PoolAddress

Export the v1 pool address:

Terminal
export ARBITRUM_SEPOLIA_V1_POOL=0xOldArbitrumV1PoolAddress
GetTypeAndVersion.s.sol

View the type/version query script on GitHub.

  1. Confirm the v1 pool version on Ethereum Sepolia:
Terminal
ADDRESS=$ETHEREUM_SEPOLIA_V1_POOL forge script \
  script/setup/GetTypeAndVersion.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
typeAndVersion: BurnMintTokenPool 1.6.1
  1. Confirm the v1 pool version on Arbitrum Sepolia:
Terminal
ADDRESS=$ARBITRUM_SEPOLIA_V1_POOL forge script \
  script/setup/GetTypeAndVersion.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
typeAndVersion: BurnMintTokenPool 1.6.1
2 Step 2: Record your v1 lane configuration (remote pools + rate limits)

Before deploying anything, snapshot your current v1 configuration so you can keep behavior consistent after migration.

GetSupportedChains.s.sol

View the supported-chains query script on GitHub.

  1. List configured remote chains on the Sepolia v1 pool:
Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V1_POOL forge script \
  script/setup/GetSupportedChains.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
Supported Remote Chains: 1

  [0] Arbitrum Sepolia (3478487238524512106)
       Remote Pools: 1
         [0] 0xOldArbitrumV1PoolAddress
  1. List configured remote chains on the Arbitrum v1 pool:
Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V1_POOL forge script \
  script/setup/GetSupportedChains.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
Supported Remote Chains: 1

  [0] Ethereum Sepolia (16015286601757825753)
       Remote Pools: 1
         [0] 0xOldSepoliaV1PoolAddress
GetCurrentRateLimits.s.sol

View the rate limiter query script on GitHub.

  1. Snapshot current v1 rate limits on the Sepolia → Arbitrum lane:
Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V1_POOL DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 forge script \
  script/configure/rate-limiter/GetCurrentRateLimits.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
Pool Version: v1

  Outbound Enabled:  true
  Outbound Capacity: 1000000000000000000000
  Outbound Rate:     100000000000000000
  Inbound  Enabled:  true
  Inbound  Capacity: 1000000000000000000000
  Inbound  Rate:     100000000000000000
  1. Snapshot current v1 rate limits on the Arbitrum → Sepolia lane:
Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V1_POOL DEST_CHAIN=ETHEREUM_SEPOLIA forge script \
  script/configure/rate-limiter/GetCurrentRateLimits.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
Pool Version: v1

  Outbound Enabled:  true
  Outbound Capacity: 1000000000000000000000
  Outbound Rate:     100000000000000000
  Inbound  Enabled:  true
  Inbound  Capacity: 1000000000000000000000
  Inbound  Rate:     100000000000000000

Record these values since you'll reuse them when configuring the v2 pools in Step 5.

3 Step 3: Deploy new v2 pools (per chain)

Deploy a new v2 BurnMintTokenPool on each chain, pointing to your existing token address on that chain.

DeployBurnMintTokenPool.s.sol

View the Burn & Mint pool deployment script on GitHub.

  1. Deploy the v2 pool on Ethereum Sepolia:
Terminal
TOKEN=$ETHEREUM_SEPOLIA_TOKEN forge script \
  script/deploy/DeployBurnMintTokenPool.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
Token Pool deployed at: 0xNewSepoliaV2PoolAddress
✅ Roles granted successfully!

Export the new v2 pool address:

Terminal
export ETHEREUM_SEPOLIA_V2_POOL=0xNewSepoliaV2PoolAddress
  1. Deploy the v2 pool on Arbitrum Sepolia:
Terminal
TOKEN=$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_TOKEN forge script \
  script/deploy/DeployBurnMintTokenPool.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
Token Pool deployed at: 0xNewArbitrumV2PoolAddress
✅ Roles granted successfully!

Export the new v2 pool address:

Terminal
export ARBITRUM_SEPOLIA_V2_POOL=0xNewArbitrumV2PoolAddress
4 Step 4 (Recommended): Pause outbound transfers on the v1 pools

This recommended step throttles new outbound traffic on v1 while you cut over. Use capacity = 2 and rate = 1 as the most restrictive (near-zero) configuration we document for v1 pools while keeping the lane configured.

UpdateRateLimiters.s.sol

View the rate limiter update script on GitHub.

  1. Pause outbound on the Sepolia v1 pool (lane to Arbitrum Sepolia):
Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V1_POOL \
  DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 \
  OUTBOUND_RATE_LIMIT_CAPACITY=2 \
  OUTBOUND_RATE_LIMIT_RATE=1 \
  forge script \
  script/configure/rate-limiter/UpdateRateLimiters.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
Pool Version: v1 (setChainRateLimiterConfig)

New Configuration:
  Outbound Enabled:  true
  Outbound Capacity: 2
  Outbound Rate:     1
  1. Pause outbound on the Arbitrum v1 pool (lane to Ethereum Sepolia):
Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V1_POOL \
  DEST_CHAIN=ETHEREUM_SEPOLIA \
  OUTBOUND_RATE_LIMIT_CAPACITY=2 \
  OUTBOUND_RATE_LIMIT_RATE=1 \
  forge script \
  script/configure/rate-limiter/UpdateRateLimiters.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast
5 Step 5: Configure the v2 pools (applyChainUpdates)

On each chain, configure the v2 pool to recognize the lane to the remote chain.

Critical migration rule: the destPools list must include both the old v1 remote pool address and the new v2 remote pool address. This allows in-flight messages sent via v1 (before cutover) to still validate after you cut over to v2.

ApplyChainUpdates.s.sol

View the applyChainUpdates script (JSON mode recommended) on GitHub.

apply-chain-updates.json

View the JSON input file used for applyChainUpdates on GitHub.

  1. Configure the Sepolia v2 pool (remote chain: Arbitrum Sepolia)

Update script/input/apply-chain-updates.json:

script/input/apply-chain-updates.json
{
  "_comment": "Configure Sepolia v2 pool → Arbitrum Sepolia. Replace 0x... placeholders with your real addresses.",
  "sourcePool": "0xNewSepoliaV2PoolAddress",
  "remoteChains": [
    {
      "destChain": "ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1",
      "destPools": ["0xOldArbitrumV1PoolAddress", "0xNewArbitrumV2PoolAddress"],
      "destToken": "0x...",
      "outboundRateLimit": {
        "enabled": true,
        "capacity": 1000000000000000000000,
        "rate": 100000000000000000
      },
      "inboundRateLimit": {
        "enabled": true,
        "capacity": 1000000000000000000000,
        "rate": 100000000000000000
      }
    }
  ]
}

Copy your v1 lane rate limits from Step 2 into outboundRateLimit and inboundRateLimit. If you don’t have existing values, you can use the baseline values shown above. Setting "enabled": false disables rate limiting (unlimited transfers).

Run the script on Ethereum Sepolia:

Terminal
VIA_JSON_FILE=true forge script \
  script/setup/ApplyChainUpdates.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
Remote Chains: 1

  [0] Arbitrum Sepolia
      Pools: 2
        [0] 0xOldArbitrumV1PoolAddress
        [1] 0xNewArbitrumV2PoolAddress

✅ Chain updates applied successfully!
  1. Configure the Arbitrum v2 pool (remote chain: Ethereum Sepolia)

Update script/input/apply-chain-updates.json:

script/input/apply-chain-updates.json
{
  "_comment": "Configure Arbitrum v2 pool → Ethereum Sepolia. Replace 0x... placeholders with your real addresses.",
  "sourcePool": "0xNewArbitrumV2PoolAddress",
  "remoteChains": [
    {
      "destChain": "ETHEREUM_SEPOLIA",
      "destPools": ["0xOldSepoliaV1PoolAddress", "0xNewSepoliaV2PoolAddress"],
      "destToken": "0x...",
      "outboundRateLimit": {
        "enabled": true,
        "capacity": 1000000000000000000000,
        "rate": 100000000000000000
      },
      "inboundRateLimit": {
        "enabled": true,
        "capacity": 1000000000000000000000,
        "rate": 100000000000000000
      }
    }
  ]
}

Run the script on Arbitrum Sepolia:

Terminal
VIA_JSON_FILE=true forge script \
  script/setup/ApplyChainUpdates.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
Remote Chains: 1

  [0] Ethereum Sepolia
      Pools: 2
        [0] 0xOldSepoliaV1PoolAddress
        [1] 0xNewSepoliaV2PoolAddress

✅ Chain updates applied successfully!
6 Step 6: Verify v2 configuration (before cutover)

Verify that each v2 pool has two remote pools configured for the lane: [remoteV1Pool, remoteV2Pool].

GetRemotePools.s.sol

View the remote pool query script on GitHub.

  1. Check remote pools on the Sepolia v2 pool:
Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 forge script \
  script/configure/remote-pools/GetRemotePools.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
Chain Supported: Yes
Remote Pools:    2
  [0] 0xOldArbitrumV1PoolAddress
  [1] 0xNewArbitrumV2PoolAddress
  1. Check remote pools on the Arbitrum v2 pool:
Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V2_POOL DEST_CHAIN=ETHEREUM_SEPOLIA forge script \
  script/configure/remote-pools/GetRemotePools.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
Chain Supported: Yes
Remote Pools:    2
  [0] 0xOldSepoliaV1PoolAddress
  [1] 0xNewSepoliaV2PoolAddress
GetCurrentRateLimits.s.sol

View the rate limiter query script on GitHub.

  1. Re-check rate limits on the v2 pools (optional but recommended)

Sepolia v2 pool (lane to Arbitrum):

Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 forge script \
  script/configure/rate-limiter/GetCurrentRateLimits.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Arbitrum v2 pool (lane to Sepolia):

Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V2_POOL DEST_CHAIN=ETHEREUM_SEPOLIA forge script \
  script/configure/rate-limiter/GetCurrentRateLimits.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL
7 Step 7: Cut over routing (TokenAdminRegistry.setPool)

This is the migration cutover step. On each chain, update TokenAdminRegistry so your token routes through the new v2 pool.

SetPool.s.sol

View the setPool script on GitHub.

  1. Cut over on Ethereum Sepolia:
Terminal
TOKEN=$ETHEREUM_SEPOLIA_TOKEN TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL forge script \
  script/setup/SetPool.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
✅ Pool set successfully!
  1. Cut over on Arbitrum Sepolia:
Terminal
TOKEN=$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_TOKEN TOKEN_POOL=$ARBITRUM_SEPOLIA_V2_POOL forge script \
  script/setup/SetPool.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast
8 Step 8: Validate end-to-end (Sepolia → Arbitrum) with ccip-cli

Send a small test transfer from Ethereum Sepolia → Arbitrum Sepolia and confirm it succeeds.

Set the router address for Ethereum Sepolia (from the CCIP Directory or HelperConfig.s.sol in the template):

Terminal
export ETHEREUM_SEPOLIA_ROUTER=0x0BF3dE8c5D3e8A2B34D2BEeB17ABfCeBaf363A59
  1. Send a transfer on default finality:
Terminal
ccip-cli send \
  --source ethereum-testnet-sepolia \
  --router $ETHEREUM_SEPOLIA_ROUTER \
  --dest ethereum-testnet-sepolia-arbitrum-1 \
  --transfer-tokens $ETHEREUM_SEPOLIA_TOKEN=1.23 \
  --receiver 0xYourReceiverAddress \
  --wallet foundry:$KEYSTORE_NAME \
  --rpc "$ETHEREUM_SEPOLIA_RPC_URL" \
  --rpc "$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL"

Your output should look something like this:

Terminal
🚀 Sending message ... messageId => 0x...
CCIP Explorer: https://ccip.chain.link/msg/0x...
  1. (Optional) Enable and request block-depth faster than finality with depth 32

First, allow block-depth finality on your v2 pools:

SetFinalityConfig.s.sol

View the finality configuration script on GitHub.

Terminal
BLOCK_DEPTH=32 TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL forge script \
  script/configure/finality-config/SetFinalityConfig.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

BLOCK_DEPTH=32 TOKEN_POOL=$ARBITRUM_SEPOLIA_V2_POOL forge script \
  script/configure/finality-config/SetFinalityConfig.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Then send using --extra finality=32:

Terminal
ccip-cli send \
  --source ethereum-testnet-sepolia \
  --router $ETHEREUM_SEPOLIA_ROUTER \
  --dest ethereum-testnet-sepolia-arbitrum-1 \
  --transfer-tokens $ETHEREUM_SEPOLIA_TOKEN=1.23 \
  --receiver 0xYourReceiverAddress \
  --extra finality=32 \
  --wallet foundry:$KEYSTORE_NAME \
  --rpc "$ETHEREUM_SEPOLIA_RPC_URL" \
  --rpc "$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL"
9 Step 9: Confirm your token now routes through v2 pools

Re-run the Step 1 checks. You should now see the v2 pool addresses as the live tokenPool on both chains, and typeAndVersion should report v2.

  1. Ethereum Sepolia:
Terminal
TOKEN=$ETHEREUM_SEPOLIA_TOKEN forge script script/setup/GetTokenConfig.s.sol --rpc-url $ETHEREUM_SEPOLIA_RPC_URL
ADDRESS=$ETHEREUM_SEPOLIA_V2_POOL forge script script/setup/GetTypeAndVersion.s.sol --rpc-url $ETHEREUM_SEPOLIA_RPC_URL

Your output should look something like this:

Terminal
Token Config:
  tokenPool:            0xNewSepoliaV2PoolAddress

typeAndVersion: BurnMintTokenPool 2.0.0
  1. Arbitrum Sepolia:
Terminal
TOKEN=$ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_TOKEN forge script script/setup/GetTokenConfig.s.sol --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL
ADDRESS=$ARBITRUM_SEPOLIA_V2_POOL forge script script/setup/GetTypeAndVersion.s.sol --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL

Your output should look something like this:

Terminal
Token Config:
  tokenPool:            0xNewArbitrumV2PoolAddress

typeAndVersion: BurnMintTokenPool 2.0.0
10 Step 10: Safety checks and cleanup (after v1 inflight settles)

After cutover, keep the v1 remote pool addresses configured on the v2 pools until you are confident there are no more in-flight v1 messages. There is no cost to waiting longer.

Once you’re ready, remove the old v1 remote pool addresses from the v2 pools.

RemoveRemotePool.s.sol

View the remote pool removal script on GitHub.

  1. On the Sepolia v2 pool, remove the old Arbitrum v1 pool address:
Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL \
  DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 \
  REMOTE_POOL_ADDRESS=$ARBITRUM_SEPOLIA_V1_POOL \
  forge script \
  script/configure/remote-pools/RemoveRemotePool.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

Your output should look something like this:

Terminal
⚠️  WARNING: All inflight transactions from this pool will be rejected after removal.

Current Remote Pools: 2
  [0] 0xOldArbitrumV1PoolAddress
  [1] 0xNewArbitrumV2PoolAddress

✅ Remote pool removed successfully!
  1. On the Arbitrum v2 pool, remove the old Sepolia v1 pool address:
Terminal
TOKEN_POOL=$ARBITRUM_SEPOLIA_V2_POOL \
  DEST_CHAIN=ETHEREUM_SEPOLIA \
  REMOTE_POOL_ADDRESS=$ETHEREUM_SEPOLIA_V1_POOL \
  forge script \
  script/configure/remote-pools/RemoveRemotePool.s.sol \
  --rpc-url $ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast
AddRemotePool.s.sol

View the remote pool add script on GitHub (recovery).

Recovery example (re-add the old pool address, then retry cleanup later):

Terminal
TOKEN_POOL=$ETHEREUM_SEPOLIA_V2_POOL \
  DEST_CHAIN=ETHEREUM_TESTNET_SEPOLIA_ARBITRUM_1 \
  REMOTE_POOL_ADDRESS=$ARBITRUM_SEPOLIA_V1_POOL \
  forge script \
  script/configure/remote-pools/AddRemotePool.s.sol \
  --rpc-url $ETHEREUM_SEPOLIA_RPC_URL \
  --account $KEYSTORE_NAME \
  --broadcast

What's next

Get the latest Chainlink content straight to your inbox.