@across-protocol/contracts 3.0.17 → 3.0.18

package/dist/scripts/svm/proposeRebalanceToHubPool.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Script: Propose Root Bundle for USDC Rebalance to Hub Pool
+ *
+ * Submits a root bundle proposal on the Hub Pool to rebalance USDC from the Solana Spoke Pool to the Ethereum Hub Pool.
+ * After submission and the liveness period, the rebalance can be executed with `executeRebalanceToHubPool.ts`.
+ *
+ * Required Environment Variables:
+ * - TESTNET: (Optional) Set to "true" to use Sepolia; defaults to mainnet.
+ * - MNEMONIC: Wallet mnemonic to sign the Ethereum transaction.
+ * - HUB_POOL_ADDRESS: Ethereum address of the Hub Pool.
+ * - NODE_URL_1: Ethereum RPC URL for mainnet (ignored if TESTNET=true).
+ * - NODE_URL_11155111: Ethereum RPC URL for Sepolia (ignored if TESTNET=false).
+ *
+ * Required Argument:
+ * - `--netSendAmount`: The unscaled amount of USDC to rebalance. (e.g., for USDC with 6 decimals, 1 = 0.000001 USDC).
+ *
+ * Example Usage:
+ * TESTNET=true \
+ * NODE_URL_11155111=$NODE_URL_11155111 \
+ * MNEMONIC=$MNEMONIC \
+ * HUB_POOL_ADDRESS=$HUB_POOL_ADDRESS \
+ * anchor run proposeRebalanceToHubPool -- --netSendAmount 7
+ *
+ * Note:
+ * Ensure the required environment variables are set before running this script.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const web3_js_1 = require("@solana/web3.js");
+const common_1 = require("@uma/common");
+const ethers_1 = require("ethers");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const typechain_1 = require("../../typechain");
+const constants_1 = require("../../utils/constants");
+const constants_2 = require("./utils/constants");
+const helpers_2 = require("./utils/helpers");
+// Set up Ethereum provider and signer.
+const nodeURL = process.env.TESTNET === "true" ? (0, common_1.getNodeUrl)("sepolia", true) : (0, common_1.getNodeUrl)("mainnet", true);
+const ethersProvider = new ethers_1.ethers.providers.JsonRpcProvider(nodeURL);
+const ethersSigner = ethers_1.ethers.Wallet.fromMnemonic((0, helpers_2.requireEnv)("MNEMONIC")).connect(ethersProvider);
+// Get the HubPool contract instance.
+const hubPoolAddress = ethers_1.ethers.utils.getAddress((0, helpers_2.requireEnv)("HUB_POOL_ADDRESS"));
+const hubPool = typechain_1.HubPool__factory.connect(hubPoolAddress, ethersProvider);
+// Parse arguments.
+const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).option("netSendAmount", {
+    type: "string",
+    demandOption: true,
+    describe: "Net send amount to Hub Pool from Solana Spoke Pool",
+}).argv;
+async function proposeRebalanceToHubPool() {
+    const resolvedArgv = await argv;
+    const netSendAmount = ethers_1.BigNumber.from(resolvedArgv.netSendAmount);
+    // Resolve chain IDs and USDC address.
+    const evmChainId = (await ethersProvider.getNetwork()).chainId;
+    if (evmChainId !== constants_1.CHAIN_IDs.MAINNET && evmChainId !== constants_1.CHAIN_IDs.SEPOLIA) {
+        throw new Error("Unsupported EVM chain ID");
+    }
+    // If evmChainId is mainnet, use mainnet solana cluster. Otherwise, use devnet.
+    const solanaCluster = evmChainId === constants_1.CHAIN_IDs.MAINNET ? "mainnet" : "devnet";
+    const solanaChainId = (0, helpers_2.getSolanaChainId)(solanaCluster);
+    const svmUsdc = evmChainId === constants_1.CHAIN_IDs.MAINNET ? constants_2.SOLANA_USDC_MAINNET : constants_2.SOLANA_USDC_DEVNET;
+    // Check there are no active proposals.
+    const currentRootBundleProposal = await hubPool.callStatic.rootBundleProposal();
+    if (currentRootBundleProposal.unclaimedPoolRebalanceLeafCount !== 0) {
+        throw new Error("Proposal has unclaimed leaves");
+    }
+    // Ensure bond token balance and approval is sufficient.
+    const bondTokenAddress = await hubPool.callStatic.bondToken();
+    const bondAmount = await hubPool.callStatic.bondAmount();
+    const bondToken = typechain_1.BondToken__factory.connect(bondTokenAddress, ethersProvider);
+    const bondBalance = await bondToken.callStatic.balanceOf(ethersSigner.address);
+    if (bondBalance.lt(bondAmount)) {
+        const ethDeposit = bondAmount.sub(bondBalance);
+        console.log(`Depositing ${ethers_1.ethers.utils.formatUnits(ethDeposit.toString())} ETH into bond token:`);
+        const tx = await bondToken.connect(ethersSigner).deposit({ value: ethDeposit });
+        console.log(`✅ submitted tx hash: ${tx.hash}`);
+        await tx.wait();
+        console.log("✅ tx confirmed");
+    }
+    const allowance = await bondToken.callStatic.allowance(ethersSigner.address, hubPool.address);
+    if (allowance.lt(bondAmount)) {
+        console.log(`Approving ${ethers_1.ethers.utils.formatUnits(bondAmount.toString())} bond tokens for HubPool:`);
+        const tx = await bondToken.connect(ethersSigner).approve(hubPool.address, bondAmount);
+        console.log(`✅ submitted tx hash: ${tx.hash}`);
+        await tx.wait();
+        console.log("✅ tx confirmed");
+    }
+    // Construct an empty pool rebalance tree as we need to propose at least one leaf.
+    const { poolRebalanceTree } = (0, helpers_2.constructEmptyPoolRebalanceTree)(solanaChainId, 0);
+    // Relayer refund root Merkle tree.
+    const { merkleTree } = (0, helpers_2.constructSimpleRebalanceTreeToHubPool)(netSendAmount, solanaChainId, new web3_js_1.PublicKey(svmUsdc));
+    console.log("Proposing rebalance pool bundle to spoke...");
+    console.table([
+        { Property: "isTestnet", Value: process.env.TESTNET === "true" },
+        { Property: "originChainId", Value: evmChainId.toString() },
+        { Property: "targetChainId", Value: solanaChainId.toString() },
+        { Property: "hubPoolAddress", Value: hubPool.address },
+        { Property: "netSendAmount (formatted)", Value: (0, helpers_2.formatUsdc)(netSendAmount) },
+        { Property: "poolRebalanceRoot", Value: poolRebalanceTree.getHexRoot() },
+        { Property: "relayerRefundRoot", Value: merkleTree.getHexRoot() },
+    ]);
+    console.log("Submitting proposal...");
+    const tx = await hubPool.connect(ethersSigner).proposeRootBundle([0], // bundleEvaluationBlockNumbers, not checked in this script.
+    1, // poolRebalanceLeafCount, only one leaf in this script.
+    poolRebalanceTree.getHexRoot(), // poolRebalanceRoot.
+    merkleTree.getHexRoot(), // relayerRefundRoot.
+    ethers_1.ethers.constants.HashZero // slowRelayRoot.
+    );
+    await tx.wait();
+    console.log("✅ proposal submitted");
+}
+// Run the proposeRebalanceToHubPool function.
+proposeRebalanceToHubPool();

