agentwallet-sdk 2.4.0 → 2.4.1

package/dist/bridge/client.js

@@ -0,0 +1,393 @@
+// [MAX-ADDED] BridgeModule — CCTP V2 cross-chain USDC bridge for AgentWallet
+// Supports: Base → Ethereum, Base → Optimism (extensible to any CCTP V2 chain)
+//
+// Architecture:
+//   1. Approve USDC to TokenMessengerV2 on source chain (EOA-level signing)
+//   2. Call depositForBurn → extracts MessageSent bytes + messageHash
+//   3. Poll Circle IRIS API for attestation (~12s for fast, ~15min for finalized)
+//   4. Call receiveMessage on destination MessageTransmitterV2 to mint USDC
+//
+// Non-custodial: all signing is done locally via the agent's WalletClient.
+// No private keys ever leave the caller's environment.
+import { createPublicClient, http, keccak256, pad, getContract, } from 'viem';
+import { base, mainnet, optimism, arbitrum } from 'viem/chains';
+import { TokenMessengerV2Abi, MessageTransmitterV2Abi, ERC20BridgeAbi, } from './abis.js';
+import { CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, USDC_CONTRACT, TOKEN_MESSENGER_V2, MESSAGE_TRANSMITTER_V2, FINALITY_THRESHOLD, CIRCLE_ATTESTATION_API, MAX_ATTESTATION_POLLS, ATTESTATION_POLL_INTERVAL_MS, } from './types.js';
+// Viem chain objects indexed by BridgeChain
+const VIEM_CHAINS = {
+    base,
+    ethereum: mainnet,
+    optimism,
+    arbitrum,
+};
+/**
+ * BridgeModule — CCTP V2 cross-chain USDC bridge.
+ *
+ * Usage:
+ * ```ts
+ * const bridge = new BridgeModule(walletClient, 'base', { rpcUrl: '...' });
+ * const result = await bridge.bridge(1_000_000n, 'optimism');
+ * console.log('Minted on Optimism:', result.mintTxHash);
+ * ```
+ */
+export class BridgeModule {
+    constructor(walletClient, fromChain = 'base', options = {}) {
+        if (!walletClient.account) {
+            throw new BridgeError('NO_WALLET_CLIENT', 'WalletClient must have an account attached. ' +
+                'Use privateKeyToAccount() or similar to attach a signer.');
+        }
+        this.walletClient = walletClient;
+        this.fromChain = fromChain;
+        this.fromRpcUrl = options.rpcUrl;
+        this.publicClient = createPublicClient({
+            chain: VIEM_CHAINS[fromChain],
+            transport: http(options.rpcUrl),
+        });
+    }
+    // ─── Public API ───
+    /**
+     * Bridge USDC from the source chain to the destination chain.
+     *
+     * This is the primary method. It orchestrates the full CCTP V2 flow:
+     * approve → burn → attest → mint.
+     *
+     * @param amount - Amount in USDC base units (6 decimals). e.g. 1_000_000n = 1 USDC
+     * @param toChain - Destination chain ('ethereum' | 'optimism' | 'arbitrum')
+     * @param options - Optional overrides (finality, fees, destination address)
+     *
+     * @throws BridgeError with actionable message if anything fails
+     */
+    async bridge(amount, toChain, options = {}) {
+        const startMs = Date.now();
+        // 1. Validate inputs
+        this.validateBridgeParams(amount, toChain);
+        const account = this.walletClient.account;
+        const recipient = options.destinationAddress ?? account.address;
+        const minFinalityThreshold = options.minFinalityThreshold ?? FINALITY_THRESHOLD.FAST;
+        const maxFee = options.maxFee ?? 0n;
+        const attestationApiUrl = options.attestationApiUrl ?? CIRCLE_ATTESTATION_API;
+        // 2. Approve USDC to TokenMessengerV2 on source chain
+        await this.approveUsdc(amount);
+        // 3. Burn USDC on source chain
+        const burnResult = await this.depositForBurn(amount, toChain, recipient, minFinalityThreshold, maxFee);
+        // 4. Poll for Circle attestation
+        const attestation = await this.pollForAttestation(burnResult.messageHash, this.fromChain, attestationApiUrl);
+        // 5. Mint on destination chain
+        const mintTxHash = await this.receiveMessage(burnResult.messageBytes, attestation, toChain, options.destinationRpcUrl);
+        return {
+            burnTxHash: burnResult.burnTxHash,
+            mintTxHash,
+            amount,
+            fromChain: this.fromChain,
+            toChain,
+            recipient,
+            nonce: burnResult.nonce,
+            elapsedMs: Date.now() - startMs,
+        };
+    }
+    /**
+     * Step 1 of 3: Burn USDC on the source chain.
+     * Returns the burn result including message bytes needed for minting.
+     * Use this for manual/split-phase bridging.
+     */
+    async burn(amount, toChain, options = {}) {
+        this.validateBridgeParams(amount, toChain);
+        const account = this.walletClient.account;
+        const recipient = options.destinationAddress ?? account.address;
+        const minFinalityThreshold = options.minFinalityThreshold ?? FINALITY_THRESHOLD.FAST;
+        const maxFee = options.maxFee ?? 0n;
+        await this.approveUsdc(amount);
+        return this.depositForBurn(amount, toChain, recipient, minFinalityThreshold, maxFee);
+    }
+    /**
+     * Step 2 of 3: Poll Circle IRIS API for attestation.
+     * Returns the attestation bytes once Circle confirms the message.
+     */
+    async waitForAttestation(messageHash, apiUrl = CIRCLE_ATTESTATION_API) {
+        return this.pollForAttestation(messageHash, this.fromChain, apiUrl);
+    }
+    /**
+     * Step 3 of 3: Mint USDC on the destination chain using the attestation.
+     */
+    async mint(messageBytes, attestation, toChain, destinationRpcUrl) {
+        return this.receiveMessage(messageBytes, attestation, toChain, destinationRpcUrl);
+    }
+    /**
+     * Fetch the current USDC balance on the source chain for the signer's address.
+     */
+    async getUsdcBalance() {
+        const account = this.walletClient.account;
+        const usdc = getContract({
+            address: USDC_CONTRACT[this.fromChain],
+            abi: ERC20BridgeAbi,
+            client: this.publicClient,
+        });
+        return usdc.read.balanceOf([account.address]);
+    }
+    /**
+     * Fetch the current USDC allowance for the TokenMessengerV2 on source chain.
+     */
+    async getUsdcAllowance() {
+        const account = this.walletClient.account;
+        const usdc = getContract({
+            address: USDC_CONTRACT[this.fromChain],
+            abi: ERC20BridgeAbi,
+            client: this.publicClient,
+        });
+        return usdc.read.allowance([
+            account.address,
+            TOKEN_MESSENGER_V2[this.fromChain],
+        ]);
+    }
+    // ─── Internal Implementation ───
+    /**
+     * Approve TokenMessengerV2 to spend USDC on behalf of the signer.
+     * Skips if existing allowance is sufficient.
+     */
+    async approveUsdc(amount) {
+        const account = this.walletClient.account;
+        const spender = TOKEN_MESSENGER_V2[this.fromChain];
+        const usdcAddress = USDC_CONTRACT[this.fromChain];
+        // Check current allowance
+        const usdc = getContract({
+            address: usdcAddress,
+            abi: ERC20BridgeAbi,
+            client: this.publicClient,
+        });
+        const currentAllowance = await usdc.read.allowance([account.address, spender]);
+        if (currentAllowance >= amount) {
+            return; // Sufficient allowance, skip approve
+        }
+        // Execute approve
+        const usdcWrite = getContract({
+            address: usdcAddress,
+            abi: ERC20BridgeAbi,
+            client: { public: this.publicClient, wallet: this.walletClient },
+        });
+        const approveTxHash = await usdcWrite.write.approve([spender, amount], { account, chain: VIEM_CHAINS[this.fromChain] });
+        const approveReceipt = await this.publicClient.waitForTransactionReceipt({
+            hash: approveTxHash,
+        });
+        if (approveReceipt.status !== 'success') {
+            throw new BridgeError('INSUFFICIENT_ALLOWANCE', `USDC approve failed (tx: ${approveTxHash}). ` +
+                `Check that the account has sufficient gas and USDC on ${this.fromChain}.`);
+        }
+    }
+    /**
+     * Call TokenMessengerV2.depositForBurn and extract MessageSent data.
+     */
+    async depositForBurn(amount, toChain, recipient, minFinalityThreshold, maxFee) {
+        const account = this.walletClient.account;
+        const destinationDomain = CCTP_DOMAIN_IDS[toChain];
+        const messengerAddress = TOKEN_MESSENGER_V2[this.fromChain];
+        const usdcAddress = USDC_CONTRACT[this.fromChain];
+        // CCTP requires mintRecipient as a 32-byte left-padded address
+        const mintRecipient = pad(recipient, { size: 32 });
+        // destinationCaller = bytes32(0) means anyone can call receiveMessage
+        const destinationCaller = pad('0x0', { size: 32 });
+        const messenger = getContract({
+            address: messengerAddress,
+            abi: TokenMessengerV2Abi,
+            client: { public: this.publicClient, wallet: this.walletClient },
+        });
+        let burnTxHash;
+        try {
+            burnTxHash = await messenger.write.depositForBurn([
+                amount,
+                destinationDomain,
+                mintRecipient,
+                usdcAddress,
+                destinationCaller,
+                maxFee,
+                minFinalityThreshold,
+            ], { account, chain: VIEM_CHAINS[this.fromChain] });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new BridgeError('BURN_FAILED', `CCTP depositForBurn failed: ${msg}. ` +
+                `Ensure the wallet has sufficient USDC and ETH for gas on ${this.fromChain}.`);
+        }
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: burnTxHash,
+        });
+        if (receipt.status !== 'success') {
+            throw new BridgeError('BURN_FAILED', `depositForBurn transaction reverted (tx: ${burnTxHash}). ` +
+                `Check USDC balance, allowance, and gas on ${this.fromChain}.`);
+        }
+        // Extract MessageSent event from the receipt logs
+        const { messageBytes, messageHash, nonce } = this.extractMessageSent(receipt);
+        return {
+            burnTxHash,
+            nonce,
+            messageHash,
+            messageBytes,
+            sourceDomain: CCTP_DOMAIN_IDS[this.fromChain],
+            destinationDomain,
+        };
+    }
+    /**
+     * Extract the CCTP MessageSent event from a transaction receipt.
+     * The MessageTransmitter emits this event during depositForBurn.
+     */
+    extractMessageSent(receipt) {
+        // MessageSent event topic: keccak256("MessageSent(bytes)")
+        const MESSAGE_SENT_TOPIC = '0x8c5261668696ce22758910d05bab8f186d6eb247ceac2af2e82c7dc17669b036';
+        for (const log of receipt.logs) {
+            if (log.topics[0]?.toLowerCase() === MESSAGE_SENT_TOPIC.toLowerCase()) {
+                // The message bytes are ABI-encoded in the log data
+                // Format: bytes32 offset (0x20) + bytes32 length + data
+                const rawData = log.data;
+                // Decode: first 32 bytes = offset, next 32 bytes = length, rest = message
+                if (rawData.length < 130)
+                    continue; // sanity check (0x + 64 hex chars minimum)
+                // Parse length from bytes 32-63 (offset 64-127 in hex string)
+                const dataHex = rawData.slice(2); // remove 0x
+                const lengthHex = dataHex.slice(64, 128); // bytes 32-64
+                const messageLength = parseInt(lengthHex, 16);
+                if (messageLength === 0)
+                    continue;
+                // Extract message bytes
+                const messageBytesHex = dataHex.slice(128, 128 + messageLength * 2);
+                const messageBytes = ('0x' + messageBytesHex);
+                const messageHash = keccak256(messageBytes);
+                // Extract nonce from message bytes (bytes 12-19, after version[4] + sourceDomain[4] + destDomain[4])
+                const nonceBytesHex = messageBytesHex.slice(24, 40); // bytes 12-20
+                const nonce = BigInt('0x' + nonceBytesHex);
+                return { messageBytes, messageHash, nonce };
+            }
+        }
+        throw new BridgeError('BURN_FAILED', 'Could not find MessageSent event in burn transaction receipt. ' +
+            'The transaction may have succeeded but CCTP message was not emitted. ' +
+            'Check the transaction on the block explorer.');
+    }
+    /**
+     * Poll the Circle IRIS API until the attestation is ready.
+     * Fast finality: ~12 seconds. Full finality: ~15 minutes on Ethereum.
+     */
+    async pollForAttestation(messageHash, fromChain, apiUrl) {
+        const sourceDomain = CCTP_DOMAIN_IDS[fromChain];
+        // Circle V2 API: GET /v2/messages/{sourceDomain}?transactionHash={hash}
+        // Note: messageHash and txHash can both be used; we'll use messageHash for direct lookup
+        const url = `${apiUrl}/v2/messages/${sourceDomain}/${messageHash}`;
+        for (let attempt = 0; attempt < MAX_ATTESTATION_POLLS; attempt++) {
+            let response;
+            try {
+                const res = await fetch(url, {
+                    headers: { 'Accept': 'application/json' },
+                });
+                if (!res.ok) {
+                    if (res.status === 404) {
+                        // Not yet indexed — keep polling
+                        await this.sleep(ATTESTATION_POLL_INTERVAL_MS);
+                        continue;
+                    }
+                    const body = await res.text().catch(() => '');
+                    throw new BridgeError('ATTESTATION_ERROR', `Circle API returned HTTP ${res.status}: ${body}. ` +
+                        `URL: ${url}. Check Circle API status at status.circle.com.`);
+                }
+                response = await res.json();
+            }
+            catch (err) {
+                if (err instanceof BridgeError)
+                    throw err;
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new BridgeError('ATTESTATION_ERROR', `Failed to reach Circle IRIS API: ${msg}. ` +
+                    `Ensure network connectivity and try again.`);
+            }
+            if (response.status === 'complete' && response.attestation) {
+                return response.attestation;
+            }
+            if (response.status === 'error') {
+                throw new BridgeError('ATTESTATION_ERROR', `Circle attestation failed: ${response.error ?? 'unknown error'}. ` +
+                    `Message hash: ${messageHash}. Contact Circle support if this persists.`);
+            }
+            // Status is 'pending_confirmations' — keep waiting
+            await this.sleep(ATTESTATION_POLL_INTERVAL_MS);
+        }
+        throw new BridgeError('ATTESTATION_TIMEOUT', `Attestation not received after ${MAX_ATTESTATION_POLLS} attempts ` +
+            `(${(MAX_ATTESTATION_POLLS * ATTESTATION_POLL_INTERVAL_MS) / 1000}s). ` +
+            `Message hash: ${messageHash}. You can retry by calling mint() manually with the message bytes.`);
+    }
+    /**
+     * Call MessageTransmitterV2.receiveMessage on the destination chain to mint USDC.
+     */
+    async receiveMessage(messageBytes, attestation, toChain, destinationRpcUrl) {
+        const account = this.walletClient.account;
+        const transmitterAddress = MESSAGE_TRANSMITTER_V2[toChain];
+        const destChain = VIEM_CHAINS[toChain];
+        const destPublicClient = createPublicClient({
+            chain: destChain,
+            transport: http(destinationRpcUrl),
+        });
+        const transmitter = getContract({
+            address: transmitterAddress,
+            abi: MessageTransmitterV2Abi,
+            client: { public: destPublicClient, wallet: this.walletClient },
+        });
+        let mintTxHash;
+        try {
+            mintTxHash = await transmitter.write.receiveMessage([messageBytes, attestation], { account, chain: destChain });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new BridgeError('MINT_FAILED', `CCTP receiveMessage failed on ${toChain}: ${msg}. ` +
+                `Ensure the wallet has sufficient ETH for gas on ${toChain}.`);
+        }
+        const mintReceipt = await destPublicClient.waitForTransactionReceipt({
+            hash: mintTxHash,
+        });
+        if (mintReceipt.status !== 'success') {
+            throw new BridgeError('MINT_FAILED', `receiveMessage reverted on ${toChain} (tx: ${mintTxHash}). ` +
+                `The message may have already been used (nonce replay). ` +
+                `Check ${toChain} block explorer for details.`);
+        }
+        return mintTxHash;
+    }
+    // ─── Validation ───
+    validateBridgeParams(amount, toChain) {
+        if (amount <= 0n) {
+            throw new BridgeError('INVALID_AMOUNT', `Bridge amount must be greater than 0. ` +
+                `Received: ${amount}. Amount is in USDC base units (6 decimals): 1 USDC = 1_000_000.`);
+        }
+        if (!(toChain in CCTP_DOMAIN_IDS)) {
+            const supported = Object.keys(CCTP_DOMAIN_IDS).join(', ');
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Chain '${toChain}' is not supported. Supported chains: ${supported}. ` +
+                `To add a new chain, submit a PR to the agentwallet-sdk repository.`);
+        }
+        if (toChain === this.fromChain) {
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Source and destination chains must be different. ` +
+                `Both are set to '${toChain}'. Choose a different destination chain.`);
+        }
+    }
+    // ─── Utilities ───
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// ─── BridgeError ───
+/**
+ * Structured bridge error with actionable messages and error codes.
+ */
+export class BridgeError extends Error {
+    constructor(code, message) {
+        super(`[BridgeModule:${code}] ${message}`);
+        this.code = code;
+        this.name = 'BridgeError';
+    }
+}
+// ─── Factory Helper ───
+/**
+ * Create a BridgeModule from an existing AgentWallet object.
+ * Convenience wrapper for wallet.bridge() integration.
+ *
+ * @example
+ * ```ts
+ * const bridge = createBridge(wallet.walletClient, 'base', { rpcUrl: BASE_RPC });
+ * const result = await bridge.bridge(5_000_000n, 'optimism');
+ * ```
+ */
+export function createBridge(walletClient, fromChain = 'base', options = {}) {
+    return new BridgeModule(walletClient, fromChain, options);
+}
+export { CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, USDC_CONTRACT, TOKEN_MESSENGER_V2, MESSAGE_TRANSMITTER_V2, FINALITY_THRESHOLD, };
+//# sourceMappingURL=client.js.map

