@across-protocol/contracts 3.0.17 → 3.0.18

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

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

package/dist/scripts/svm/addressToPublicKey.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("address", {
+    type: "string",
+    demandOption: true,
+    describe: "Ethereum address to convert",
+}).argv;
+async function logPublicKey() {
+    const address = (await argv).address;
+    const publicKey = (0, SvmUtils_1.evmAddressToPublicKey)(address);
+    console.log("Ethereum Address:", address);
+    console.log("Associated Public Key:", publicKey.toString());
+}
+logPublicKey();

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

@@ -0,0 +1,28 @@
+/**
+ * Script: Bridge USDC Liability to Hub Pool
+ *
+ * This script bridges pending USDC liabilities from the Solana Spoke Pool to the Ethereum Hub Pool using the CCTP
+ * (Circle Cross-Chain Transfer Protocol). It manages CCTP message attestations, verifies transfer completion, and
+ * updates the Hub Pool’s USDC balance.
+ *
+ * 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).
+ *
+ * Example Usage:
+ * TESTNET=true \
+ * NODE_URL_11155111=$NODE_URL_11155111 \
+ * MNEMONIC=$MNEMONIC \
+ * HUB_POOL_ADDRESS=$HUB_POOL_ADDRESS \
+ * anchor run bridgeLiabilityToHubPool \
+ * --provider.cluster "devnet" \
+ * --provider.wallet $SOLANA_PKEY_PATH
+ *
+ * Note:
+ * - Ensure all required environment variables are properly configured.
+ * - Pending USDC liabilities must exist in the Solana Spoke Pool for the script to execute.
+ */
+export {};