package/dist/scripts/svm/proposeRebalanceToSpokePool.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/svm/proposeRebalanceToSpokePool.js

@@ -0,0 +1,101 @@
+"use strict";
+// This script proposes root bundle on HubPool that would rebalance tokens to Solana Spoke Pool once executed.
+// Required environment:
+// - ETHERS_PROVIDER_URL: Ethereum RPC provider URL.
+// - ETHERS_MNEMONIC: Mnemonic of the wallet that will sign the sending transaction on Ethereum
+// - HUB_POOL_ADDRESS: Hub Pool address
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// eslint-disable-next-line camelcase
+const constants_1 = require("../../utils/constants");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const ethers_1 = require("ethers");
+// eslint-disable-next-line camelcase
+const typechain_1 = require("../../typechain");
+const poolRebalanceTree_1 = require("./utils/poolRebalanceTree");
+// Set up Ethereum provider.
+if (!process.env.ETHERS_PROVIDER_URL) {
+    throw new Error("Environment variable ETHERS_PROVIDER_URL is not set");
+}
+const ethersProvider = new ethers_1.ethers.providers.JsonRpcProvider(process.env.ETHERS_PROVIDER_URL);
+if (!process.env.ETHERS_MNEMONIC) {
+    throw new Error("Environment variable ETHERS_MNEMONIC is not set");
+}
+const ethersSigner = ethers_1.ethers.Wallet.fromMnemonic(process.env.ETHERS_MNEMONIC).connect(ethersProvider);
+// Get the HubPool contract instance.
+if (!process.env.HUB_POOL_ADDRESS) {
+    throw new Error("Environment variable HUB_POOL_ADDRESS is not set");
+}
+const hubPoolAddress = ethers_1.ethers.utils.getAddress(process.env.HUB_POOL_ADDRESS);
+const hubPool = typechain_1.HubPool__factory.connect(hubPoolAddress, ethersProvider);
+// Parse arguments
+const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).option("netSendAmount", {
+    type: "string",
+    demandOption: true,
+    describe: "Net send amount to spoke",
+}).argv;
+async function proposeRebalanceToSpokePool() {
+    const resolvedArgv = await argv;
+    const netSendAmount = ethers_1.BigNumber.from(resolvedArgv.netSendAmount);
+    // Resolve chain IDs and USDC address.
+    const evmChainId = (await ethersProvider.getNetwork()).chainId;
+    if (evmChainId !== constants_1.CHAIN_IDs.MAINNET && evmChainId !== constants_1.CHAIN_IDs.SEPOLIA)
+        throw new Error("Unsupported EVM chain ID");
+    const solanaCluster = evmChainId === constants_1.CHAIN_IDs.MAINNET ? "mainnet" : "devnet";
+    const solanaChainId = ethers_1.BigNumber.from(BigInt(ethers_1.ethers.utils.keccak256(ethers_1.ethers.utils.toUtf8Bytes(`solana-${solanaCluster}`))) & BigInt("0xFFFFFFFFFFFFFFFF"));
+    const l1TokenAddress = constants_1.TOKEN_SYMBOLS_MAP.USDC.addresses[evmChainId];
+    // Construct simple merkle tree for the pool rebalance.
+    const { poolRebalanceTree } = (0, poolRebalanceTree_1.constructSimpleRebalanceTree)(l1TokenAddress, netSendAmount, solanaChainId);
+    console.log("Proposing rebalance pool bundle to spoke...");
+    console.table([
+        { Property: "originChainId", Value: evmChainId.toString() },
+        { Property: "targetChainId", Value: solanaChainId.toString() },
+        { Property: "hubPoolAddress", Value: hubPool.address },
+        { Property: "l1TokenAddress", Value: l1TokenAddress },
+        { Property: "netSendAmount", Value: netSendAmount.toString() },
+        { Property: "poolRebalanceRoot", Value: poolRebalanceTree.getHexRoot() },
+    ]);
+    // Check there are no active proposals.
+    const currentRootBundleProposal = await hubPool.callStatic.rootBundleProposal();
+    if (currentRootBundleProposal.unclaimedPoolRebalanceLeafCount !== 0)
+        throw new Error("Proposal has unclaimed leaves");
+    // Ensure bond token balance and approval is sufficient
+    const bondTokenAddress = await hubPool.callStatic.bondToken();
+    const bondAmount = await hubPool.callStatic.bondAmount();
+    const bondToken = typechain_1.BondToken__factory.connect(bondTokenAddress, ethersProvider);
+    const bondBalance = await bondToken.callStatic.balanceOf(ethersSigner.address);
+    if (bondBalance.lt(bondAmount)) {
+        const ethDeposit = bondAmount.sub(bondBalance);
+        console.log(`Depositing ${ethers_1.ethers.utils.formatUnits(ethDeposit.toString())} ETH into bond token:`);
+        // This will throw if the signer does not have enough ETH.
+        const tx = await bondToken.connect(ethersSigner).deposit({ value: bondAmount.sub(bondBalance) });
+        console.log(`✔️ submitted tx hash: ${tx.hash}`);
+        await tx.wait();
+        console.log(`✔️ tx confirmed`);
+    }
+    const allowance = await bondToken.callStatic.allowance(ethersSigner.address, hubPool.address);
+    if (allowance.lt(bondAmount)) {
+        console.log(`Approving ${ethers_1.ethers.utils.formatUnits(bondAmount.toString())} bond tokens for HubPool:`);
+        const tx = await bondToken.connect(ethersSigner).approve(hubPool.address, bondAmount);
+        console.log(`✔️ submitted tx hash: ${tx.hash}`);
+        await tx.wait();
+        console.log(`✔️ tx confirmed`);
+    }
+    // Propose the rebalance to the spoke pool.
+    console.log(`Proposing ${netSendAmount.toString()} rebalance to spoke pool:`);
+    const tx = await hubPool.connect(ethersSigner).proposeRootBundle([0], // bundleEvaluationBlockNumbers, not checked in this script.
+    1, // poolRebalanceLeafCount.
+    poolRebalanceTree.getHexRoot(), // poolRebalanceRoot. Generated from the merkle tree constructed before.
+    ethers_1.ethers.constants.HashZero, // relayerRefundRoot, not relevant for this script.
+    ethers_1.ethers.constants.HashZero // slowRelayRoot, not relevant for this test.
+    );
+    console.log(`✔️ submitted tx hash: ${tx.hash}`);
+    await tx.wait();
+    console.log(`✔️ tx confirmed`);
+    console.log("Rebalance proposal submitted successfully, to execute, run executeRebalanceToSpokePool script with the same netSendAmount after liveness period.");
+}
+// Run the proposeRebalanceToSpokePool function
+proposeRebalanceToSpokePool();