package/dist/bridge/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/bridge/client.ts"],"names":[],"mappings":"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"}

package/dist/bridge/index.d.ts

@@ -0,0 +1,4 @@
+export { BridgeModule, BridgeError, createBridge, CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, USDC_CONTRACT, TOKEN_MESSENGER_V2, MESSAGE_TRANSMITTER_V2, FINALITY_THRESHOLD, } from './client.js';
+export type { BridgeChain, BridgeOptions, BurnResult, BridgeResult, AttestationResponse, AttestationStatus, } from './types.js';
+export { TokenMessengerV2Abi, MessageTransmitterV2Abi, ERC20BridgeAbi } from './abis.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,4 @@
+// [MAX-ADDED] Bridge Module — CCTP V2 Cross-Chain USDC Bridge for AgentWallet
+export { BridgeModule, BridgeError, createBridge, CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, USDC_CONTRACT, TOKEN_MESSENGER_V2, MESSAGE_TRANSMITTER_V2, FINALITY_THRESHOLD, } from './client.js';
+export { TokenMessengerV2Abi, MessageTransmitterV2Abi, ERC20BridgeAbi } from './abis.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAWrB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/bridge/types.d.ts

@@ -0,0 +1,107 @@
+import type { Address, Hash, Hex } from 'viem';
+/** Supported bridge destination chains */
+export type BridgeChain = 'ethereum' | 'optimism' | 'base' | 'arbitrum';
+/** CCTP V2 domain IDs (Circle's internal chain identifiers) */
+export declare const CCTP_DOMAIN_IDS: Record<BridgeChain, number>;
+/** EVM chain IDs for supported bridge chains */
+export declare const BRIDGE_CHAIN_IDS: Record<BridgeChain, number>;
+/** USDC contract addresses per chain */
+export declare const USDC_CONTRACT: Record<BridgeChain, Address>;
+/**
+ * CCTP V2 TokenMessengerV2 addresses (source chain — where burn happens).
+ * Base address confirmed per task spec. Other chains are CCTP V2 deployment addresses
+ * (verify against https://developers.circle.com/stablecoins/cctp-protocol-contract before mainnet use).
+ */
+export declare const TOKEN_MESSENGER_V2: Record<BridgeChain, Address>;
+/** CCTP V2 MessageTransmitterV2 addresses (destination chain — where mint happens) */
+export declare const MESSAGE_TRANSMITTER_V2: Record<BridgeChain, Address>;
+/**
+ * CCTP V2 minFinalityThreshold values.
+ * - FAST (0): ~12 seconds. Circle fast attestation. Use for most agent workflows.
+ * - FINALIZED (1000): Full on-chain finality. Use for large amounts.
+ */
+export declare const FINALITY_THRESHOLD: {
+    readonly FAST: 0;
+    readonly FINALIZED: 1000;
+};
+/** Circle IRIS attestation API base URL */
+export declare const CIRCLE_ATTESTATION_API = "https://iris-api.circle.com";
+/** Max attestation polling attempts before timeout */
+export declare const MAX_ATTESTATION_POLLS = 60;
+/** Polling interval for attestation (milliseconds) */
+export declare const ATTESTATION_POLL_INTERVAL_MS = 5000;
+/** Options for a bridge operation */
+export interface BridgeOptions {
+    /**
+     * Minimum finality threshold.
+     * - 0 (FAST): ~12 seconds using Circle's fast attestation
+     * - 1000 (FINALIZED): Full finality (slower but more secure)
+     * @default 0 (fast finality)
+     */
+    minFinalityThreshold?: number;
+    /**
+     * Maximum fee in USDC base units (6 decimals).
+     * Circle uses this as an upper bound for bridging fee.
+     * @default 0n (no max fee limit)
+     */
+    maxFee?: bigint;
+    /**
+     * Optional override for the destination address.
+     * Defaults to the same address as the source wallet.
+     */
+    destinationAddress?: Address;
+    /**
+     * RPC URL for the destination chain.
+     * Required when minting on destination.
+     */
+    destinationRpcUrl?: string;
+    /**
+     * Circle attestation API override (for testing).
+     */
+    attestationApiUrl?: string;
+}
+/** Result of a bridge.burn() operation */
+export interface BurnResult {
+    /** Transaction hash of the burn tx on source chain */
+    burnTxHash: Hash;
+    /** CCTP nonce for tracking */
+    nonce: bigint;
+    /** The CCTP message hash (used to fetch attestation) */
+    messageHash: Hex;
+    /** Raw CCTP message bytes emitted in the MessageSent event */
+    messageBytes: Hex;
+    /** Source chain domain ID */
+    sourceDomain: number;
+    /** Destination chain domain ID */
+    destinationDomain: number;
+}
+/** Circle attestation status */
+export type AttestationStatus = 'pending_confirmations' | 'complete' | 'error';
+/** Circle IRIS API response for an attestation */
+export interface AttestationResponse {
+    status: AttestationStatus;
+    attestation: Hex | null;
+    error?: string;
+}
+/** Result of the full bridge() operation */
+export interface BridgeResult {
+    /** Transaction hash of the burn on source chain */
+    burnTxHash: Hash;
+    /** Transaction hash of the mint on destination chain */
+    mintTxHash: Hash;
+    /** Amount bridged in USDC base units (6 decimals) */
+    amount: bigint;
+    /** Source chain name */
+    fromChain: BridgeChain;
+    /** Destination chain name */
+    toChain: BridgeChain;
+    /** Recipient address on destination chain */
+    recipient: Address;
+    /** CCTP nonce */
+    nonce: bigint;
+    /** Total time in milliseconds from burn to mint */
+    elapsedMs: number;
+}
+/** Error codes for actionable bridge error messages */
+export type BridgeErrorCode = 'UNSUPPORTED_CHAIN' | 'INSUFFICIENT_ALLOWANCE' | 'INSUFFICIENT_BALANCE' | 'BURN_FAILED' | 'ATTESTATION_TIMEOUT' | 'ATTESTATION_ERROR' | 'MINT_FAILED' | 'INVALID_AMOUNT' | 'NO_WALLET_CLIENT';
+//# sourceMappingURL=types.d.ts.map

