@terkoizmy/intent-sdk 1.0.0

package/dist/shared/rpc/viem-provider.d.ts

@@ -0,0 +1,78 @@
+/**
+ * viem RPC Provider
+ *
+ * Implements IRPCProvider using viem's createPublicClient + http transport.
+ * Provides real JSON-RPC calls to EVM chains.
+ *
+ * Stage 3 — Live Integration (Phase B)
+ * Updated Phase G — Retry with exponential backoff for transient errors
+ *
+ * USAGE:
+ *   import { createViemProviderFactory } from "./viem-provider";
+ *   const rpm = new RPCProviderManager(createViemProviderFactory());
+ *   rpm.registerChain(SEPOLIA_CONFIG);
+ *   const provider = rpm.getProvider(11155111);
+ *   const blockNumber = await provider.getBlockNumber();
+ */
+import type { ChainConfig } from "../../types/chain";
+import type { Address, ChainId } from "../../types/common";
+import type { IRPCProvider, ProviderFactory } from "./provider-manager";
+/**
+ * IRPCProvider implementation backed by viem's PublicClient.
+ *
+ * All RPC calls are wrapped with exponential-backoff retry for
+ * transient network errors (timeouts, 429, 502/503/504).
+ */
+export declare class ViemProvider implements IRPCProvider {
+    readonly chainId: ChainId;
+    private readonly chainName;
+    private client;
+    constructor(config: ChainConfig);
+    /**
+     * Call a contract view function (eth_call).
+     */
+    call(to: Address, data: string): Promise<string>;
+    /**
+     * Get current block number.
+     */
+    getBlockNumber(): Promise<number>;
+    /**
+     * Get transaction receipt by hash.
+     */
+    getTransactionReceipt(txHash: string): Promise<{
+        status: number;
+        blockNumber: number;
+        gasUsed: string;
+    } | null>;
+    /**
+     * Get current gas price in wei.
+     */
+    getGasPrice(): Promise<string>;
+    /**
+     * Health check — try getBlockNumber and see if it succeeds.
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Send a signed transaction to the network.
+     */
+    sendRawTransaction(signedTx: `0x${string}`): Promise<string>;
+    /**
+     * Estimate gas for a transaction.
+     */
+    estimateGas(tx: {
+        to: Address;
+        data?: string;
+        value?: bigint;
+        from?: Address;
+    }): Promise<bigint>;
+}
+/**
+ * Factory function that creates ViemProvider instances.
+ *
+ * Pass this to RPCProviderManager constructor to wire real RPC connections.
+ *
+ * USAGE:
+ *   const rpm = new RPCProviderManager(createViemProviderFactory());
+ */
+export declare function createViemProviderFactory(): ProviderFactory;
+//# sourceMappingURL=viem-provider.d.ts.map

package/dist/shared/rpc/viem-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-provider.d.ts","sourceRoot":"","sources":["../../../src/shared/rpc/viem-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA8BxE;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC7C,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,MAAM,CAAmC;gBAErC,MAAM,EAAE,WAAW;IAU/B;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYtD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAYvC;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;IAqBT;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAYpC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAWlE;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE;QAClB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBtB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAI3D"}

package/dist/shared/rpc/viem-provider.js

