agentwallet-sdk 2.4.1 → 3.0.0

package/dist/bridge/unified.js

@@ -0,0 +1,284 @@
+// [MAX-ADDED] UnifiedBridge — Single interface for CCTP V2 transfers across all 17 chains
+// Routes EVM↔EVM, EVM→Solana, and Solana→EVM via BridgeModule + SolanaCCTPBridge.
+//
+// Supported: 16 EVM chains + Solana (17 total)
+// Fee: 0.1% platform fee on bridged amount
+//
+// Usage:
+//   const bridge = new UnifiedBridge({ evmSigner: walletClient, solanaWallet: keypair });
+//   await bridge.bridge({ amount: 1_000_000n, sourceChain: 'base', destinationChain: 'polygon', destinationAddress: '0x...' });
+import { Connection } from '@solana/web3.js';
+import { BridgeModule, BridgeError } from './client.js';
+import { CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, BRIDGE_RPC_URLS, calcBridgeFee, getEstimatedBridgeSeconds, FAST_TRANSFER_CHAINS, } from './types.js';
+import { SolanaCCTPBridge, SolanaBridgeError } from '../solana/bridge.js';
+// ─── UnifiedBridge ───
+/**
+ * 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 class UnifiedBridge {
+    constructor(config = {}) {
+        this.config = config;
+        this.solanaConnection = new Connection(config.solanaRpcUrl ?? 'https://api.mainnet-beta.solana.com', 'confirmed');
+    }
+    // ─── Public API ───
+    /**
+     * Bridge USDC between any two CCTP V2 supported chains.
+     * Routes automatically based on source/destination chain types.
+     */
+    async bridge(params) {
+        const { amount, sourceChain, destinationChain, destinationAddress, minFinalityThreshold = 0, applyPlatformFee = true, destinationRpcUrl, } = params;
+        // Validate before routing (catches unsupported chains, zero amount)
+        // Check Solana→Solana before generic same-chain to give the right error code
+        const isSolanaSource = sourceChain === 'solana';
+        const isSolanaDestination = destinationChain === 'solana';
+        if (isSolanaSource && isSolanaDestination) {
+            throw new BridgeError('UNSUPPORTED_ROUTE', 'Solana → Solana bridging is not supported. Use native Solana transfers instead.');
+        }
+        this.validateParams(amount, sourceChain, destinationChain);
+        if (!isSolanaSource && !isSolanaDestination) {
+            // EVM → EVM
+            return this.bridgeEvmToEvm({
+                amount,
+                sourceChain: sourceChain,
+                destinationChain: destinationChain,
+                destinationAddress,
+                minFinalityThreshold,
+                applyPlatformFee,
+                destinationRpcUrl,
+            });
+        }
+        if (isSolanaSource && !isSolanaDestination) {
+            // Solana → EVM
+            return this.bridgeSolanaToEvm({
+                amount,
+                destinationChain: destinationChain,
+                destinationAddress,
+                minFinalityThreshold,
+                applyPlatformFee,
+            });
+        }
+        // EVM → Solana
+        return this.bridgeEvmToSolana({
+            amount,
+            sourceChain: sourceChain,
+            destinationAddress,
+            minFinalityThreshold,
+            applyPlatformFee,
+            destinationRpcUrl,
+        });
+    }
+    /**
+     * Get all supported chains (16 EVM + Solana = 17 total).
+     */
+    getSupportedChains() {
+        return Object.keys(CCTP_DOMAIN_IDS);
+    }
+    /**
+     * Get a bridge quote: fee breakdown + estimated time.
+     */
+    getQuote(params) {
+        const { amount, sourceChain, destinationChain } = params;
+        if (amount <= 0n) {
+            throw new BridgeError('INVALID_AMOUNT', 'Quote amount must be > 0');
+        }
+        const platformFee = calcBridgeFee(amount);
+        const outputAmount = amount - platformFee;
+        const estimatedTimeSeconds = getEstimatedBridgeSeconds(sourceChain);
+        const fastTransferAvailable = FAST_TRANSFER_CHAINS.has(sourceChain);
+        return {
+            inputAmount: amount,
+            platformFee,
+            outputAmount,
+            fromChain: sourceChain,
+            toChain: destinationChain,
+            estimatedTimeSeconds,
+            fastTransferAvailable,
+        };
+    }
+    /**
+     * Check if a route is supported.
+     */
+    isRouteSupported(source, destination) {
+        if (source === destination)
+            return false;
+        if (source === 'solana' && destination === 'solana')
+            return false;
+        return source in CCTP_DOMAIN_IDS && destination in CCTP_DOMAIN_IDS;
+    }
+    // ─── Internal Routing ───
+    async bridgeEvmToEvm(params) {
+        const { sourceChain, destinationChain } = params;
+        if (!this.config.evmSigner) {
+            throw new BridgeError('NO_WALLET_CLIENT', `EVM wallet client required for EVM→EVM bridge (${sourceChain} → ${destinationChain}). ` +
+                `Pass evmSigner to UnifiedBridge constructor.`);
+        }
+        const rpcOverride = this.config.evmRpcOverrides?.[sourceChain];
+        const bridge = new BridgeModule(this.config.evmSigner, sourceChain, { rpcUrl: rpcOverride });
+        return bridge.bridge(params.amount, destinationChain, {
+            destinationAddress: params.destinationAddress,
+            minFinalityThreshold: params.minFinalityThreshold,
+            applyPlatformFee: params.applyPlatformFee,
+            destinationRpcUrl: params.destinationRpcUrl ?? this.config.evmRpcOverrides?.[destinationChain],
+            attestationApiUrl: this.config.attestationApiUrl,
+        });
+    }
+    async bridgeSolanaToEvm(params) {
+        const startMs = Date.now();
+        if (!this.config.solanaWallet) {
+            throw new SolanaBridgeError('NO_SOLANA_WALLET', 'Solana keypair required for Solana→EVM bridge. ' +
+                'Pass solanaWallet to UnifiedBridge constructor.');
+        }
+        if (!this.config.evmSigner) {
+            throw new BridgeError('NO_WALLET_CLIENT', 'EVM wallet client required to receive on destination EVM chain. ' +
+                'Pass evmSigner to UnifiedBridge constructor.');
+        }
+        const applyFee = params.applyPlatformFee !== false;
+        const platformFee = applyFee ? calcBridgeFee(params.amount) : 0n;
+        const bridgeAmount = params.amount - platformFee;
+        // Phase 1: Burn on Solana
+        const solanaBridge = new SolanaCCTPBridge({
+            connection: this.solanaConnection,
+            payer: this.config.solanaWallet,
+        });
+        const burnResult = await solanaBridge.depositForBurn({
+            amount: bridgeAmount,
+            destinationChain: params.destinationChain,
+            destinationAddress: params.destinationAddress,
+            minFinalityThreshold: params.minFinalityThreshold,
+        });
+        // Phase 2: Poll attestation (Solana uses same IRIS API)
+        const attestation = await solanaBridge.waitForAttestation(burnResult.messageHash, this.config.attestationApiUrl);
+        // Phase 3: Mint on EVM destination
+        const rpcOverride = this.config.evmRpcOverrides?.[params.destinationChain];
+        const evmBridge = new BridgeModule(this.config.evmSigner, params.destinationChain, // use dest as source for the receive-only operation
+        { rpcUrl: rpcOverride });
+        const evmMintTxHash = await evmBridge.mint(burnResult.messageBytes, attestation, params.destinationChain, rpcOverride);
+        return {
+            burnTxHash: burnResult.signature,
+            mintTxHash: evmMintTxHash,
+            amount: bridgeAmount,
+            platformFee,
+            fromChain: 'solana',
+            toChain: params.destinationChain,
+            recipient: params.destinationAddress,
+            nonce: burnResult.nonce,
+            elapsedMs: Date.now() - startMs,
+        };
+    }
+    async bridgeEvmToSolana(params) {
+        const startMs = Date.now();
+        if (!this.config.evmSigner) {
+            throw new BridgeError('NO_WALLET_CLIENT', `EVM wallet client required for ${params.sourceChain}→Solana bridge.`);
+        }
+        if (!this.config.solanaWallet) {
+            throw new SolanaBridgeError('NO_SOLANA_WALLET', 'Solana keypair required to receive USDC on Solana. ' +
+                'Pass solanaWallet to UnifiedBridge constructor.');
+        }
+        const applyFee = params.applyPlatformFee !== false;
+        const platformFee = applyFee ? calcBridgeFee(params.amount) : 0n;
+        const bridgeAmount = params.amount - platformFee;
+        // Solana destination: mintRecipient must be hex of USDC ATA on Solana
+        // The caller passes a base58 Solana address; we convert to hex for EVM depositForBurn
+        const solanaAddressHex = this.solanaAddressToHex(params.destinationAddress);
+        // Phase 1: Burn on EVM (using CCTP domain 5 for Solana)
+        const rpcOverride = this.config.evmRpcOverrides?.[params.sourceChain];
+        const evmBridge = new BridgeModule(this.config.evmSigner, params.sourceChain, { rpcUrl: rpcOverride });
+        const burnResult = await evmBridge.burn(bridgeAmount, 'solana', {
+            destinationAddress: solanaAddressHex,
+            minFinalityThreshold: params.minFinalityThreshold,
+            applyPlatformFee: false, // already deducted
+            attestationApiUrl: this.config.attestationApiUrl,
+        });
+        // Phase 2: Attestation
+        const attestation = await evmBridge.waitForAttestation(burnResult.messageHash, this.config.attestationApiUrl);
+        // Phase 3: Receive on Solana
+        const solanaBridge = new SolanaCCTPBridge({
+            connection: this.solanaConnection,
+            payer: this.config.solanaWallet,
+        });
+        // Ensure recipient USDC ATA exists
+        const recipientUsdcAta = await solanaBridge.ensureUsdcAta();
+        const solanaMintSig = await solanaBridge.receiveMessage({
+            message: burnResult.messageBytes,
+            attestation,
+            recipientUsdcAccount: recipientUsdcAta.toString(),
+        });
+        return {
+            burnTxHash: burnResult.burnTxHash,
+            mintTxHash: solanaMintSig,
+            amount: bridgeAmount,
+            platformFee,
+            fromChain: params.sourceChain,
+            toChain: 'solana',
+            recipient: params.destinationAddress,
+            nonce: burnResult.nonce,
+            elapsedMs: Date.now() - startMs,
+        };
+    }
+    // ─── Validation ───
+    validateParams(amount, sourceChain, destinationChain) {
+        if (amount <= 0n) {
+            throw new BridgeError('INVALID_AMOUNT', `Amount must be > 0. Got ${amount}. Use USDC base units (1 USDC = 1_000_000).`);
+        }
+        if (!(sourceChain in CCTP_DOMAIN_IDS)) {
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Source chain '${sourceChain}' is not supported. ` +
+                `Supported: ${Object.keys(CCTP_DOMAIN_IDS).join(', ')}`);
+        }
+        if (!(destinationChain in CCTP_DOMAIN_IDS)) {
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Destination chain '${destinationChain}' is not supported. ` +
+                `Supported: ${Object.keys(CCTP_DOMAIN_IDS).join(', ')}`);
+        }
+        if (sourceChain === destinationChain) {
+            throw new BridgeError('SAME_CHAIN', `Source and destination must differ. Both set to '${sourceChain}'.`);
+        }
+    }
+    // ─── Helpers ───
+    /**
+     * Convert a Solana base58 address to a 32-byte hex string for EVM mintRecipient.
+     * Per Circle docs: hex-encoded USDC token account address.
+     */
+    solanaAddressToHex(base58Address) {
+        // bs58 decode → hex encode
+        // Import dynamically to avoid requiring bs58 for EVM-only users
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const bs58 = require('bs58');
+            const decoded = bs58.decode(base58Address);
+            return '0x' + Buffer.from(decoded).toString('hex').padStart(64, '0');
+        }
+        catch {
+            // If bs58 not available, assume it's already hex
+            if (base58Address.startsWith('0x'))
+                return base58Address;
+            throw new BridgeError('UNSUPPORTED_CHAIN', `Could not convert Solana address to hex: ${base58Address}. ` +
+                `Pass the USDC ATA address (base58) for Solana destination.`);
+        }
+    }
+}
+// ─── Re-exports ───
+export { BridgeError, SolanaBridgeError };
+export { CCTP_DOMAIN_IDS, BRIDGE_CHAIN_IDS, BRIDGE_RPC_URLS, calcBridgeFee, };
+//# sourceMappingURL=unified.js.map