package/dist/scripts/svm/bridgeLiabilityToHubPool.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Script: Bridge USDC Liability to Hub Pool
+ *
+ * This script bridges pending USDC liabilities from the Solana Spoke Pool to the Ethereum Hub Pool using the CCTP
+ * (Circle Cross-Chain Transfer Protocol). It manages CCTP message attestations, verifies transfer completion, and
+ * updates the Hub Pool’s USDC balance.
+ *
+ * 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).
+ *
+ * Example Usage:
+ * TESTNET=true \
+ * NODE_URL_11155111=$NODE_URL_11155111 \
+ * MNEMONIC=$MNEMONIC \
+ * HUB_POOL_ADDRESS=$HUB_POOL_ADDRESS \
+ * anchor run bridgeLiabilityToHubPool \
+ * --provider.cluster "devnet" \
+ * --provider.wallet $SOLANA_PKEY_PATH
+ *
+ * Note:
+ * - Ensure all required environment variables are properly configured.
+ * - Pending USDC liabilities must exist in the Solana Spoke Pool for the script to execute.
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const anchor = __importStar(require("@coral-xyz/anchor"));
+const anchor_1 = require("@coral-xyz/anchor");
+const spl_token_1 = require("@solana/spl-token");
+const web3_js_1 = require("@solana/web3.js");
+// eslint-disable-next-line camelcase
+const constants_1 = require("./utils/constants");
+const constants_2 = require("@across-protocol/constants");
+const common_1 = require("@uma/common");
+const ethers_1 = require("ethers");
+const cctpHelpers_1 = require("../../test/svm/cctpHelpers");
+const typechain_1 = require("../../typechain");
+const helpers_1 = require("./utils/helpers");
+// Set up Solana provider.
+const provider = anchor_1.AnchorProvider.env();
+anchor.setProvider(provider);
+// Get Solana programs and IDLs.
+const svmSpokeIdl = require("../../target/idl/svm_spoke.json");
+const svmSpokeProgram = new anchor_1.Program(svmSpokeIdl, provider);
+const messageTransmitterIdl = require("../../target/idl/message_transmitter.json");
+const tokenMessengerMinterIdl = require("../../target/idl/token_messenger_minter.json");
+// CCTP domains.
+const ethereumDomain = 0; // Ethereum
+const solanaDomain = 5; // Solana
+// 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_1.requireEnv)("MNEMONIC")).connect(ethersProvider);
+// Get the HubPool contract instance.
+const hubPoolAddress = ethers_1.ethers.utils.getAddress((0, helpers_1.requireEnv)("HUB_POOL_ADDRESS")); // Used to check USDC balance before and after.
+const messageTransmitterAbi = [
+    {
+        inputs: [
+            {
+                internalType: "bytes",
+                name: "message",
+                type: "bytes",
+            },
+            {
+                internalType: "bytes",
+                name: "attestation",
+                type: "bytes",
+            },
+        ],
+        name: "receiveMessage",
+        outputs: [
+            {
+                internalType: "bool",
+                name: "success",
+                type: "bool",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "bytes32",
+                name: "",
+                type: "bytes32",
+            },
+        ],
+        name: "usedNonces",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+];
+async function bridgeLiabilityToHubPool() {
+    const seed = constants_1.SOLANA_SPOKE_STATE_SEED; // Seed is always 0 for the state account PDA in public networks.
+    // Resolve Solana cluster, EVM chain ID, Iris API URL and USDC addresses.
+    let isDevnet;
+    const solanaRpcEndpoint = provider.connection.rpcEndpoint;
+    if (solanaRpcEndpoint.includes("devnet"))
+        isDevnet = true;
+    else if (solanaRpcEndpoint.includes("mainnet"))
+        isDevnet = false;
+    else
+        throw new Error(`Unsupported solanaCluster endpoint: ${solanaRpcEndpoint}`);
+    const svmUsdc = isDevnet ? constants_1.SOLANA_USDC_DEVNET : constants_1.SOLANA_USDC_MAINNET;
+    const [statePda, _] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("state"), seed.toArrayLike(Buffer, "le", 8)], svmSpokeProgram.programId);
+    const irisApiUrl = isDevnet ? constants_1.CIRCLE_IRIS_API_URL_DEVNET : constants_1.CIRCLE_IRIS_API_URL_MAINNET;
+    const cctpMessageTransmitter = isDevnet
+        ? constants_1.SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS
+        : constants_1.MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS;
+    const messageTransmitter = new ethers_1.ethers.Contract(cctpMessageTransmitter, messageTransmitterAbi, ethersSigner);
+    const evmChainId = (await ethersProvider.getNetwork()).chainId;
+    const usdcAddress = constants_2.TOKEN_SYMBOLS_MAP.USDC.addresses[evmChainId];
+    const usdc = typechain_1.BondToken__factory.connect(usdcAddress, ethersProvider);
+    const usdcBalanceBefore = await usdc.balanceOf(hubPoolAddress);
+    console.log("Receiving liability from Solana Spoke Pool to Ethereum Hub Pool...");
+    console.table([
+        { Property: "isTestnet", Value: process.env.TESTNET === "true" },
+        { Property: "hubPoolAddress", Value: hubPoolAddress },
+        { Property: "svmSpokeProgramProgramId", Value: svmSpokeProgram.programId.toString() },
+        { Property: "providerPublicKey", Value: provider.wallet.publicKey.toString() },
+        { Property: "usdcBalanceBefore", Value: usdcBalanceBefore.toString() },
+    ]);
+    const [transferLiability] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("transfer_liability"), new web3_js_1.PublicKey(svmUsdc).toBuffer()], svmSpokeProgram.programId);
+    const liability = await svmSpokeProgram.account.transferLiability.fetch(transferLiability);
+    console.log(`Pending transfer liability: ${(0, helpers_1.formatUsdc)(ethers_1.BigNumber.from(liability.pendingToHubPool.toString()))} USDC.`);
+    if (liability.pendingToHubPool.eq(new anchor_1.BN(0))) {
+        console.log("No pending transfer liability to bridge. Exiting...");
+        return;
+    }
+    console.log("Bridging liability to hub pool...");
+    const txHash = await bridgeTokensToHubPool(liability.pendingToHubPool, provider.wallet, statePda, new web3_js_1.PublicKey(svmUsdc));
+    const attestationResponse = await (0, cctpHelpers_1.getMessages)(txHash, solanaDomain, irisApiUrl);
+    const { attestation, message, eventNonce } = attestationResponse.messages[0];
+    console.log("CCTP attestation response:", attestationResponse.messages[0]);
+    const nonceHash = ethers_1.ethers.utils.solidityKeccak256(["uint32", "uint64"], [solanaDomain, eventNonce]);
+    const usedNonces = await messageTransmitter.usedNonces(nonceHash);
+    if (usedNonces.eq(1)) {
+        console.log(`Skipping already received message. Exiting...`);
+        return;
+    }
+    console.log("Receiving message from CCTP...");
+    const receiveTx = await messageTransmitter.receiveMessage(message, attestation);
+    console.log(`Tx hash: ${receiveTx.hash}`);
+    await receiveTx.wait();
+    console.log(`Received message`);
+    const usdcBalanceAfter = await usdc.balanceOf(hubPoolAddress);
+    console.log(`Hub Pool USDC balance after: ${(0, helpers_1.formatUsdc)(usdcBalanceAfter)}. Received ${(0, helpers_1.formatUsdc)(usdcBalanceAfter.sub(usdcBalanceBefore))} USDC.`);
+    console.log("✅ Bridge liability to hub pool completed successfully.");
+}
+async function bridgeTokensToHubPool(amount, signer, statePda, inputToken) {
+    const messageTransmitterProgram = new anchor_1.Program(messageTransmitterIdl, provider);
+    const vault = (0, spl_token_1.getAssociatedTokenAddressSync)(inputToken, statePda, true, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+    // Derive the transferLiability PDA
+    const [transferLiability] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("transfer_liability"), inputToken.toBuffer()], svmSpokeProgram.programId);
+    const tokenMessengerMinterProgram = new anchor_1.Program(tokenMessengerMinterIdl, provider);
+    const [tokenMessengerMinterSenderAuthority] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("sender_authority")], tokenMessengerMinterProgram.programId);
+    const [messageTransmitter] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("message_transmitter")], messageTransmitterProgram.programId);
+    const [tokenMessenger] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("token_messenger")], tokenMessengerMinterProgram.programId);
+    const [remoteTokenMessenger] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("remote_token_messenger"), Buffer.from(anchor.utils.bytes.utf8.encode(ethereumDomain.toString()))], tokenMessengerMinterProgram.programId);
+    const [tokenMinter] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("token_minter")], tokenMessengerMinterProgram.programId);
+    const [localToken] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("local_token"), inputToken.toBuffer()], tokenMessengerMinterProgram.programId);
+    const [cctpEventAuthority] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("__event_authority")], tokenMessengerMinterProgram.programId);
+    const messageSentEventData = anchor.web3.Keypair.generate(); // This will hold the message sent event data.
+    const bridgeTokensToHubPoolAccounts = {
+        payer: signer.publicKey,
+        mint: inputToken,
+        state: statePda,
+        transferLiability,
+        vault,
+        tokenMessengerMinterSenderAuthority,
+        messageTransmitter,
+        tokenMessenger,
+        remoteTokenMessenger,
+        tokenMinter,
+        localToken,
+        messageSentEventData: messageSentEventData.publicKey,
+        messageTransmitterProgram: messageTransmitterProgram.programId,
+        tokenMessengerMinterProgram: tokenMessengerMinterProgram.programId,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+        cctpEventAuthority: cctpEventAuthority,
+        program: svmSpokeProgram.programId,
+    };
+    const initialVaultBalance = (await provider.connection.getTokenAccountBalance(vault)).value.amount;
+    const tx = await svmSpokeProgram.methods
+        .bridgeTokensToHubPool(new anchor_1.BN(amount))
+        .accounts(bridgeTokensToHubPoolAccounts)
+        .signers([messageSentEventData])
+        .rpc();
+    const finalVaultBalance = (await provider.connection.getTokenAccountBalance(vault)).value.amount;
+    console.log(`SVM Spoke Pool Initial Vault balance: ${(0, helpers_1.formatUsdc)(ethers_1.BigNumber.from(initialVaultBalance))} USDC.`);
+    console.log(`SVM Spoke Pool Final Vault balance: ${(0, helpers_1.formatUsdc)(ethers_1.BigNumber.from(finalVaultBalance))} USDC.`);
+    console.log(`Sent ${(0, helpers_1.formatUsdc)(ethers_1.BigNumber.from(initialVaultBalance).sub(ethers_1.BigNumber.from(finalVaultBalance)))} USDC through CCTP.`);
+    return tx;
+}
+// Run the bridgeLiabilityToHubPool function
+bridgeLiabilityToHubPool();