@@ -0,0 +1,187 @@
+/**
+ * viem RPC Provider
+ *
+ * Implements IRPCProvider using viem's createPublicClient + http transport.
+ * Provides real JSON-RPC calls to EVM chains.
+ *
+ * Stage 3 — Live Integration (Phase B)
+ * Updated Phase G — Retry with exponential backoff for transient errors
+ *
+ * USAGE:
+ *   import { createViemProviderFactory } from "./viem-provider";
+ *   const rpm = new RPCProviderManager(createViemProviderFactory());
+ *   rpm.registerChain(SEPOLIA_CONFIG);
+ *   const provider = rpm.getProvider(11155111);
+ *   const blockNumber = await provider.getBlockNumber();
+ */
+import { createPublicClient, http } from "viem";
+import { withRetry, isTransientNetworkError } from "../utils/retry";
+import { getChainDisplayName } from "../chain-registry/chain-names";
+/** Retry options tuned for RPC calls */
+const RPC_RETRY_OPTIONS = {
+    maxRetries: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 5_000,
+    isRetryable: isTransientNetworkError,
+};
+/**
+ * Convert our ChainConfig into a viem-compatible Chain definition.
+ */
+function toViemChain(config) {
+    return {
+        id: config.id,
+        name: config.name,
+        nativeCurrency: config.nativeCurrency,
+        rpcUrls: {
+            default: { http: [config.rpcUrl, ...config.fallbackRpcUrls].filter(Boolean) },
+            public: { http: [config.rpcUrl, ...config.fallbackRpcUrls].filter(Boolean) },
+        },
+        blockExplorers: {
+            default: { name: "Explorer", url: config.explorer },
+        },
+    };
+}
+/**
+ * IRPCProvider implementation backed by viem's PublicClient.
+ *
+ * All RPC calls are wrapped with exponential-backoff retry for
+ * transient network errors (timeouts, 429, 502/503/504).
+ */
+export class ViemProvider {
+    chainId;
+    chainName;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client;
+    constructor(config) {
+        this.chainId = config.id;
+        this.chainName = getChainDisplayName(config.id);
+        this.client = createPublicClient({
+            chain: toViemChain(config),
+            transport: http(config.rpcUrl),
+        });
+    }
+    /**
+     * Call a contract view function (eth_call).
+     */
+    async call(to, data) {
+        return withRetry(async () => {
+            const result = await this.client.call({ to, data: data });
+            return result.data || "0x";
+        }, {
+            ...RPC_RETRY_OPTIONS,
+            onRetry: (err, attempt) => {
+                console.warn(`[ViemProvider] ${this.chainName} call() retry ${attempt}: ${err.message}`);
+            },
+        });
+    }
+    /**
+     * Get current block number.
+     */
+    async getBlockNumber() {
+        return withRetry(async () => {
+            const blockNumber = await this.client.getBlockNumber();
+            return Number(blockNumber);
+        }, {
+            ...RPC_RETRY_OPTIONS,
+            onRetry: (err, attempt) => {
+                console.warn(`[ViemProvider] ${this.chainName} getBlockNumber() retry ${attempt}: ${err.message}`);
+            },
+        });
+    }
+    /**
+     * Get transaction receipt by hash.
+     */
+    async getTransactionReceipt(txHash) {
+        try {
+            return await withRetry(async () => {
+                const receipt = await this.client.getTransactionReceipt({ hash: txHash });
+                return {
+                    status: receipt.status === "success" ? 1 : 0,
+                    blockNumber: Number(receipt.blockNumber),
+                    gasUsed: receipt.gasUsed.toString(),
+                };
+            }, {
+                ...RPC_RETRY_OPTIONS,
+                onRetry: (err, attempt) => {
+                    console.warn(`[ViemProvider] ${this.chainName} getTransactionReceipt() retry ${attempt}: ${err.message}`);
+                },
+            });
+        }
+        catch (error) {
+            // Receipt not found throws in viem, so we return null
+            return null;
+        }
+    }
+    /**
+     * Get current gas price in wei.
+     */
+    async getGasPrice() {
+        return withRetry(async () => {
+            const gasPrice = await this.client.getGasPrice();
+            return gasPrice.toString();
+        }, {
+            ...RPC_RETRY_OPTIONS,
+            onRetry: (err, attempt) => {
+                console.warn(`[ViemProvider] ${this.chainName} getGasPrice() retry ${attempt}: ${err.message}`);
+            },
+        });
+    }
+    /**
+     * Health check — try getBlockNumber and see if it succeeds.
+     */
+    async isHealthy() {
+        try {
+            await this.client.getBlockNumber();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Send a signed transaction to the network.
+     */
+    async sendRawTransaction(signedTx) {
+        return withRetry(async () => {
+            return await this.client.sendRawTransaction({ serializedTransaction: signedTx });
+        }, {
+            ...RPC_RETRY_OPTIONS,
+            onRetry: (err, attempt) => {
+                console.warn(`[ViemProvider] ${this.chainName} sendRawTransaction() retry ${attempt}: ${err.message}`);
+            },
+        });
+    }
+    /**
+     * Estimate gas for a transaction.
+     */
+    async estimateGas(tx) {
+        return withRetry(async () => {
+            const gas = await this.client.estimateGas({
+                to: tx.to,
+                data: tx.data,
+                value: tx.value,
+                account: tx.from,
+            });
+            return gas;
+        }, {
+            ...RPC_RETRY_OPTIONS,
+            onRetry: (err, attempt) => {
+                console.warn(`[ViemProvider] ${this.chainName} estimateGas() retry ${attempt}: ${err.message}`);
+            },
+        });
+    }
+}
+/**
+ * Factory function that creates ViemProvider instances.
+ *
+ * Pass this to RPCProviderManager constructor to wire real RPC connections.
+ *
+ * USAGE:
+ *   const rpm = new RPCProviderManager(createViemProviderFactory());
+ */
+export function createViemProviderFactory() {
+    return (config) => {
+        return new ViemProvider(config);
+    };
+}
+//# sourceMappingURL=viem-provider.js.map

package/dist/shared/rpc/viem-provider.js.map

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

package/dist/shared/token-registry/enrichment.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Token Enrichment Layer
+ *
+ * Bridges the gap between the IntentParser output (which has token symbols)
+ * and the IntentSolver input (which needs contract addresses).
+ *
+ * Takes a parsed StructuredIntent and enriches it with resolved token addresses
+ * from the TokenRegistry.
+ *
+ * Stage 3 — Live Integration
+ *
+ * USAGE:
+ *   const registry = new TokenRegistry();
+ *   registry.registerAll([...DEFAULT_TOKENS, ...TESTNET_TOKENS]);
+ *
+ *   const parsed = parser.parse("Bridge 100 USDC to Arbitrum");
+ *   const enriched = enrichIntent(parsed, registry, 1, 42161);
+ *   // enriched.parameters.inputTokenAddress  → "0xA0b86991..."
+ *   // enriched.parameters.outputTokenAddress → "0xaf88d065..."
+ */
+import type { StructuredIntent } from "../../types/intent";
+import type { ChainId } from "../../types/common";
+import type { TokenRegistry } from "./registry";
+/**
+ * Result of intent enrichment
+ */
+export interface EnrichedIntent extends StructuredIntent {
+    /** Whether token addresses were successfully resolved */
+    enriched: boolean;
+    /** Enrichment warnings (e.g., token not found, fallback used) */
+    enrichmentWarnings: string[];
+}
+/**
+ * Enrich a parsed intent with token contract addresses.
+ *
+ * Resolves `inputToken` symbol → `inputTokenAddress` on sourceChainId
+ * Resolves `outputToken` symbol → `outputTokenAddress` on targetChainId
+ *
+ * If a token cannot be resolved, it adds a warning and leaves the address field empty.
+ *
+ * @param intent        - The parsed StructuredIntent from IntentParser
+ * @param registry      - TokenRegistry instance with registered tokens
+ * @param sourceChainId - Chain ID for the input token (source chain)
+ * @param targetChainId - Chain ID for the output token (target chain), defaults to sourceChainId
+ * @returns EnrichedIntent with resolved addresses
+ */
+export declare function enrichIntent(intent: StructuredIntent, registry: TokenRegistry, sourceChainId: ChainId, targetChainId?: ChainId): EnrichedIntent;
+//# sourceMappingURL=enrichment.d.ts.map

package/dist/shared/token-registry/enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../../src/shared/token-registry/enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAElB,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,OAAO,EACtB,aAAa,CAAC,EAAE,OAAO,GACxB,cAAc,CAuChB"}

package/dist/shared/token-registry/enrichment.js

@@ -0,0 +1,69 @@
+/**
+ * Token Enrichment Layer
+ *
+ * Bridges the gap between the IntentParser output (which has token symbols)
+ * and the IntentSolver input (which needs contract addresses).
+ *
+ * Takes a parsed StructuredIntent and enriches it with resolved token addresses
+ * from the TokenRegistry.
+ *
+ * Stage 3 — Live Integration
+ *
+ * USAGE:
+ *   const registry = new TokenRegistry();
+ *   registry.registerAll([...DEFAULT_TOKENS, ...TESTNET_TOKENS]);
+ *
+ *   const parsed = parser.parse("Bridge 100 USDC to Arbitrum");
+ *   const enriched = enrichIntent(parsed, registry, 1, 42161);
+ *   // enriched.parameters.inputTokenAddress  → "0xA0b86991..."
+ *   // enriched.parameters.outputTokenAddress → "0xaf88d065..."
+ */
+/**
+ * Enrich a parsed intent with token contract addresses.
+ *
+ * Resolves `inputToken` symbol → `inputTokenAddress` on sourceChainId
+ * Resolves `outputToken` symbol → `outputTokenAddress` on targetChainId
+ *
+ * If a token cannot be resolved, it adds a warning and leaves the address field empty.
+ *
+ * @param intent        - The parsed StructuredIntent from IntentParser
+ * @param registry      - TokenRegistry instance with registered tokens
+ * @param sourceChainId - Chain ID for the input token (source chain)
+ * @param targetChainId - Chain ID for the output token (target chain), defaults to sourceChainId
+ * @returns EnrichedIntent with resolved addresses
+ */
+export function enrichIntent(intent, registry, sourceChainId, targetChainId) {
+    const enrichedIntent = {
+        ...intent,
+        parameters: { ...intent.parameters },
+        enriched: false,
+        enrichmentWarnings: [],
+    };
+    const actualTargetChainId = targetChainId ?? sourceChainId;
+    let anySuccess = false;
+    // Resolve input token
+    if (enrichedIntent.parameters.inputToken) {
+        const inputToken = registry.get(enrichedIntent.parameters.inputToken.toUpperCase(), sourceChainId);
+        if (inputToken) {
+            enrichedIntent.parameters.inputTokenAddress = inputToken.address;
+            anySuccess = true;
+        }
+        else {
+            enrichedIntent.enrichmentWarnings.push(`Failed to resolve input token ${enrichedIntent.parameters.inputToken} on chain ${sourceChainId}`);
+        }
+    }
+    // Resolve output token
+    if (enrichedIntent.parameters.outputToken) {
+        const outputToken = registry.get(enrichedIntent.parameters.outputToken.toUpperCase(), actualTargetChainId);
+        if (outputToken) {
+            enrichedIntent.parameters.outputTokenAddress = outputToken.address;
+            anySuccess = true;
+        }
+        else {
+            enrichedIntent.enrichmentWarnings.push(`Failed to resolve output token ${enrichedIntent.parameters.outputToken} on chain ${actualTargetChainId}`);
+        }
+    }
+    enrichedIntent.enriched = anySuccess;
+    return enrichedIntent;
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/shared/token-registry/enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.js","sourceRoot":"","sources":["../../../src/shared/token-registry/enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiBH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CACxB,MAAwB,EACxB,QAAuB,EACvB,aAAsB,EACtB,aAAuB;IAEvB,MAAM,cAAc,GAAmB;QACnC,GAAG,MAAM;QACT,UAAU,EAAE,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE;QACpC,QAAQ,EAAE,KAAK;QACf,kBAAkB,EAAE,EAAE;KACzB,CAAC;IAEF,MAAM,mBAAmB,GAAG,aAAa,IAAI,aAAa,CAAC;IAC3D,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,sBAAsB;IACtB,IAAI,cAAc,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;QACnG,IAAI,UAAU,EAAE,CAAC;YACb,cAAc,CAAC,UAAU,CAAC,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC;YACjE,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACJ,cAAc,CAAC,kBAAkB,CAAC,IAAI,CAClC,iCAAiC,cAAc,CAAC,UAAU,CAAC,UAAU,aAAa,aAAa,EAAE,CACpG,CAAC;QACN,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC3G,IAAI,WAAW,EAAE,CAAC;YACd,cAAc,CAAC,UAAU,CAAC,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC;YACnE,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACJ,cAAc,CAAC,kBAAkB,CAAC,IAAI,CAClC,kCAAkC,cAAc,CAAC,UAAU,CAAC,WAAW,aAAa,mBAAmB,EAAE,CAC5G,CAAC;QACN,CAAC;IACL,CAAC;IAED,cAAc,CAAC,QAAQ,GAAG,UAAU,CAAC;IACrC,OAAO,cAAc,CAAC;AAC1B,CAAC"}

package/dist/shared/token-registry/registry.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Token Registry
+ *
+ * Central registry untuk token info (address, decimals, etc) per chain.
+ * Pre-registers common tokens (USDC) untuk supported chains.
+ *
+ * USAGE:
+ *   const registry = new TokenRegistry();
+ *   registry.register({ address: "0xA0b8...", symbol: "USDC", decimals: 6, chainId: 1, name: "USD Coin" });
+ *
+ *   const usdc = registry.get("USDC", 1);
+ *   const usdcByAddr = registry.getByAddress("0xA0b8...", 1);
+ */
+import type { Address, ChainId } from "../../types/common";
+/**
+ * Token info in the registry
+ */
+export interface TokenInfo {
+    /** Contract address on specific chain */
+    address: Address;
+    /** Token symbol (e.g., "USDC", "USDT") */
+    symbol: string;
+    /** Token decimals (e.g., 6 for USDC, 18 for ETH) */
+    decimals: number;
+    /** Chain ID where this token lives */
+    chainId: ChainId;
+    /** Full token name (e.g., "USD Coin") */
+    name: string;
+}
+/**
+ * TokenRegistry
+ *
+ * Manages token info indexed by (symbol, chainId) and (address, chainId).
+ */
+export declare class TokenRegistry {
+    /** symbol:chainId → TokenInfo */
+    private bySymbol;
+    /** address:chainId → TokenInfo */
+    private byAddress;
+    /**
+     * Generate composite key for maps
+     */
+    private symbolKey;
+    private addressKey;
+    /**
+     * Register a token.
+     * Updates existing entry if same (symbol, chainId) already registered.
+     */
+    register(token: TokenInfo): void;
+    /**
+     * Register multiple tokens at once.
+     */
+    registerAll(tokens: TokenInfo[]): void;
+    /**
+     * Get token by symbol and chain ID.
+     * Returns undefined if not found.
+     */
+    get(symbol: string, chainId: ChainId): TokenInfo | undefined;
+    /**
+     * Get token by contract address and chain ID.
+     * Returns undefined if not found.
+     */
+    getByAddress(address: string, chainId: ChainId): TokenInfo | undefined;
+    /**
+     * Check if a token is registered.
+     */
+    has(symbol: string, chainId: ChainId): boolean;
+    /**
+     * List all tokens on a specific chain.
+     */
+    listByChain(chainId: ChainId): TokenInfo[];
+    /**
+     * List all registered tokens.
+     */
+    listAll(): TokenInfo[];
+    /**
+     * Get number of registered tokens.
+     */
+    get size(): number;
+}
+/**
+ * Pre-configured USDC token info for common chains.
+ * Register these via registry.registerAll(DEFAULT_TOKENS).
+ */
+export declare const DEFAULT_TOKENS: TokenInfo[];
+/**
+ * Testnet USDC token info for supported testnet chains.
+ * Register these via registry.registerAll(TESTNET_TOKENS).
+ *
+ * Stage 3 — Live Integration
+ *
+ * Chains: Sepolia, Arbitrum Sepolia, Unichain Sepolia, Base Sepolia
+ */
+export declare const TESTNET_TOKENS: TokenInfo[];
+/**
+ * Additional mainnet tokens beyond USDC.
+ * Register these via registry.registerAll(MAINNET_TOKENS).
+ *
+ * Stage 3 — Live Integration
+ *
+ * Tokens: USDT, WETH, WBTC, DAI on Ethereum/Arbitrum/Optimism
+ */
+export declare const MAINNET_TOKENS: TokenInfo[];
+/**
+ * Resolve a token address from symbol + chainId.
+ *
+ * Looks up the token in the provided registry instance.
+ * Throws if the token is not found.
+ *
+ * Stage 3 — Live Integration
+ *
+ * @param registry - TokenRegistry instance to search in
+ * @param symbol   - Token symbol (e.g., "USDC")
+ * @param chainId  - Target chain ID
+ * @returns The token's contract address
+ * @throws Error if token not found for the given symbol + chainId
+ */
+export declare function resolveFromSymbol(registry: TokenRegistry, symbol: string, chainId: ChainId): Address;
+//# sourceMappingURL=registry.d.ts.map

package/dist/shared/token-registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/shared/token-registry/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACtB,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAqC;IAErD,kCAAkC;IAClC,OAAO,CAAC,SAAS,CAAqC;IAEtD;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQhC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAMtC;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAI5D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAItE;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAI9C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE;IAM1C;;OAEG;IACH,OAAO,IAAI,SAAS,EAAE;IAItB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,EAsBrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,EA6BrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,EAkBrC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACjB,OAAO,CAMT"}