@terkoizmy/intent-sdk 1.0.0

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

@@ -0,0 +1,200 @@
+/**
+ * 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);
+ */
+/**
+ * TokenRegistry
+ *
+ * Manages token info indexed by (symbol, chainId) and (address, chainId).
+ */
+export class TokenRegistry {
+    /** symbol:chainId → TokenInfo */
+    bySymbol = new Map();
+    /** address:chainId → TokenInfo */
+    byAddress = new Map();
+    /**
+     * Generate composite key for maps
+     */
+    symbolKey(symbol, chainId) {
+        return `${symbol.toUpperCase()}:${chainId}`;
+    }
+    addressKey(address, chainId) {
+        return `${address.toLowerCase()}:${chainId}`;
+    }
+    /**
+     * Register a token.
+     * Updates existing entry if same (symbol, chainId) already registered.
+     */
+    register(token) {
+        const sKey = this.symbolKey(token.symbol, token.chainId);
+        const aKey = this.addressKey(token.address, token.chainId);
+        this.bySymbol.set(sKey, token);
+        this.byAddress.set(aKey, token);
+    }
+    /**
+     * Register multiple tokens at once.
+     */
+    registerAll(tokens) {
+        for (const token of tokens) {
+            this.register(token);
+        }
+    }
+    /**
+     * Get token by symbol and chain ID.
+     * Returns undefined if not found.
+     */
+    get(symbol, chainId) {
+        return this.bySymbol.get(this.symbolKey(symbol, chainId));
+    }
+    /**
+     * Get token by contract address and chain ID.
+     * Returns undefined if not found.
+     */
+    getByAddress(address, chainId) {
+        return this.byAddress.get(this.addressKey(address, chainId));
+    }
+    /**
+     * Check if a token is registered.
+     */
+    has(symbol, chainId) {
+        return this.bySymbol.has(this.symbolKey(symbol, chainId));
+    }
+    /**
+     * List all tokens on a specific chain.
+     */
+    listByChain(chainId) {
+        return Array.from(this.bySymbol.values()).filter((t) => t.chainId === chainId);
+    }
+    /**
+     * List all registered tokens.
+     */
+    listAll() {
+        return Array.from(this.bySymbol.values());
+    }
+    /**
+     * Get number of registered tokens.
+     */
+    get size() {
+        return this.bySymbol.size;
+    }
+}
+/**
+ * Pre-configured USDC token info for common chains.
+ * Register these via registry.registerAll(DEFAULT_TOKENS).
+ */
+export const DEFAULT_TOKENS = [
+    {
+        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 1,
+        name: "USD Coin",
+    },
+    {
+        address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 137,
+        name: "USD Coin",
+    },
+    {
+        address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 42161,
+        name: "USD Coin",
+    },
+];
+/**
+ * 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 const TESTNET_TOKENS = [
+    {
+        address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 11155111, // Sepolia
+        name: "USD Coin (Testnet)",
+    },
+    {
+        address: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 421614, // Arbitrum Sepolia
+        name: "USD Coin (Testnet)",
+    },
+    {
+        address: "0x31d0220469e10c4E71834a79b1f276d740d3768F",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 1301, // Unichain Sepolia
+        name: "USD Coin (Testnet)",
+    },
+    {
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        symbol: "USDC",
+        decimals: 6,
+        chainId: 84532, // Base Sepolia
+        name: "USD Coin (Testnet)",
+    },
+];
+/**
+ * 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 const MAINNET_TOKENS = [
+    // --- USDT ---
+    { address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", symbol: "USDT", decimals: 6, chainId: 1, name: "Tether USD" },
+    { address: "0xFd086bC7CD5C481DCC9C85EBE478A1C0b69FCbb9", symbol: "USDT", decimals: 6, chainId: 42161, name: "Tether USD" },
+    { address: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58", symbol: "USDT", decimals: 6, chainId: 10, name: "Tether USD" },
+    // --- WETH ---
+    { address: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", symbol: "WETH", decimals: 18, chainId: 42161, name: "Wrapped Ether" },
+    { address: "0x4200000000000000000000000000000000000006", symbol: "WETH", decimals: 18, chainId: 10, name: "Wrapped Ether" },
+    // --- WBTC ---
+    { address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599", symbol: "WBTC", decimals: 8, chainId: 1, name: "Wrapped BTC" },
+    { address: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f", symbol: "WBTC", decimals: 8, chainId: 42161, name: "Wrapped BTC" },
+    // --- DAI ---
+    { address: "0x6B175474E89094C44Da98b954EedeAC495271d0F", symbol: "DAI", decimals: 18, chainId: 1, name: "Dai Stablecoin" },
+    { address: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1", symbol: "DAI", decimals: 18, chainId: 42161, name: "Dai Stablecoin" },
+    { address: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1", symbol: "DAI", decimals: 18, chainId: 10, name: "Dai Stablecoin" },
+];
+/**
+ * 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 function resolveFromSymbol(registry, symbol, chainId) {
+    const token = registry.get(symbol, chainId);
+    if (!token) {
+        throw new Error(`Target token ${symbol} is not registered for chain ID ${chainId}`);
+    }
+    return token.address;
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/shared/utils/erc20-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ERC-20 Utilities
+ *
+ * Lightweight pure functions for encoding ERC-20 contract calls
+ * without requiring full ethers.js/viem contract instances.
+ */
+export declare const ERC20_TRANSFER_SELECTOR = "0xa9059cbb";
+export declare const ERC20_BALANCEOF_SELECTOR = "0x70a08231";
+/**
+ * Encode an ERC-20 `transfer(address to, uint256 amount)` contract call.
+ *
+ * @param to - Recipient address
+ * @param amount - Amount in basic units (wei)
+ * @returns Hex data string for the transaction
+ */
+export declare function encodeTransferData(to: string, amount: bigint): `0x${string}`;
+/**
+ * Encode an ERC-20 `balanceOf(address account)` contract call.
+ *
+ * @param account - Address to check balance for
+ * @returns Hex data string for the eth_call
+ */
+export declare function encodeBalanceOfData(account: string): `0x${string}`;
+//# sourceMappingURL=erc20-utils.d.ts.map