package/dist/bridge/unified.js.map

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

package/dist/chains.d.ts

@@ -0,0 +1,62 @@
+import type { Address } from 'viem';
+/** Chains supported for swap + x402 + wallet operations */
+export type SupportedChain = 'base' | 'arbitrum' | 'optimism';
+export interface ChainConfig {
+    chainId: number;
+    name: string;
+    /** Public default RPC URL (no API key required) */
+    rpcUrl: string;
+    /** USDC token contract address (official Circle deployment) */
+    usdc: Address;
+    /** Uniswap V3 SwapRouter02 address */
+    uniswapRouter?: Address;
+    /** Uniswap V3 QuoterV2 address */
+    uniswapQuoter?: Address;
+    /** Wrapped native token address */
+    weth?: Address;
+    /** x402 network identifier (e.g. "base:8453") */
+    x402Network: string;
+}
+/**
+ * Chain configuration for all supported chains.
+ *
+ * Uniswap V3 addresses verified against:
+ *   https://docs.uniswap.org/contracts/v3/reference/deployments/
+ *
+ * USDC addresses verified against:
+ *   https://www.circle.com/en/multichain-usdc
+ *
+ * WETH on Base / Optimism is the canonical OP-stack bridged WETH at 0x4200...0006
+ * Arbitrum WETH is the standard bridged WETH at 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1
+ */
+export declare const CHAIN_CONFIG: Record<SupportedChain, ChainConfig>;
+/** Get chain config — throws a clear error if chain is unknown */
+export declare function getChainConfig(chain: SupportedChain): ChainConfig;
+/** Resolve a chain from chainId — returns undefined if not found */
+export declare function chainFromId(chainId: number): SupportedChain | undefined;
+/** Solana chain identifiers */
+export type SolanaChain = 'solana' | 'solana-devnet';
+/** Solana chain configuration entry */
+export interface SolanaChainConfig {
+    /** Solana cluster name (e.g. "mainnet-beta", "devnet") */
+    cluster: string;
+    /** Public RPC URL */
+    rpcUrl: string;
+    /** Official USDC SPL token mint address */
+    usdcMint: string;
+    /** x402 network identifier */
+    x402Network: string;
+}
+/**
+ * Solana chain configurations.
+ *
+ * USDC mints verified against:
+ *   https://www.circle.com/en/multichain-usdc (Solana)
+ *
+ * RPC endpoints: Solana Foundation public RPC (free, no key required).
+ * For production, use Helius, Alchemy, or QuickNode.
+ */
+export declare const SOLANA_CONFIG: Record<SolanaChain, SolanaChainConfig>;
+/** Get Solana chain config — throws if chain is unknown */
+export declare function getSolanaConfig(chain: SolanaChain): SolanaChainConfig;
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kCAAkC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,CA2CnD,CAAC;AAEX,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAQjE;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAKvE;AAMD,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;AAErD,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAevD,CAAC;AAEX,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAQrE"}