package/dist/scripts/svm/publicKeyToAddress.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/svm/publicKeyToAddress.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const SvmUtils_1 = require("../../src/SvmUtils");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).option("publicKey", {
+    type: "string",
+    demandOption: true,
+    describe: "Public key to convert",
+}).argv;
+async function logEvmAddress() {
+    const publicKey = (await argv).publicKey;
+    const evmAddress = (0, SvmUtils_1.publicKeyToEvmAddress)(publicKey);
+    console.log("Public Key:", publicKey);
+    console.log("Associated Ethereum Address:", evmAddress);
+}
+logEvmAddress();

package/dist/scripts/svm/queryDeposits.js

@@ -39,6 +39,7 @@ anchor.setProvider(provider);
 const idl = require("../../target/idl/svm_spoke.json");
 const program = new anchor_1.Program(idl, provider);
 const programId = program.programId;
+console.log("SVM-Spoke Program ID:", programId.toString());
 // Parse arguments
 const argvPromise = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).option("seed", {
     type: "string",

package/dist/scripts/svm/queryFills.js

@@ -33,6 +33,7 @@ const web3_js_1 = require("@solana/web3.js");
 const yargs_1 = __importDefault(require("yargs"));
 const helpers_1 = require("yargs/helpers");
 const SvmUtils_1 = require("../../src/SvmUtils");
+const utils_1 = require("../../test/svm/utils");
 // Set up the provider
 const provider = anchor_1.AnchorProvider.env();
 anchor.setProvider(provider);
@@ -66,25 +67,23 @@ async function queryFills() {
         fillEvents.forEach((event, index) => {
             console.log(`Fill Event ${index + 1}:`);
             console.table([
-                { Property: "inputToken", Value: new web3_js_1.PublicKey(event.data.inputToken).toString() },
-                { Property: "outputToken", Value: new web3_js_1.PublicKey(event.data.outputToken).toString() },
+                { Property: "inputToken", Value: (0, SvmUtils_1.strPublicKey)(event.data.inputToken) },
+                { Property: "outputToken", Value: (0, SvmUtils_1.strPublicKey)(event.data.outputToken) },
                 { Property: "inputAmount", Value: event.data.inputAmount.toString() },
                 { Property: "outputAmount", Value: event.data.outputAmount.toString() },
                 { Property: "repaymentChainId", Value: event.data.repaymentChainId.toString() },
                 { Property: "originChainId", Value: event.data.originChainId.toString() },
                 { Property: "depositId", Value: event.data.depositId.toString() },
+                { Property: "depositIdNum", Value: (0, utils_1.u8Array32ToInt)(event.data.depositId).toString() },
                 { Property: "fillDeadline", Value: event.data.fillDeadline.toString() },
                 { Property: "exclusivityDeadline", Value: event.data.exclusivityDeadline.toString() },
-                { Property: "exclusiveRelayer", Value: new web3_js_1.PublicKey(event.data.exclusiveRelayer).toString() },
-                { Property: "relayer", Value: new web3_js_1.PublicKey(event.data.relayer).toString() },
-                { Property: "depositor", Value: new web3_js_1.PublicKey(event.data.depositor).toString() },
-                { Property: "recipient", Value: new web3_js_1.PublicKey(event.data.recipient).toString() },
-                { Property: "message", Value: event.data.message.toString() },
-                {
-                    Property: "updatedRecipient",
-                    Value: new web3_js_1.PublicKey(event.data.relayExecutionInfo.updatedRecipient).toString(),
-                },
-                { Property: "updatedMessage", Value: event.data.relayExecutionInfo.updatedMessage.toString() },
+                { Property: "exclusiveRelayer", Value: (0, SvmUtils_1.strPublicKey)(event.data.exclusiveRelayer) },
+                { Property: "relayer", Value: (0, SvmUtils_1.strPublicKey)(event.data.relayer) },
+                { Property: "depositor", Value: (0, SvmUtils_1.strPublicKey)(event.data.depositor) },
+                { Property: "recipient", Value: (0, SvmUtils_1.strPublicKey)(event.data.recipient) },
+                { Property: "messageHash", Value: event.data.messageHash.toString() },
+                { Property: "updatedRecipient", Value: (0, SvmUtils_1.strPublicKey)(event.data.relayExecutionInfo.updatedRecipient) },
+                { Property: "updatedMessageHash", Value: event.data.relayExecutionInfo.updatedMessageHash.toString() },
                 { Property: "updatedOutputAmount", Value: event.data.relayExecutionInfo.updatedOutputAmount.toString() },
                 { Property: "fillType", Value: event.data.relayExecutionInfo.fillType },
             ]);

package/dist/scripts/svm/queryRoute.js

@@ -39,6 +39,7 @@ anchor.setProvider(provider);
 const idl = require("../../target/idl/svm_spoke.json");
 const program = new anchor_1.Program(idl, provider);
 const programId = program.programId;
+console.log("SVM-Spoke Program ID:", programId.toString());
 // Parse arguments
 const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .option("seed", { type: "string", demandOption: true, describe: "Seed for the state account PDA" })
@@ -52,7 +53,12 @@ async function queryRoute() {
     // Define the state account PDA
     const [statePda, _] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("state"), seed.toArrayLike(Buffer, "le", 8)], programId);
     // Define the route account PDA
-    const [routePda] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("route"), Buffer.from(originToken), statePda.toBytes(), chainId.toArrayLike(Buffer, "le", 8)], programId);
+    const [routePda] = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("route"),
+        Buffer.from(originToken),
+        seed.toArrayLike(Buffer, "le", 8),
+        chainId.toArrayLike(Buffer, "le", 8),
+    ], programId);
     // Compute the vault address
     const vault = (0, spl_token_1.getAssociatedTokenAddressSync)(new web3_js_1.PublicKey(originToken), statePda, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
     console.log("Querying route...");

package/dist/scripts/svm/queryState.js

@@ -38,6 +38,7 @@ anchor.setProvider(provider);
 const idl = require("../../target/idl/svm_spoke.json");
 const program = new anchor_1.Program(idl, provider);
 const programId = program.programId;
+console.log("SVM-Spoke Program ID:", programId.toString());
 // Parse arguments
 const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).option("seed", {
     type: "string",

package/dist/scripts/svm/remoteHubPoolPauseDeposits.d.ts

@@ -0,0 +1 @@
+import "dotenv/config";

package/dist/scripts/svm/remoteHubPoolPauseDeposits.js

@@ -0,0 +1,205 @@
+"use strict";
+// This script bridges remote call to pause deposits on Solana Spoke Pool. Required environment:
+// - ETHERS_PROVIDER_URL: Ethereum RPC provider URL.
+// - ETHERS_MNEMONIC: Mnemonic of the wallet that will sign the sending transaction on Ethereum
+// - HUB_POOL_ADDRESS: Hub Pool address
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const anchor = __importStar(require("@coral-xyz/anchor"));
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+require("dotenv/config");
+const ethers_1 = require("ethers");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const cctpHelpers_1 = require("../../test/svm/cctpHelpers");
+const typechain_1 = require("../../typechain");
+const constants_1 = require("./utils/constants");
+// Set up Solana provider.
+const provider = anchor_1.AnchorProvider.env();
+anchor.setProvider(provider);
+// Parse arguments
+const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+    .option("chainId", { type: "string", demandOption: true, describe: "Chain ID" })
+    .option("pause", { type: "boolean", demandOption: true, describe: "Pause deposits" })
+    .option("resumeRemoteTx", { type: "string", demandOption: false, describe: "Resume receiving remote tx" }).argv;
+async function remoteHubPoolPauseDeposit() {
+    const resolvedArgv = await argv;
+    const chainId = resolvedArgv.chainId;
+    const seed = new anchor_1.BN(0);
+    const resumeRemoteTx = resolvedArgv.resumeRemoteTx;
+    const pause = resolvedArgv.pause;
+    // Set up Ethereum provider.
+    if (!process.env.ETHERS_PROVIDER_URL) {
+        throw new Error("Environment variable ETHERS_PROVIDER_URL is not set");
+    }
+    const ethersProvider = new ethers_1.ethers.providers.JsonRpcProvider(process.env.ETHERS_PROVIDER_URL);
+    if (!process.env.ETHERS_MNEMONIC) {
+        throw new Error("Environment variable ETHERS_MNEMONIC is not set");
+    }
+    const ethersSigner = ethers_1.ethers.Wallet.fromMnemonic(process.env.ETHERS_MNEMONIC).connect(ethersProvider);
+    if (!process.env.HUB_POOL_ADDRESS) {
+        throw new Error("Environment variable HUB_POOL_ADDRESS is not set");
+    }
+    const hubPoolAddress = process.env.HUB_POOL_ADDRESS;
+    let cluster;
+    const rpcEndpoint = provider.connection.rpcEndpoint;
+    if (rpcEndpoint.includes("devnet"))
+        cluster = "devnet";
+    else if (rpcEndpoint.includes("mainnet"))
+        cluster = "mainnet";
+    else
+        throw new Error(`Unsupported cluster endpoint: ${rpcEndpoint}`);
+    const isDevnet = cluster == "devnet";
+    // CCTP domains.
+    const remoteDomain = 0; // Ethereum
+    // Get Solana programs and accounts.
+    const svmSpokeIdl = require("../../target/idl/svm_spoke.json");
+    const svmSpokeProgram = new anchor_1.Program(svmSpokeIdl, provider);
+    const [statePda, _] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("state"), seed.toArrayLike(Buffer, "le", 8)], svmSpokeProgram.programId);
+    const messageTransmitterIdl = require("../../target/idl/message_transmitter.json");
+    const messageTransmitterProgram = new anchor_1.Program(messageTransmitterIdl, provider);
+    const [messageTransmitterState] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("message_transmitter")], messageTransmitterProgram.programId);
+    const [authorityPda] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("message_transmitter_authority"), svmSpokeProgram.programId.toBuffer()], messageTransmitterProgram.programId);
+    const [selfAuthority] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("self_authority")], svmSpokeProgram.programId);
+    const [eventAuthority] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("__event_authority")], svmSpokeProgram.programId);
+    const irisApiUrl = isDevnet ? constants_1.CIRCLE_IRIS_API_URL_DEVNET : constants_1.CIRCLE_IRIS_API_URL_MAINNET;
+    const hubPool = typechain_1.HubPool__factory.connect(hubPoolAddress, ethersProvider);
+    const spokePoolIface = new ethers_1.ethers.utils.Interface(["function pauseDeposits(bool pause)"]);
+    console.log("Remotely configuring deposit route...");
+    console.table([
+        { Property: "seed", Value: seed.toString() },
+        { Property: "chainId", Value: chainId.toString() },
+        { Property: "pause", Value: pause },
+        { Property: "svmSpokeProgramProgramId", Value: svmSpokeProgram.programId.toString() },
+        { Property: "providerPublicKey", Value: provider.wallet.publicKey.toString() },
+        { Property: "statePda", Value: statePda.toString() },
+        { Property: "messageTransmitterProgramId", Value: messageTransmitterProgram.programId.toString() },
+        { Property: "messageTransmitterState", Value: messageTransmitterState.toString() },
+        { Property: "authorityPda", Value: authorityPda.toString() },
+        { Property: "selfAuthority", Value: selfAuthority.toString() },
+        { Property: "eventAuthority", Value: eventAuthority.toString() },
+        { Property: "remoteSender", Value: ethersSigner.address },
+    ]);
+    // Send pauseDeposits call from Ethereum, unless resuming a remote transaction.
+    let remoteTxHash;
+    if (!resumeRemoteTx) {
+        console.log("Sending pauseDeposits message from HubPool...");
+        const calldata = spokePoolIface.encodeFunctionData("pauseDeposits", [pause]);
+        const tx = await hubPool.connect(ethersSigner).relaySpokePoolAdminFunction(chainId, calldata);
+        await tx.wait();
+        remoteTxHash = tx.hash;
+        console.log("Message sent on remote chain, tx", remoteTxHash);
+    }
+    else
+        remoteTxHash = resumeRemoteTx;
+    // Fetch attestation from CCTP attestation service.
+    const attestationResponse = await (0, cctpHelpers_1.getMessages)(remoteTxHash, remoteDomain, irisApiUrl);
+    const { attestation, message } = attestationResponse.messages[0];
+    console.log("CCTP attestation response:", attestationResponse.messages[0]);
+    // Accounts in CCTP message_transmitter receive_message instruction.
+    const nonce = (0, cctpHelpers_1.decodeMessageHeader)(Buffer.from(message.replace("0x", ""), "hex")).nonce;
+    const usedNonces = (await messageTransmitterProgram.methods
+        .getNoncePda({
+        nonce: new anchor_1.BN(nonce.toString()),
+        sourceDomain: remoteDomain,
+    })
+        .accounts({
+        messageTransmitter: messageTransmitterState,
+    })
+        .view());
+    const receiveMessageAccounts = {
+        payer: provider.wallet.publicKey,
+        caller: provider.wallet.publicKey,
+        authorityPda,
+        messageTransmitter: messageTransmitterState,
+        usedNonces,
+        receiver: svmSpokeProgram.programId,
+        systemProgram: anchor_1.web3.SystemProgram.programId,
+    };
+    // accountMetas list to pass to remaining accounts when receiving message via CCTP.
+    const remainingAccounts = [];
+    // state in HandleReceiveMessage accounts (used for remote domain and sender authentication).
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: false,
+        pubkey: statePda,
+    });
+    // self_authority in HandleReceiveMessage accounts, also signer in self-invoked CPIs.
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: false,
+        pubkey: selfAuthority,
+    });
+    // program in HandleReceiveMessage accounts.
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: false,
+        pubkey: svmSpokeProgram.programId,
+    });
+    // state
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: true,
+        pubkey: statePda,
+    });
+    // event_authority in self-invoked CPIs (appended by Anchor with event_cpi macro).
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: true,
+        pubkey: eventAuthority,
+    });
+    // program
+    remainingAccounts.push({
+        isSigner: false,
+        isWritable: true,
+        pubkey: svmSpokeProgram.programId,
+    });
+    // Receive remote message on Solana.
+    console.log("Receiving message on Solana...");
+    const receiveMessageTx = await messageTransmitterProgram.methods
+        .receiveMessage({
+        message: Buffer.from(message.replace("0x", ""), "hex"),
+        attestation: Buffer.from(attestation.replace("0x", ""), "hex"),
+    })
+        .accounts(receiveMessageAccounts)
+        .remainingAccounts(remainingAccounts)
+        .rpc();
+    console.log("\nReceived remote message");
+    console.log("Your transaction signature", receiveMessageTx);
+    let stateAccount = await svmSpokeProgram.account.state.fetch(statePda);
+    console.log("Updated deposit route state to: pausedDeposits =", stateAccount.pausedDeposits);
+}
+remoteHubPoolPauseDeposit()
+    .then(() => {
+    process.exit(0);
+})
+    .catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/scripts/svm/simpleDeposit.js