package/dist/shared/utils/erc20-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/erc20-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAI5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAGlE"}

package/dist/shared/utils/erc20-utils.js

@@ -0,0 +1,31 @@
+/**
+ * ERC-20 Utilities
+ *
+ * Lightweight pure functions for encoding ERC-20 contract calls
+ * without requiring full ethers.js/viem contract instances.
+ */
+export const ERC20_TRANSFER_SELECTOR = "0xa9059cbb"; // keccak256("transfer(address,uint256)").slice(0, 10)
+export const ERC20_BALANCEOF_SELECTOR = "0x70a08231"; // keccak256("balanceOf(address)").slice(0, 10)
+/**
+ * Encode an ERC-20 `transfer(address to, uint256 amount)` contract call.
+ *
+ * @param to - Recipient address
+ * @param amount - Amount in basic units (wei)
+ * @returns Hex data string for the transaction
+ */
+export function encodeTransferData(to, amount) {
+    const paddedTo = to.toLowerCase().replace("0x", "").padStart(64, "0");
+    const paddedAmount = amount.toString(16).padStart(64, "0");
+    return `${ERC20_TRANSFER_SELECTOR}${paddedTo}${paddedAmount}`;
+}
+/**
+ * Encode an ERC-20 `balanceOf(address account)` contract call.
+ *
+ * @param account - Address to check balance for
+ * @returns Hex data string for the eth_call
+ */
+export function encodeBalanceOfData(account) {
+    const paddedAccount = account.toLowerCase().replace("0x", "").padStart(64, "0");
+    return `${ERC20_BALANCEOF_SELECTOR}${paddedAccount}`;
+}
+//# sourceMappingURL=erc20-utils.js.map

package/dist/shared/utils/erc20-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20-utils.js","sourceRoot":"","sources":["../../../src/shared/utils/erc20-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC,CAAC,sDAAsD;AAC3G,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC,CAAC,+CAA+C;AAErG;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,MAAc;IACzD,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,GAAG,uBAAuB,GAAG,QAAQ,GAAG,YAAY,EAAmB,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChF,OAAO,GAAG,wBAAwB,GAAG,aAAa,EAAmB,CAAC;AAC1E,CAAC"}