package/dist/chains.js

@@ -0,0 +1,108 @@
+// [MAX-ADDED] Shared chain configuration — single source of truth for multi-chain support.
+// Chains: Base, Arbitrum, Optimism (Ethereum is bridge-only, no swap support due to gas).
+/**
+ * Chain configuration for all supported chains.
+ *
+ * Uniswap V3 addresses verified against:
+ *   https://docs.uniswap.org/contracts/v3/reference/deployments/
+ *
+ * USDC addresses verified against:
+ *   https://www.circle.com/en/multichain-usdc
+ *
+ * WETH on Base / Optimism is the canonical OP-stack bridged WETH at 0x4200...0006
+ * Arbitrum WETH is the standard bridged WETH at 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1
+ */
+export const CHAIN_CONFIG = {
+    base: {
+        chainId: 8453,
+        name: 'Base',
+        rpcUrl: 'https://mainnet.base.org',
+        // Official USDC on Base (Circle native deployment)
+        usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        // Uniswap V3 on Base — SwapRouter02 + QuoterV2
+        // Source: https://docs.uniswap.org/contracts/v3/reference/deployments/base-deployments
+        uniswapRouter: '0x2626664c2603336E57B271c5C0b26F421741e481',
+        uniswapQuoter: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+        // OP-stack canonical WETH
+        weth: '0x4200000000000000000000000000000000000006',
+        x402Network: 'base:8453',
+    },
+    arbitrum: {
+        chainId: 42161,
+        name: 'Arbitrum One',
+        rpcUrl: 'https://arb1.arbitrum.io/rpc',
+        // Official USDC on Arbitrum (Circle native deployment — NOT USDC.e bridged)
+        usdc: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        // Uniswap V3 on Arbitrum — SwapRouter02 + QuoterV2
+        // Source: https://docs.uniswap.org/contracts/v3/reference/deployments/arbitrum-deployments
+        uniswapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        uniswapQuoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        // Standard bridged WETH on Arbitrum
+        weth: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+        x402Network: 'arbitrum:42161',
+    },
+    optimism: {
+        chainId: 10,
+        name: 'OP Mainnet',
+        rpcUrl: 'https://mainnet.optimism.io',
+        // Official USDC on Optimism (Circle native deployment — NOT USDC.e bridged)
+        usdc: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+        // Uniswap V3 on Optimism — SwapRouter02 + QuoterV2
+        // Source: https://docs.uniswap.org/contracts/v3/reference/deployments/optimism-deployments
+        uniswapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        uniswapQuoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        // OP-stack canonical WETH
+        weth: '0x4200000000000000000000000000000000000006',
+        x402Network: 'optimism:10',
+    },
+};
+/** Get chain config — throws a clear error if chain is unknown */
+export function getChainConfig(chain) {
+    const config = CHAIN_CONFIG[chain];
+    if (!config) {
+        throw new Error(`Unsupported chain: "${chain}". Supported chains: ${Object.keys(CHAIN_CONFIG).join(', ')}`);
+    }
+    return config;
+}
+/** Resolve a chain from chainId — returns undefined if not found */
+export function chainFromId(chainId) {
+    for (const [key, cfg] of Object.entries(CHAIN_CONFIG)) {
+        if (cfg.chainId === chainId)
+            return key;
+    }
+    return undefined;
+}
+/**
+ * Solana chain configurations.
+ *
+ * USDC mints verified against:
+ *   https://www.circle.com/en/multichain-usdc (Solana)
+ *
+ * RPC endpoints: Solana Foundation public RPC (free, no key required).
+ * For production, use Helius, Alchemy, or QuickNode.
+ */
+export const SOLANA_CONFIG = {
+    solana: {
+        cluster: 'mainnet-beta',
+        rpcUrl: 'https://api.mainnet-beta.solana.com',
+        // Official Circle USDC on Solana Mainnet
+        usdcMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+        x402Network: 'solana:mainnet',
+    },
+    'solana-devnet': {
+        cluster: 'devnet',
+        rpcUrl: 'https://api.devnet.solana.com',
+        // Circle USDC on Solana Devnet
+        usdcMint: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+        x402Network: 'solana:devnet',
+    },
+};
+/** Get Solana chain config — throws if chain is unknown */
+export function getSolanaConfig(chain) {
+    const config = SOLANA_CONFIG[chain];
+    if (!config) {
+        throw new Error(`Unsupported Solana chain: "${chain}". Supported: ${Object.keys(SOLANA_CONFIG).join(', ')}`);
+    }
+    return config;
+}
+//# sourceMappingURL=chains.js.map