@@ -39,6 +39,7 @@ anchor.setProvider(provider);
 const idl = require("../../target/idl/svm_spoke.json");
 const program = new anchor_1.Program(idl, provider);
 const programId = program.programId;
+console.log("SVM-Spoke Program ID:", programId.toString());
 // Parse arguments
 const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .option("seed", { type: "string", demandOption: true, describe: "Seed for the state account PDA" })
@@ -65,7 +66,12 @@ async function depositV3() {
     // Define the state account PDA
     const [statePda, _] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("state"), seed.toArrayLike(Buffer, "le", 8)], programId);
     // Define the route account PDA
-    const [routePda] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("route"), inputToken.toBytes(), statePda.toBytes(), destinationChainId.toArrayLike(Buffer, "le", 8)], programId);
+    const [routePda] = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("route"),
+        inputToken.toBytes(),
+        seed.toArrayLike(Buffer, "le", 8),
+        destinationChainId.toArrayLike(Buffer, "le", 8),
+    ], programId);
     // Define the signer (replace with your actual signer)
     const signer = provider.wallet.payer;
     // Find ATA for the input token to be stored by state (vault). This was created when the route was enabled.

package/dist/scripts/svm/simpleFill.js

@@ -35,6 +35,7 @@ const spl_token_1 = require("@solana/spl-token");
 const yargs_1 = __importDefault(require("yargs"));
 const helpers_1 = require("yargs/helpers");
 const SvmUtils_1 = require("../../src/SvmUtils");