package/dist/scripts/svm/closeRelayerPdas.js

@@ -34,7 +34,6 @@ 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 SvmUtils_2 = require("../../src/SvmUtils");
 // Set up the provider
 const provider = anchor_1.AnchorProvider.env();
 anchor.setProvider(provider);
@@ -78,7 +77,7 @@ async function closeExpiredRelays() {
 }
 async function closeFillPda(eventData, seed) {
     // Accept seed as a parameter
-    const relayData = {
+    const relayEventData = {
         depositor: new web3_js_1.PublicKey(eventData.depositor),
         recipient: new web3_js_1.PublicKey(eventData.recipient),
         exclusiveRelayer: new web3_js_1.PublicKey(eventData.exclusiveRelayer),
@@ -90,13 +89,13 @@ async function closeFillPda(eventData, seed) {
         depositId: eventData.depositId,
         fillDeadline: eventData.fillDeadline,
         exclusivityDeadline: eventData.exclusivityDeadline,
-        message: Buffer.from(eventData.message),
+        messageHash: eventData.messageHash,
     };
     const [statePda] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("state"), seed.toArrayLike(Buffer, "le", 8)], programId);
     // Fetch the state to get the chainId
     const state = await program.account.state.fetch(statePda);
     const chainId = new anchor_1.BN(state.chainId);
-    const relayHashUint8Array = (0, SvmUtils_2.calculateRelayHashUint8Array)(relayData, chainId);
+    const relayHashUint8Array = (0, SvmUtils_1.calculateRelayEventHashUint8Array)(relayEventData, chainId);
     const [fillStatusPda] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fills"), relayHashUint8Array], programId);
     try {
         // Check if the fillStatusPda account exists
@@ -106,8 +105,8 @@ async function closeFillPda(eventData, seed) {
             return;
         }
         // Display additional information in a table
-        console.log("Found a relay to close. Relay Data:");
-        console.table(Object.entries(relayData).map(([key, value]) => ({
+        console.log("Found a relay to close. Relay event data:");
+        console.table(Object.entries(relayEventData).map(([key, value]) => ({
             key,
             value: value.toString(),
         })));
@@ -116,7 +115,7 @@ async function closeFillPda(eventData, seed) {
             { Property: "Fill Status PDA", Value: fillStatusPda.toString() },
             { Property: "Relay Hash", Value: Buffer.from(relayHashUint8Array).toString("hex") },
         ]);
-        const tx = await program.methods.closeFillPda(Array.from(relayHashUint8Array), relayData)
+        const tx = await program.methods.closeFillPda()
             .accounts({
             state: statePda,
             signer: provider.wallet.publicKey,

package/dist/scripts/svm/enableRoute.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" })
@@ -54,7 +55,12 @@ async function enableRoute() {
     // 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"), originToken.toBytes(), statePda.toBytes(), chainId.toArrayLike(Buffer, "le", 8)], programId);
+    const [routePda] = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("route"),
+        originToken.toBytes(),
+        seed.toArrayLike(Buffer, "le", 8),
+        chainId.toArrayLike(Buffer, "le", 8),
+    ], programId);
     // Define the signer (replace with your actual signer)
     const signer = provider.wallet.publicKey;
     console.log("Enabling route...");

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

@@ -0,0 +1,32 @@
+/**
+ * Script: Execute USDC Rebalance to Hub Pool
+ *
+ * This script executes a previously proposed root bundle on the Hub Pool to rebalance USDC from the Solana Spoke Pool
+ * to the Ethereum Hub Pool. It handles CCTP attestations, relayer refund leaf execution, and prepares pending
+ * liabilities for bridging back to the Hub Pool.
+ *
+ * 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 Arguments:
+ * - `--netSendAmount`: The unscaled amount of USDC to rebalance (e.g., for USDC with 6 decimals, 1 = 0.000001 USDC).
+ * - `--resumeRemoteTx`: (Optional) Hash of a previously submitted remote transaction to resume.
+ *
+ * Example Usage:
+ * TESTNET=true \
+ * NODE_URL_11155111=$NODE_URL_11155111 \
+ * MNEMONIC=$MNEMONIC \
+ * HUB_POOL_ADDRESS=$HUB_POOL_ADDRESS \
+ * anchor run executeRebalanceToHubPool \
+ * --provider.cluster "devnet" \
+ * --provider.wallet $SOLANA_PKEY_PATH \
+ * -- --netSendAmount 7
+ *
+ * Note:
+ * - Ensure all required environment variables are properly configured.
+ */
+export {};