package/dist/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,0FAA0F;AAwB1F;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwC;IAC/D,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,0BAA0B;QAClC,mDAAmD;QACnD,IAAI,EAAE,4CAA4C;QAClD,+CAA+C;QAC/C,uFAAuF;QACvF,aAAa,EAAE,4CAA4C;QAC3D,aAAa,EAAE,4CAA4C;QAC3D,0BAA0B;QAC1B,IAAI,EAAE,4CAA4C;QAClD,WAAW,EAAE,WAAW;KACzB;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,8BAA8B;QACtC,4EAA4E;QAC5E,IAAI,EAAE,4CAA4C;QAClD,mDAAmD;QACnD,2FAA2F;QAC3F,aAAa,EAAE,4CAA4C;QAC3D,aAAa,EAAE,4CAA4C;QAC3D,oCAAoC;QACpC,IAAI,EAAE,4CAA4C;QAClD,WAAW,EAAE,gBAAgB;KAC9B;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,6BAA6B;QACrC,4EAA4E;QAC5E,IAAI,EAAE,4CAA4C;QAClD,mDAAmD;QACnD,2FAA2F;QAC3F,aAAa,EAAE,4CAA4C;QAC3D,aAAa,EAAE,4CAA4C;QAC3D,0BAA0B;QAC1B,IAAI,EAAE,4CAA4C;QAClD,WAAW,EAAE,aAAa;KAC3B;CACO,CAAC;AAEX,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,wBAAwB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,GAAqB,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAqBD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,MAAM,EAAE;QACN,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,qCAAqC;QAC7C,yCAAyC;QACzC,QAAQ,EAAE,8CAA8C;QACxD,WAAW,EAAE,gBAAgB;KAC9B;IACD,eAAe,EAAE;QACf,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,+BAA+B;QACvC,+BAA+B;QAC/B,QAAQ,EAAE,8CAA8C;QACxD,WAAW,EAAE,eAAe;KAC7B;CACO,CAAC;AAEX,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,iBAAiB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}