agentwallet-sdk 5.0.0 → 5.0.1

package/dist/bridge/client.js

@@ -0,0 +1,230 @@
+// BridgeModule — CCTP V2 cross-chain USDC bridge for AgentWallet
+// Non-custodial: all signing is done locally via the agent's WalletClient.
+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';
+const VIEM_CHAINS = { base, ethereum: mainnet, optimism, arbitrum };
+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),
+        });
+    }
+    async bridge(amount, toChain, options = {}) {
+        const startMs = Date.now();
+        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;
+        await this.approveUsdc(amount);
+        const burnResult = await this.depositForBurn(amount, toChain, recipient, minFinalityThreshold, maxFee);
+        const attestation = await this.pollForAttestation(burnResult.messageHash, this.fromChain, attestationApiUrl);
+        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,
+        };
+    }
+    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);
+    }
+    async waitForAttestation(messageHash, apiUrl = CIRCLE_ATTESTATION_API) {
+        return this.pollForAttestation(messageHash, this.fromChain, apiUrl);
+    }
+    async mint(messageBytes, attestation, toChain, destinationRpcUrl) {
+        return this.receiveMessage(messageBytes, attestation, toChain, destinationRpcUrl);
+    }
+    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]);
+    }
+    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]]);
+    }
+    async approveUsdc(amount) {
+        const account = this.walletClient.account;
+        const spender = TOKEN_MESSENGER_V2[this.fromChain];
+        const usdcAddress = USDC_CONTRACT[this.fromChain];
+        const usdc = getContract({ address: usdcAddress, abi: ERC20BridgeAbi, client: this.publicClient });
+        const currentAllowance = await usdc.read.allowance([account.address, spender]);
+        if (currentAllowance >= amount)
+            return;
+        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}).`);
+        }
+    }
+    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];
+        const mintRecipient = pad(recipient, { size: 32 });
+        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}.`);
+        }
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash: burnTxHash });
+        if (receipt.status !== 'success') {
+            throw new BridgeError('BURN_FAILED', `depositForBurn transaction reverted (tx: ${burnTxHash}).`);
+        }
+        const { messageBytes, messageHash, nonce } = this.extractMessageSent(receipt);
+        return { burnTxHash, nonce, messageHash, messageBytes, sourceDomain: CCTP_DOMAIN_IDS[this.fromChain], destinationDomain };
+    }
+    extractMessageSent(receipt) {
+        const MESSAGE_SENT_TOPIC = '0x8c5261668696ce22758910d05bab8f186d6eb247ceac2af2e82c7dc17669b036';
+        for (const log of receipt.logs) {
+            if (log.topics[0]?.toLowerCase() === MESSAGE_SENT_TOPIC.toLowerCase()) {
+                const rawData = log.data;
+                if (rawData.length < 130)
+                    continue;
+                const dataHex = rawData.slice(2);
+                const lengthHex = dataHex.slice(64, 128);
+                const messageLength = parseInt(lengthHex, 16);
+                if (messageLength === 0)
+                    continue;
+                const messageBytesHex = dataHex.slice(128, 128 + messageLength * 2);
+                const messageBytes = ('0x' + messageBytesHex);
+                const messageHash = keccak256(messageBytes);
+                const nonceBytesHex = messageBytesHex.slice(24, 40);
+                const nonce = BigInt('0x' + nonceBytesHex);
+                return { messageBytes, messageHash, nonce };
+            }
+        }
+        throw new BridgeError('BURN_FAILED', 'Could not find MessageSent event in burn transaction receipt.');
+    }
+    async pollForAttestation(messageHash, fromChain, apiUrl) {
+        const sourceDomain = CCTP_DOMAIN_IDS[fromChain];
+        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) {
+                        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}.`);
+                }
+                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}.`);
+            }
+            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'}.`);
+            }
+            await this.sleep(ATTESTATION_POLL_INTERVAL_MS);
+        }
+        throw new BridgeError('ATTESTATION_TIMEOUT', `Attestation not received after ${MAX_ATTESTATION_POLLS} attempts. Message hash: ${messageHash}.`);
+    }
+    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}.`);
+        }
+        const mintReceipt = await destPublicClient.waitForTransactionReceipt({ hash: mintTxHash });
+        if (mintReceipt.status !== 'success') {
+            throw new BridgeError('MINT_FAILED', `receiveMessage reverted on ${toChain} (tx: ${mintTxHash}).`);
+        }
+        return mintTxHash;
+    }
+    validateBridgeParams(amount, toChain) {
+        if (amount <= 0n) {
+            throw new BridgeError('INVALID_AMOUNT', `Bridge amount must be greater than 0. Received: ${amount}.`);
+        }
+        if (!(toChain in CCTP_DOMAIN_IDS)) {
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Chain '${toChain}' is not supported.`);
+        }
+        if (toChain === this.fromChain) {
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Source and destination chains must be different.`);
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+export class BridgeError extends Error {
+    constructor(code, message) {
+        super(`[BridgeModule:${code}] ${message}`);
+        this.code = code;
+        this.name = 'BridgeError';
+    }
+}
+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":"AAAA,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,YAAY,EACvC,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAChD,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,GAC/D,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,GAC7F,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,3 @@
+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,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,YAAY,EACvC,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAChD,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,GAC/D,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/bridge/types.d.ts

@@ -0,0 +1,69 @@
+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).
+ */
+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.
+ * - FINALIZED (1000): Full on-chain finality.
+ */
+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 {
+    minFinalityThreshold?: number;
+    maxFee?: bigint;
+    destinationAddress?: Address;
+    destinationRpcUrl?: string;
+    attestationApiUrl?: string;
+}
+/** Result of a bridge.burn() operation */
+export interface BurnResult {
+    burnTxHash: Hash;
+    nonce: bigint;
+    messageHash: Hex;
+    messageBytes: Hex;
+    sourceDomain: number;
+    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 {
+    burnTxHash: Hash;
+    mintTxHash: Hash;
+    amount: bigint;
+    fromChain: BridgeChain;
+    toChain: BridgeChain;
+    recipient: Address;
+    nonce: bigint;
+    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":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE/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,CAKvD,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAKxD,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAKtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAK3D,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAK/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AACpE,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,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,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,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,53 @@
+/** 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,
+};
+/** 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).
+ */
+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 minFinalityThreshold values.
+ * - FAST (0): ~12 seconds. Circle fast attestation.
+ * - FINALIZED (1000): Full on-chain finality.
+ */
+export const FINALITY_THRESHOLD = {
+    FAST: 0,
+    FINALIZED: 1000,
+};
+/** 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":"AAKA,+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;CACR,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,IAAI;CACX,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,IAAI;CACP,CAAC;AAEX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AACpE,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,sDAAsD;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC"}

package/dist/bridge/unified.d.ts

@@ -0,0 +1,101 @@
+import type { WalletClient } from 'viem';
+import type { Keypair } from '@solana/web3.js';
+import { BridgeError } from './client.js';
+import type { BridgeChain, BridgeResult } from './types.js';
+import { type CCTPSupportedChain, type BridgeQuote, CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, BRIDGE_RPC_URLS, calcBridgeFee } from './types.js';
+import { SolanaBridgeError } from '../solana/bridge.js';
+export interface UnifiedBridgeConfig {
+    /** EVM wallet client (required for any EVM source chain) */
+    evmSigner?: WalletClient;
+    /** Solana keypair (required when Solana is source) */
+    solanaWallet?: Keypair;
+    /** Solana RPC URL (default: mainnet-beta public) */
+    solanaRpcUrl?: string;
+    /** Override EVM RPC URLs per chain */
+    evmRpcOverrides?: Partial<Record<BridgeChain, string>>;
+    /** Circle attestation API override */
+    attestationApiUrl?: string;
+    /** Platform fee wallet address (future: fee collection) */
+    feeWallet?: string;
+}
+export interface UnifiedBridgeParams {
+    /** USDC amount in base units (6 decimals). 1 USDC = 1_000_000 */
+    amount: bigint;
+    /** Source chain */
+    sourceChain: CCTPSupportedChain;
+    /** Destination chain */
+    destinationChain: CCTPSupportedChain;
+    /** Recipient address (hex for EVM, base58 for Solana destination) */
+    destinationAddress: string;
+    /** Finality: 0 = fast (~20s), 1000 = finalized (~15min) */
+    minFinalityThreshold?: number;
+    /** Apply 0.1% platform fee (default: true) */
+    applyPlatformFee?: boolean;
+    /** Override destination RPC URL */
+    destinationRpcUrl?: string;
+}
+export type { BridgeResult, BridgeQuote, CCTPSupportedChain };
+/**
+ * UnifiedBridge — Cross-chain USDC bridge across all 17 CCTP V2 supported chains.
+ *
+ * Routing:
+ *   - EVM → EVM:     BridgeModule (approve → burn → attest → mint)
+ *   - EVM → Solana:  BridgeModule burn + SolanaCCTPBridge receive
+ *   - Solana → EVM:  SolanaCCTPBridge burn + EVM receiveMessage
+ *   - Solana → Solana: throws (use native Solana transfer instead)
+ *
+ * @example
+ * ```ts
+ * import { UnifiedBridge } from 'agentwallet-sdk';
+ * import { createWalletClient } from 'viem';
+ *
+ * const bridge = new UnifiedBridge({ evmSigner });
+ *
+ * // Bridge 1 USDC from Base to Polygon
+ * const result = await bridge.bridge({
+ *   amount: 1_000_000n,
+ *   sourceChain: 'base',
+ *   destinationChain: 'polygon',
+ *   destinationAddress: '0x...',
+ * });
+ * console.log(bridge.getSupportedChains()); // 17 chains!
+ * ```
+ */
+export declare class UnifiedBridge {
+    private readonly config;
+    private readonly solanaConnection;
+    constructor(config?: UnifiedBridgeConfig);
+    /**
+     * Bridge USDC between any two CCTP V2 supported chains.
+     * Routes automatically based on source/destination chain types.
+     */
+    bridge(params: UnifiedBridgeParams): Promise<BridgeResult>;
+    /**
+     * Get all supported chains (16 EVM + Solana = 17 total).
+     */
+    getSupportedChains(): CCTPSupportedChain[];
+    /**
+     * Get a bridge quote: fee breakdown + estimated time.
+     */
+    getQuote(params: {
+        amount: bigint;
+        sourceChain: CCTPSupportedChain;
+        destinationChain: CCTPSupportedChain;
+    }): BridgeQuote;
+    /**
+     * Check if a route is supported.
+     */
+    isRouteSupported(source: CCTPSupportedChain, destination: CCTPSupportedChain): boolean;
+    private bridgeEvmToEvm;
+    private bridgeSolanaToEvm;
+    private bridgeEvmToSolana;
+    private validateParams;
+    /**
+     * Convert a Solana base58 address to a 32-byte hex string for EVM mintRecipient.
+     * Per Circle docs: hex-encoded USDC token account address.
+     */
+    private solanaAddressToHex;
+}
+export { BridgeError, SolanaBridgeError };
+export { CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, BRIDGE_RPC_URLS, calcBridgeFee, };
+//# sourceMappingURL=unified.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../../src/bridge/unified.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAEf,aAAa,EAGd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI1E,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,EAAE,kBAAkB,CAAC;IAChC,wBAAwB;IACxB,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAI9D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;gBAElC,MAAM,GAAE,mBAAwB;IAU5C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IA4DhE;;OAEG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,kBAAkB,CAAC;QAChC,gBAAgB,EAAE,kBAAkB,CAAC;KACtC,GAAG,WAAW;IAuBf;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,GAAG,OAAO;YAQxE,cAAc;YAmCd,iBAAiB;YA4EjB,iBAAiB;IAoF/B,OAAO,CAAC,cAAc;IAsCtB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAkB3B;AAID,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,CAAC"}