agentwallet-sdk 2.5.0 → 3.0.0

package/dist/bridge/types.d.ts

@@ -1,24 +1,73 @@
 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 */
+/**
+ * All EVM chains supported by CCTP V2 (16 chains).
+ * Solana is non-EVM and handled separately via SolanaCCTPBridge.
+ */
+export type BridgeChain = 'ethereum' | 'avalanche' | 'optimism' | 'arbitrum' | 'base' | 'polygon' | 'unichain' | 'linea' | 'codex' | 'sonic' | 'worldchain' | 'sei' | 'xdc' | 'hyperevm' | 'ink' | 'plume';
+/** Solana — non-EVM, handled by SolanaCCTPBridge */
+export type CCTPSolanaChain = 'solana';
+/** All CCTP V2 supported chains: 16 EVM + Solana */
+export type CCTPSupportedChain = BridgeChain | CCTPSolanaChain;
+/**
+ * CCTP V2 domain IDs — Circle's internal chain identifiers.
+ * Source: https://developers.circle.com/cctp/concepts/supported-chains-and-domains
+ * These are used in smart contract calls and the attestation API.
+ */
+export declare const CCTP_DOMAIN_IDS: Record<CCTPSupportedChain, number>;
+/** EVM chain IDs for all supported bridge chains */
 export declare const BRIDGE_CHAIN_IDS: Record<BridgeChain, number>;
-/** USDC contract addresses per chain */
+/** Default public RPC URLs — replace with paid provider in production */
+export declare const BRIDGE_RPC_URLS: Record<BridgeChain, string>;
+/**
+ * USDC contract addresses per chain — official Circle deployments.
+ * Source: https://developers.circle.com/stablecoins/usdc-contract-addresses
+ */
 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).
+ * CCTP V2 TokenMessengerV2 addresses — same address on all EVM chains.
+ * Source: https://developers.circle.com/cctp/references/contract-addresses
+ * Verified: 0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d (all chains)
  */
 export declare const TOKEN_MESSENGER_V2: Record<BridgeChain, Address>;
-/** CCTP V2 MessageTransmitterV2 addresses (destination chain — where mint happens) */
+/**
+ * CCTP V2 MessageTransmitterV2 addresses — same address on all EVM chains.
+ * Source: https://developers.circle.com/cctp/references/contract-addresses
+ * Verified: 0x81D40F21F12A8F0E3252Bccb954D722d4c464B64 (all chains)
+ */
 export declare const MESSAGE_TRANSMITTER_V2: Record<BridgeChain, Address>;