+const utils_1 = require("../../test/svm/utils");
 // Set up the provider
 const provider = anchor_1.AnchorProvider.env();
 anchor.setProvider(provider);
@@ -52,7 +53,7 @@ const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .option("inputAmount", { type: "number", demandOption: true, describe: "Input amount" })
     .option("outputAmount", { type: "number", demandOption: true, describe: "Output amount" })
     .option("originChainId", { type: "string", demandOption: true, describe: "Origin chain ID" })
-    .option("depositId", { type: "array", demandOption: true, describe: "Deposit ID" })
+    .option("depositId", { type: "string", demandOption: true, describe: "Deposit ID" })
     .option("fillDeadline", { type: "number", demandOption: false, describe: "Fill deadline" })
     .option("exclusivityDeadline", { type: "number", demandOption: false, describe: "Exclusivity deadline" }).argv;
 async function fillV3Relay() {
@@ -65,7 +66,7 @@ async function fillV3Relay() {
     const inputAmount = new anchor_1.BN(resolvedArgv.inputAmount);
     const outputAmount = new anchor_1.BN(resolvedArgv.outputAmount);
     const originChainId = new anchor_1.BN(resolvedArgv.originChainId);
-    const depositId = resolvedArgv.depositId;
+    const depositId = (0, utils_1.intToU8Array32)(new anchor_1.BN(resolvedArgv.depositId));
     const fillDeadline = resolvedArgv.fillDeadline || Math.floor(Date.now() / 1000) + 60; // Current time + 1 minute
     const exclusivityDeadline = resolvedArgv.exclusivityDeadline || Math.floor(Date.now() / 1000) + 30; // Current time + 30 seconds
     const message = Buffer.from("");
@@ -79,7 +80,7 @@ async function fillV3Relay() {
         inputAmount,
         outputAmount,
         originChainId,
-        depositId: depositId.map((id) => Number(id)),
+        depositId,
         fillDeadline,
         exclusivityDeadline,
         message,
@@ -122,7 +123,7 @@ async function fillV3Relay() {
         state: statePda,
         signer: signer.publicKey,
         instructionParams: program.programId,
-        mintAccount: outputToken,
+        mint: outputToken,
         relayerTokenAccount: relayerTokenAccount,
         recipientTokenAccount: recipientTokenAccount,
         fillStatus: fillStatusPda,

package/dist/scripts/svm/utils/constants.d.ts

@@ -1,4 +1,8 @@
+import BN from "bn.js";
 export declare const CIRCLE_IRIS_API_URL_DEVNET = "https://iris-api-sandbox.circle.com";
 export declare const CIRCLE_IRIS_API_URL_MAINNET = "https://iris-api.circle.com";
 export declare const SOLANA_USDC_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 export declare const SOLANA_USDC_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+export declare const SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x7865fAfC2db2093669d92c0F33AeEF291086BEFD";
+export declare const MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x0a992d191deec32afe36203ad87d7d289a738f81";
+export declare const SOLANA_SPOKE_STATE_SEED: BN;

package/dist/scripts/svm/utils/constants.js

@@ -1,7 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOLANA_USDC_DEVNET = exports.SOLANA_USDC_MAINNET = exports.CIRCLE_IRIS_API_URL_MAINNET = exports.CIRCLE_IRIS_API_URL_DEVNET = void 0;
+exports.SOLANA_SPOKE_STATE_SEED = exports.MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS = exports.SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS = exports.SOLANA_USDC_DEVNET = exports.SOLANA_USDC_MAINNET = exports.CIRCLE_IRIS_API_URL_MAINNET = exports.CIRCLE_IRIS_API_URL_DEVNET = void 0;
+const bn_js_1 = __importDefault(require("bn.js"));
 exports.CIRCLE_IRIS_API_URL_DEVNET = "https://iris-api-sandbox.circle.com";
 exports.CIRCLE_IRIS_API_URL_MAINNET = "https://iris-api.circle.com";
 exports.SOLANA_USDC_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 exports.SOLANA_USDC_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+exports.SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x7865fAfC2db2093669d92c0F33AeEF291086BEFD";
+exports.MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x0a992d191deec32afe36203ad87d7d289a738f81";
+exports.SOLANA_SPOKE_STATE_SEED = new bn_js_1.default(0);