package/dist/bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAI/C,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAK9C,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAK/C,CAAC;AAIX,wCAAwC;AACxC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAK7C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAKlD,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAKtD,CAAC;AAIX;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAIX,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AAEpE,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAIlD,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,UAAU,EAAE,IAAI,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,EAAE,GAAG,CAAC;IACjB,8DAA8D;IAC9D,YAAY,EAAE,GAAG,CAAC;IAClB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gCAAgC;AAChC,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/E,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,GAAG,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,UAAU,EAAE,IAAI,CAAC;IACjB,wDAAwD;IACxD,UAAU,EAAE,IAAI,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,SAAS,EAAE,WAAW,CAAC;IACvB,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,wBAAwB,GACxB,sBAAsB,GACtB,aAAa,GACb,qBAAqB,GACrB,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,kBAAkB,CAAC"}

package/dist/bridge/types.js

@@ -0,0 +1,58 @@
+/** CCTP V2 domain IDs (Circle's internal chain identifiers) */
+export const CCTP_DOMAIN_IDS = {
+    ethereum: 0,
+    optimism: 2,
+    arbitrum: 3,
+    base: 6,
+};
+/** EVM chain IDs for supported bridge chains */
+export const BRIDGE_CHAIN_IDS = {
+    ethereum: 1,
+    optimism: 10,
+    arbitrum: 42161,
+    base: 8453,
+};
+// ─── CCTP V2 Contract Addresses ───
+/** USDC contract addresses per chain */
+export const USDC_CONTRACT = {
+    base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    ethereum: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    optimism: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    arbitrum: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+};
+/**
+ * CCTP V2 TokenMessengerV2 addresses (source chain — where burn happens).
+ * Base address confirmed per task spec. Other chains are CCTP V2 deployment addresses
+ * (verify against https://developers.circle.com/stablecoins/cctp-protocol-contract before mainnet use).
+ */
+export const TOKEN_MESSENGER_V2 = {
+    base: '0x8FD3bCdFd9987D7F3C86b67D2f25Dd4e82C80b2B',
+    ethereum: '0xbd3fa81b58ba92a82136038b25adec7066af3155',
+    optimism: '0x28Bc09B4EFdA1E348a97cA91F16CC43adFF2f50d',
+    arbitrum: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
+};
+/** CCTP V2 MessageTransmitterV2 addresses (destination chain — where mint happens) */
+export const MESSAGE_TRANSMITTER_V2 = {
+    base: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
+    ethereum: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
+    optimism: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
+    arbitrum: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
+};
+// ─── CCTP V2 Finality Thresholds ───
+/**
+ * CCTP V2 minFinalityThreshold values.
+ * - FAST (0): ~12 seconds. Circle fast attestation. Use for most agent workflows.
+ * - FINALIZED (1000): Full on-chain finality. Use for large amounts.
+ */
+export const FINALITY_THRESHOLD = {
+    FAST: 0,
+    FINALIZED: 1000,
+};
+// ─── Circle Attestation API ───
+/** Circle IRIS attestation API base URL */
+export const CIRCLE_ATTESTATION_API = 'https://iris-api.circle.com';
+/** Max attestation polling attempts before timeout */
+export const MAX_ATTESTATION_POLLS = 60;
+/** Polling interval for attestation (milliseconds) */
+export const ATTESTATION_POLL_INTERVAL_MS = 5000;
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAQA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;CACC,CAAC;AAEX,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,IAAI;CACF,CAAC;AAEX,qCAAqC;AAErC,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CAC9C,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CAC9C,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CAC9C,CAAC;AAEX,sCAAsC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,IAAI;CACP,CAAC;AAEX,iCAAiC;AAEjC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEpE,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,sDAAsD;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAK,CAAC"}