+/**
+ * Solana CCTP V2 program addresses (domain 5).
+ * Source: https://developers.circle.com/cctp/references/solana-programs
+ */
+export declare const SOLANA_CCTP_PROGRAMS: {
+    /** Handles incoming messages + mints USDC on Solana */
+    readonly MESSAGE_TRANSMITTER_V2: "CCTPV2Sm4AdWt5296sk4P66VBZ7bEhcARwFaaS9YPbeC";
+    /** Handles burn + combined TokenMessenger + TokenMinter on Solana */
+    readonly TOKEN_MESSENGER_MINTER_V2: "CCTPV2vPZJS2u2BBsUoscuikbYjnpFmbFsvVuJdgUMQe";
+};
+/** Solana USDC mint address (mainnet) */
+export declare const SOLANA_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+/** Solana CCTP domain ID */
+export declare const SOLANA_CCTP_DOMAIN = 5;
+/**
+ * Platform bridge fee: 0.1% (10 basis points).
+ * Applied on source chain before bridging. Circle CCTP itself is feeless.
+ */
+export declare const PLATFORM_FEE_BPS = 10n;
+export declare const PLATFORM_FEE_DENOMINATOR = 10000n;
+/**
+ * Calculate 0.1% platform fee for a given bridge amount.
+ * @param amount - USDC amount in base units (6 decimals)
+ */
+export declare function calcBridgeFee(amount: bigint): bigint;
+/**
+ * Calculate the actual bridged amount after platform fee deduction.
+ */
+export declare function calcAmountAfterFee(amount: bigint): bigint;
 /**
  * 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.
+ * - FAST (0): ~8–20 seconds. Circle fast attestation. Recommended for agents.
+ * - FINALIZED (1000): Full on-chain finality. Use for large amounts (>$10k).
  */
 export declare const FINALITY_THRESHOLD: {
     readonly FAST: 0;
@@ -34,8 +83,8 @@ export declare const ATTESTATION_POLL_INTERVAL_MS = 5000;
 export interface BridgeOptions {
     /**
      * Minimum finality threshold.
-     * - 0 (FAST): ~12 seconds using Circle's fast attestation
-     * - 1000 (FINALIZED): Full finality (slower but more secure)
+     * - 0 (FAST): ~8–20 seconds using Circle's fast attestation
+     * - 1000 (FINALIZED): Full finality (slower but more secure for large amounts)
      * @default 0 (fast finality)
      */
     minFinalityThreshold?: number;
@@ -59,6 +108,11 @@ export interface BridgeOptions {
      * Circle attestation API override (for testing).
      */
     attestationApiUrl?: string;
+    /**
+     * Whether to apply the 0.1% platform fee.
+     * @default true
+     */
+    applyPlatformFee?: boolean;
 }
 /** Result of a bridge.burn() operation */
 export interface BurnResult {
@@ -83,7 +137,7 @@ export interface AttestationResponse {
     attestation: Hex | null;
     error?: string;
 }
-/** Result of the full bridge() operation */
+/** Result of the full bridge() operation (EVM chains) */
 export interface BridgeResult {
     /** Transaction hash of the burn on source chain */
     burnTxHash: Hash;
@@ -91,17 +145,44 @@ export interface BridgeResult {
     mintTxHash: Hash;
     /** Amount bridged in USDC base units (6 decimals) */
     amount: bigint;
+    /** Platform fee collected (0.1% of amount) */
+    platformFee: bigint;
     /** Source chain name */
-    fromChain: BridgeChain;
+    fromChain: CCTPSupportedChain;
     /** Destination chain name */
-    toChain: BridgeChain;
+    toChain: CCTPSupportedChain;
     /** Recipient address on destination chain */
-    recipient: Address;
+    recipient: string;
     /** CCTP nonce */
     nonce: bigint;
     /** Total time in milliseconds from burn to mint */
     elapsedMs: number;
 }
+/** Quote for a bridge operation */
+export interface BridgeQuote {
+    /** Input amount (USDC, 6 decimals) */
+    inputAmount: bigint;
+    /** Platform fee (0.1%) */
+    platformFee: bigint;
+    /** Amount that will arrive at destination */
+    outputAmount: bigint;
+    /** Source chain */
+    fromChain: CCTPSupportedChain;
+    /** Destination chain */
+    toChain: CCTPSupportedChain;
+    /** Estimated time in seconds */
+    estimatedTimeSeconds: number;
+    /** Whether fast transfer is available on the source chain */
+    fastTransferAvailable: boolean;
+}
 /** 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';
+export type BridgeErrorCode = 'UNSUPPORTED_CHAIN' | 'UNSUPPORTED_ROUTE' | 'INSUFFICIENT_ALLOWANCE' | 'INSUFFICIENT_BALANCE' | 'BURN_FAILED' | 'ATTESTATION_TIMEOUT' | 'ATTESTATION_ERROR' | 'MINT_FAILED' | 'INVALID_AMOUNT' | 'NO_WALLET_CLIENT' | 'NO_SOLANA_WALLET' | 'SAME_CHAIN';
+/**
+ * Chains that support CCTP V2 Fast Transfer (8–20 second attestation).
+ * Chains NOT listed here use Standard Transfer (up to ~15 min on Ethereum).
+ * Source: https://developers.circle.com/cctp/concepts/supported-chains-and-domains
+ */
+export declare const FAST_TRANSFER_CHAINS: Set<CCTPSupportedChain>;
+/** Get estimated bridge time in seconds for a given source chain */
+export declare function getEstimatedBridgeSeconds(chain: CCTPSupportedChain): number;
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/bridge/types.js

@@ -1,48 +1,175 @@
-/** CCTP V2 domain IDs (Circle's internal chain identifiers) */
+// ─── CCTP Domain IDs ───
+/**
+ * CCTP V2 domain IDs — Circle's internal chain identifiers.
+ * Source: https://developers.circle.com/cctp/concepts/supported-chains-and-domains
+ * These are used in smart contract calls and the attestation API.
+ */
 export const CCTP_DOMAIN_IDS = {
     ethereum: 0,
+    avalanche: 1,
     optimism: 2,
     arbitrum: 3,
+    solana: 5,
     base: 6,
+    polygon: 7,
+    unichain: 10,
+    linea: 11,
+    codex: 12,
+    sonic: 13,
+    worldchain: 14,
+    sei: 16,
+    xdc: 18,
+    hyperevm: 19,
+    ink: 21,
+    plume: 22,
 };
-/** EVM chain IDs for supported bridge chains */
+/** EVM chain IDs for all supported bridge chains */
 export const BRIDGE_CHAIN_IDS = {
     ethereum: 1,
+    avalanche: 43114,
     optimism: 10,
     arbitrum: 42161,
     base: 8453,
+    polygon: 137,
+    unichain: 130,
+    linea: 59144,
+    codex: 81224, // Codex mainnet chain ID — verified at thirdweb.com/codex
+    sonic: 146,
+    worldchain: 480,
+    sei: 1329, // Sei EVM (Pacific-1 mainnet)
+    xdc: 50,
+    hyperevm: 999, // HyperLiquid EVM mainnet chain ID
+    ink: 57073,
+    plume: 98866, // Plume mainnet chain ID
+};
+/** Default public RPC URLs — replace with paid provider in production */
+export const BRIDGE_RPC_URLS = {
+    ethereum: 'https://cloudflare-eth.com',
+    avalanche: 'https://api.avax.network/ext/bc/C/rpc',
+    optimism: 'https://mainnet.optimism.io',
+    arbitrum: 'https://arb1.arbitrum.io/rpc',
+    base: 'https://mainnet.base.org',
+    polygon: 'https://polygon-rpc.com',
+    unichain: 'https://mainnet.unichain.org',
+    linea: 'https://rpc.linea.build',
+    codex: 'https://rpc.codex.xyz',
+    sonic: 'https://rpc.soniclabs.com',
+    worldchain: 'https://worldchain-mainnet.g.alchemy.com/public',
+    sei: 'https://evm-rpc.sei-apis.com',
+    xdc: 'https://rpc.xinfin.network',
+    hyperevm: 'https://rpc.hyperliquid.xyz/evm',
+    ink: 'https://rpc-gel.inkonchain.com',
+    plume: 'https://rpc.plume.org',
 };
 // ─── CCTP V2 Contract Addresses ───
-/** USDC contract addresses per chain */
+/**
+ * USDC contract addresses per chain — official Circle deployments.
+ * Source: https://developers.circle.com/stablecoins/usdc-contract-addresses
+ */
 export const USDC_CONTRACT = {
-    base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
     ethereum: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    avalanche: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
     optimism: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
     arbitrum: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    polygon: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    unichain: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
+    linea: '0x176211869cA2b568f2A7D4EE941E073a821EE1ff',
+    codex: '0xd996633a415985DBd7D6D12f4A4343E31f5037cf',
+    sonic: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894',
+    worldchain: '0x79A02482A880bCe3F13E09da970dC34dB4cD24D1',
+    sei: '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392',
+    xdc: '0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1',
+    hyperevm: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+    ink: '0x2D270e6886d130D724215A266106e6832161EAEd',
+    plume: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
 };
 /**
- * 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).
+ * CCTP V2 TokenMessengerV2 addresses — same address on all EVM chains.
+ * Source: https://developers.circle.com/cctp/references/contract-addresses
+ * Verified: 0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d (all chains)
  */
 export const TOKEN_MESSENGER_V2 = {
-    base: '0x8FD3bCdFd9987D7F3C86b67D2f25Dd4e82C80b2B',
-    ethereum: '0xbd3fa81b58ba92a82136038b25adec7066af3155',
-    optimism: '0x28Bc09B4EFdA1E348a97cA91F16CC43adFF2f50d',
-    arbitrum: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
+    ethereum: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    avalanche: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    optimism: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    arbitrum: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    base: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    polygon: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    unichain: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    linea: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    codex: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    sonic: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    worldchain: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    sei: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    xdc: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    hyperevm: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    ink: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+    plume: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
 };
-/** CCTP V2 MessageTransmitterV2 addresses (destination chain — where mint happens) */
+/**
+ * CCTP V2 MessageTransmitterV2 addresses — same address on all EVM chains.
+ * Source: https://developers.circle.com/cctp/references/contract-addresses
+ * Verified: 0x81D40F21F12A8F0E3252Bccb954D722d4c464B64 (all chains)
+ */
 export const MESSAGE_TRANSMITTER_V2 = {
-    base: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
-    ethereum: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
-    optimism: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
-    arbitrum: '0xE737e5cEBEEBa77EFE7EcB0cd46C6b9c1Ce1e8b3',
+    ethereum: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    avalanche: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    optimism: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    arbitrum: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    base: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    polygon: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    unichain: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    linea: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    codex: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    sonic: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    worldchain: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    sei: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    xdc: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    hyperevm: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    ink: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+    plume: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+};
+// ─── Solana CCTP V2 Program Addresses ───
+/**
+ * Solana CCTP V2 program addresses (domain 5).
+ * Source: https://developers.circle.com/cctp/references/solana-programs
+ */
+export const SOLANA_CCTP_PROGRAMS = {
+    /** Handles incoming messages + mints USDC on Solana */
+    MESSAGE_TRANSMITTER_V2: 'CCTPV2Sm4AdWt5296sk4P66VBZ7bEhcARwFaaS9YPbeC',
+    /** Handles burn + combined TokenMessenger + TokenMinter on Solana */
+    TOKEN_MESSENGER_MINTER_V2: 'CCTPV2vPZJS2u2BBsUoscuikbYjnpFmbFsvVuJdgUMQe',
 };
+/** Solana USDC mint address (mainnet) */
+export const SOLANA_USDC_MINT = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+/** Solana CCTP domain ID */
+export const SOLANA_CCTP_DOMAIN = 5;
+// ─── Platform Fee ───
+/**
+ * Platform bridge fee: 0.1% (10 basis points).
+ * Applied on source chain before bridging. Circle CCTP itself is feeless.
+ */
+export const PLATFORM_FEE_BPS = 10n; // 10 basis points = 0.1%
+export const PLATFORM_FEE_DENOMINATOR = 10000n;
+/**
+ * Calculate 0.1% platform fee for a given bridge amount.
+ * @param amount - USDC amount in base units (6 decimals)
+ */
+export function calcBridgeFee(amount) {
+    return (amount * PLATFORM_FEE_BPS) / PLATFORM_FEE_DENOMINATOR;
+}
+/**
+ * Calculate the actual bridged amount after platform fee deduction.
+ */
+export function calcAmountAfterFee(amount) {
+    return amount - calcBridgeFee(amount);
+}
 // ─── 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.
+ * - FAST (0): ~8–20 seconds. Circle fast attestation. Recommended for agents.
+ * - FINALIZED (1000): Full on-chain finality. Use for large amounts (>$10k).
  */
 export const FINALITY_THRESHOLD = {
     FAST: 0,
@@ -55,4 +182,26 @@ export const CIRCLE_ATTESTATION_API = 'https://iris-api.circle.com';
 export const MAX_ATTESTATION_POLLS = 60;
 /** Polling interval for attestation (milliseconds) */
 export const ATTESTATION_POLL_INTERVAL_MS = 5000;
+/**
+ * Chains that support CCTP V2 Fast Transfer (8–20 second attestation).
+ * Chains NOT listed here use Standard Transfer (up to ~15 min on Ethereum).
+ * Source: https://developers.circle.com/cctp/concepts/supported-chains-and-domains
+ */
+export const FAST_TRANSFER_CHAINS = new Set([
+    'ethereum',
+    'optimism',
+    'arbitrum',
+    'base',
+    'unichain',
+    'linea',
+    'codex',
+    'worldchain',
+    'ink',
+    'plume',
+    'solana',
+]);
+/** Get estimated bridge time in seconds for a given source chain */
+export function getEstimatedBridgeSeconds(chain) {
+    return FAST_TRANSFER_CHAINS.has(chain) ? 20 : 900; // 20s fast / 15min standard
+}
 //# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

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

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"}