package/dist/shared/utils/retry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Retry Utility with Exponential Backoff
+ *
+ * Generic retry wrapper for async operations with configurable
+ * backoff, jitter, and retryable-error filtering.
+ *
+ * Stage 3 — Phase G (Production Hardening)
+ *
+ * USAGE:
+ *   const result = await withRetry(() => provider.getBlockNumber(), {
+ *       maxRetries: 3,
+ *       baseDelayMs: 1000,
+ *       onRetry: (err, attempt) => console.warn(`Retry ${attempt}: ${err.message}`),
+ *   });
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Base delay in ms before first retry (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay cap in ms (default: 10000) */
+    maxDelayMs?: number;
+    /**
+     * Predicate to decide if an error is retryable.
+     * Return `true` to retry, `false` to throw immediately.
+     * Default: retries all errors.
+     */
+    isRetryable?: (error: Error) => boolean;
+    /**
+     * Callback invoked before each retry attempt.
+     * Useful for logging.
+     */
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+/**
+ * Execute an async function with exponential backoff retry.
+ *
+ * Delay formula: `min(baseDelay * 2^attempt + jitter, maxDelay)`
+ *
+ * @param fn       - Async function to execute
+ * @param options  - Retry configuration
+ * @returns The result of `fn()` on success
+ * @throws The last error after all retries are exhausted, or immediately for non-retryable errors
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Check if an RPC/network error is transient and worth retrying.
+ *
+ * Retryable conditions:
+ * - Timeout errors
+ * - HTTP 429 (Too Many Requests)
+ * - HTTP 502/503/504 (Bad Gateway / Service Unavailable / Gateway Timeout)
+ * - Connection refused / reset
+ * - "ECONNRESET", "ETIMEDOUT", "ENOTFOUND"
+ */
+export declare function isTransientNetworkError(error: Error): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/shared/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IACzB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAQD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAyB7D"}

package/dist/shared/utils/retry.js

@@ -0,0 +1,104 @@
+/**
+ * Retry Utility with Exponential Backoff
+ *
+ * Generic retry wrapper for async operations with configurable
+ * backoff, jitter, and retryable-error filtering.
+ *
+ * Stage 3 — Phase G (Production Hardening)
+ *
+ * USAGE:
+ *   const result = await withRetry(() => provider.getBlockNumber(), {
+ *       maxRetries: 3,
+ *       baseDelayMs: 1000,
+ *       onRetry: (err, attempt) => console.warn(`Retry ${attempt}: ${err.message}`),
+ *   });
+ */
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 10_000,
+};
+/**
+ * Execute an async function with exponential backoff retry.
+ *
+ * Delay formula: `min(baseDelay * 2^attempt + jitter, maxDelay)`
+ *
+ * @param fn       - Async function to execute
+ * @param options  - Retry configuration
+ * @returns The result of `fn()` on success
+ * @throws The last error after all retries are exhausted, or immediately for non-retryable errors
+ */
+export async function withRetry(fn, options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_OPTIONS.maxRetries;
+    const baseDelayMs = options.baseDelayMs ?? DEFAULT_OPTIONS.baseDelayMs;
+    const maxDelayMs = options.maxDelayMs ?? DEFAULT_OPTIONS.maxDelayMs;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            lastError = error;
+            // Check if we've exhausted retries
+            if (attempt >= maxRetries) {
+                break;
+            }
+            // Check if error is retryable
+            if (options.isRetryable && !options.isRetryable(error)) {
+                break;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+            const jitter = Math.random() * baseDelayMs * 0.5;
+            const delay = Math.min(exponentialDelay + jitter, maxDelayMs);
+            // Notify before sleeping
+            if (options.onRetry) {
+                options.onRetry(error, attempt + 1, delay);
+            }
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Check if an RPC/network error is transient and worth retrying.
+ *
+ * Retryable conditions:
+ * - Timeout errors
+ * - HTTP 429 (Too Many Requests)
+ * - HTTP 502/503/504 (Bad Gateway / Service Unavailable / Gateway Timeout)
+ * - Connection refused / reset
+ * - "ECONNRESET", "ETIMEDOUT", "ENOTFOUND"
+ */
+export function isTransientNetworkError(error) {
+    const message = error.message.toLowerCase();
+    // Common transient patterns
+    const transientPatterns = [
+        "timeout",
+        "econnreset",
+        "econnrefused",
+        "etimedout",
+        "enotfound",
+        "socket hang up",
+        "network error",
+        "fetch failed",
+        "429",
+        "too many requests",
+        "502",
+        "503",
+        "504",
+        "bad gateway",
+        "service unavailable",
+        "gateway timeout",
+        "rate limit",
+    ];
+    return transientPatterns.some(pattern => message.includes(pattern));
+}
+/**
+ * Sleep for the given number of milliseconds.
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/shared/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0BH,MAAM,eAAe,GAA4D;IAC7E,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,MAAM;CACrB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC,UAAU,CAAC;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,eAAe,CAAC,WAAW,CAAC;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC,UAAU,CAAC;IAEpE,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,SAAS,GAAG,KAAK,CAAC;YAElB,mCAAmC;YACnC,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBACxB,MAAM;YACV,CAAC;YAED,8BAA8B;YAC9B,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM;YACV,CAAC;YAED,oDAAoD;YACpD,MAAM,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,GAAG,GAAG,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;YAE9D,yBAAyB;YACzB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,MAAM,SAAU,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAY;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAE5C,4BAA4B;IAC5B,MAAM,iBAAiB,GAAG;QACtB,SAAS;QACT,YAAY;QACZ,cAAc;QACd,WAAW;QACX,WAAW;QACX,gBAAgB;QAChB,eAAe;QACf,cAAc;QACd,KAAK;QACL,mBAAmB;QACnB,KAAK;QACL,KAAK;QACL,KAAK;QACL,aAAa;QACb,qBAAqB;QACrB,iBAAiB;QACjB,YAAY;KACf,CAAC;IAEF,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/shared/wallet-manager/viem-signer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * viem Wallet Signer
+ *
+ * Implements WalletSigner interface using viem's privateKeyToAccount + createWalletClient.
+ * Provides real transaction signing and EIP-712 typed data signing.
+ *
+ * Stage 3 — Live Integration (Phase B)
+ *
+ * USAGE:
+ *   import { createViemSignerFactory } from "./viem-signer";
+ *   const wallet = new WalletManager("0xprivatekey...", createViemSignerFactory());
+ *   const address = wallet.getAddress();
+ *   const sig = await wallet.signMessage("hello");
+ */
+import { type PrivateKeyAccount } from "viem/accounts";
+import type { Address, ChainId } from "../../types/common";
+import type { WalletSigner } from "./wallet-manager";
+/**
+ * WalletSigner implementation backed by viem's WalletClient.
+ */
+export declare class ViemSigner implements WalletSigner {
+    private account;
+    private walletClient;
+    private chain;
+    constructor(privateKey: `0x${string}`, chainId: ChainId, rpcUrl?: string);
+    /**
+     * Get the wallet address derived from the private key.
+     */
+    getAddress(): Address;
+    /**
+     * Sign an arbitrary message using personal_sign.
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Sign EIP-712 typed data.
+     *
+     * Used for creating intent signatures compatible with IntentSettlement.sol.
+     */
+    signTypedData(domain: object, types: object, value: object): Promise<string>;
+    /**
+     * Send a transaction through this wallet (sign + broadcast).
+     *
+     * Returns the transaction hash.
+     */
+    sendTransaction(tx: {
+        to: Address;
+        data?: `0x${string}`;
+        value?: bigint;
+        gas?: bigint;
+    }): Promise<string>;
+    /**
+     * Get the underlying viem account (for advanced use cases).
+     */
+    getAccount(): PrivateKeyAccount;
+}
+/**
+ * Factory function that creates ViemSigner instances.
+ *
+ * Pass this to WalletManager constructor as the signerFactory.
+ *
+ * Factory for creating viem signers.
+ * Suitable for injection into WalletManager.
+ *
+ * @param rpcMapper - Optional function to provide RPC URLs for specific chains
+ *                    (required for `sendTransaction` live execution).
+ */
+export declare function createViemSignerFactory(rpcMapper?: (chainId: ChainId) => string | undefined): (privateKey: string, chainId: ChainId) => WalletSigner;
+//# sourceMappingURL=viem-signer.d.ts.map

package/dist/shared/wallet-manager/viem-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-signer.d.ts","sourceRoot":"","sources":["../../../src/shared/wallet-manager/viem-signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC3C,OAAO,CAAC,OAAO,CAAoB;IAEnC,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,KAAK,CAAoB;gBAErB,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IAuBxE;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInD;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBlF;;;;OAIG;IACG,eAAe,CAAC,EAAE,EAAE;QACtB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYnB;;OAEG;IACH,UAAU,IAAI,iBAAiB;CAGlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GACrD,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,YAAY,CAKxD"}

package/dist/shared/wallet-manager/viem-signer.js

@@ -0,0 +1,116 @@
+/**
+ * viem Wallet Signer
+ *
+ * Implements WalletSigner interface using viem's privateKeyToAccount + createWalletClient.
+ * Provides real transaction signing and EIP-712 typed data signing.
+ *
+ * Stage 3 — Live Integration (Phase B)
+ *
+ * USAGE:
+ *   import { createViemSignerFactory } from "./viem-signer";
+ *   const wallet = new WalletManager("0xprivatekey...", createViemSignerFactory());
+ *   const address = wallet.getAddress();
+ *   const sig = await wallet.signMessage("hello");
+ */
+import { createWalletClient, http, defineChain } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+/**
+ * WalletSigner implementation backed by viem's WalletClient.
+ */
+export class ViemSigner {
+    account;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    walletClient;
+    chain;
+    constructor(privateKey, chainId, rpcUrl) {
+        this.account = privateKeyToAccount(privateKey);
+        // Build a minimal viem chain definition so viem includes the
+        // correct chainId in EIP-155 signatures and knows tx type parameters.
+        this.chain = rpcUrl
+            ? defineChain({
+                id: chainId,
+                name: `Chain ${chainId}`,
+                nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+                rpcUrls: {
+                    default: { http: [rpcUrl] },
+                },
+            })
+            : undefined;
+        this.walletClient = createWalletClient({
+            account: this.account,
+            chain: this.chain,
+            transport: http(rpcUrl || "http://offline-signer.local"),
+        });
+    }
+    /**
+     * Get the wallet address derived from the private key.
+     */
+    getAddress() {
+        return this.account.address;
+    }
+    /**
+     * Sign an arbitrary message using personal_sign.
+     */
+    async signMessage(message) {
+        return await this.walletClient.signMessage({ account: this.account, message });
+    }
+    /**
+     * Sign EIP-712 typed data.
+     *
+     * Used for creating intent signatures compatible with IntentSettlement.sol.
+     */
+    async signTypedData(domain, types, value) {
+        // Extract primary type from types (usually the first key that isn't EIP712Domain)
+        const primaryType = Object.keys(types).find((t) => t !== "EIP712Domain");
+        if (!primaryType) {
+            throw new Error("Could not determine primaryType from types");
+        }
+        return await this.walletClient.signTypedData({
+            account: this.account,
+            domain,
+            types: types,
+            primaryType,
+            message: value,
+        });
+    }
+    /**
+     * Send a transaction through this wallet (sign + broadcast).
+     *
+     * Returns the transaction hash.
+     */
+    async sendTransaction(tx) {
+        return await this.walletClient.sendTransaction({
+            account: this.account,
+            to: tx.to,
+            data: tx.data,
+            value: tx.value,
+            gas: tx.gas,
+            // Pass the configured chain; null bypasses per-call chain ID check for offline signers
+            chain: this.chain ?? null,
+        });
+    }
+    /**
+     * Get the underlying viem account (for advanced use cases).
+     */
+    getAccount() {
+        return this.account;
+    }
+}
+/**
+ * Factory function that creates ViemSigner instances.
+ *
+ * Pass this to WalletManager constructor as the signerFactory.
+ *
+ * Factory for creating viem signers.
+ * Suitable for injection into WalletManager.
+ *
+ * @param rpcMapper - Optional function to provide RPC URLs for specific chains
+ *                    (required for `sendTransaction` live execution).
+ */
+export function createViemSignerFactory(rpcMapper) {
+    return (privateKey, chainId) => {
+        const rpcUrl = rpcMapper ? rpcMapper(chainId) : undefined;
+        return new ViemSigner(privateKey, chainId, rpcUrl);
+    };
+}
+//# sourceMappingURL=viem-signer.js.map

package/dist/shared/wallet-manager/viem-signer.js.map

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