@waiaas/daemon 2.11.0-rc → 2.11.0-rc.13

package/dist/rpc-proxy/nonce-tracker.js

@@ -0,0 +1,80 @@
+/**
+ * NonceTracker -- Local nonce management for sequential eth_sendTransaction.
+ *
+ * Addresses Pitfall 4 (Forge Script Multi-TX Nonce): When Forge sends
+ * multiple transactions in rapid succession, each needs a unique nonce.
+ * The on-chain nonce may not have updated yet, so we track locally.
+ *
+ * Per-address tracking with case-insensitive comparison.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-PITFALLS.md (Pitfall 4)
+ */
+// ── NonceTracker ──────────────────────────────────────────────────
+export class NonceTracker {
+    tracker = new Map();
+    /**
+     * Get the next nonce for an address.
+     * Returns max(onchainNonce, localNextNonce) and increments local counter.
+     */
+    getNextNonce(address, onchainNonce) {
+        const key = address.toLowerCase();
+        let state = this.tracker.get(key);
+        if (!state) {
+            state = { nextNonce: onchainNonce, pending: new Set() };
+            this.tracker.set(key, state);
+        }
+        // Use max of on-chain and local (on-chain may have advanced)
+        const nonce = Math.max(onchainNonce, state.nextNonce);
+        state.nextNonce = nonce + 1;
+        state.pending.add(nonce);
+        return nonce;
+    }
+    /**
+     * Confirm a nonce has been included on-chain.
+     * Removes from pending set.
+     */
+    confirmNonce(address, nonce) {
+        const key = address.toLowerCase();
+        const state = this.tracker.get(key);
+        if (state) {
+            state.pending.delete(nonce);
+        }
+    }
+    /**
+     * Rollback a nonce allocation (transaction failed before submission).
+     * Removes from pending and recalculates nextNonce.
+     */
+    rollbackNonce(address, nonce) {
+        const key = address.toLowerCase();
+        const state = this.tracker.get(key);
+        if (!state)
+            return;
+        state.pending.delete(nonce);
+        // Recalculate nextNonce: max of remaining pending + 1, or the rolled-back nonce
+        if (state.pending.size === 0) {
+            state.nextNonce = nonce;
+        }
+        else {
+            const maxPending = Math.max(...state.pending);
+            state.nextNonce = maxPending + 1;
+        }
+    }
+    /**
+     * Get adjusted transaction count for eth_getTransactionCount('pending') interception.
+     * Returns max of on-chain pending count and local next nonce.
+     */
+    getAdjustedTransactionCount(address, onchainPendingCount) {
+        const key = address.toLowerCase();
+        const state = this.tracker.get(key);
+        if (!state)
+            return onchainPendingCount;
+        return Math.max(onchainPendingCount, state.nextNonce);
+    }
+    /**
+     * Clear all tracking state.
+     */
+    clear() {
+        this.tracker.clear();
+    }
+}
+//# sourceMappingURL=nonce-tracker.js.map

package/dist/rpc-proxy/nonce-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce-tracker.js","sourceRoot":"","sources":["../../src/rpc-proxy/nonce-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,qEAAqE;AAErE,MAAM,OAAO,YAAY;IACf,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD;;;OAGG;IACH,YAAY,CAAC,OAAe,EAAE,YAAoB;QAChD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACtD,KAAK,CAAC,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;QAC5B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAe,EAAE,KAAa;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,OAAe,EAAE,KAAa;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5B,gFAAgF;QAChF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9C,KAAK,CAAC,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,2BAA2B,CAAC,OAAe,EAAE,mBAA2B;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,mBAAmB,CAAC;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/rpc-proxy/passthrough.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RpcPassthrough -- Read method proxying to upstream RPC via RpcPool.
+ *
+ * All read-only EVM JSON-RPC methods are forwarded directly to the
+ * upstream RPC endpoint. Signing and state-changing methods are NOT
+ * included -- those are handled by RpcMethodHandlers.
+ *
+ * PASS-01: Read methods pass through to upstream RPC
+ * PASS-02: Unsupported methods return -32601 (handled by caller)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md
+ */
+import type { RpcPool } from '@waiaas/core';
+import { type JsonRpcRequest, type JsonRpcResponse } from './json-rpc.js';
+/**
+ * Set of all read-only EVM JSON-RPC methods that should be proxied
+ * directly to the upstream RPC endpoint.
+ */
+export declare const PASSTHROUGH_METHODS: Set<string>;
+export declare class RpcPassthrough {
+    private rpcPool;
+    constructor(rpcPool: RpcPool);
+    /**
+     * Check if a method should be passthrough-proxied.
+     */
+    isPassthrough(method: string): boolean;
+    /**
+     * Forward a JSON-RPC request to the upstream RPC endpoint.
+     * Preserves the original request id in the response.
+     *
+     * @param request - The JSON-RPC request to forward
+     * @param network - Network slug for RpcPool URL resolution
+     * @returns JSON-RPC response (success or error)
+     */
+    forward(request: JsonRpcRequest, network: string): Promise<JsonRpcResponse>;
+}
+//# sourceMappingURL=passthrough.d.ts.map

package/dist/rpc-proxy/passthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/passthrough.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAIvB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAoB9B,CAAC;AAIH,qBAAa,cAAc;IACb,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEpC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAmClF"}

package/dist/rpc-proxy/passthrough.js

@@ -0,0 +1,86 @@
+/**
+ * RpcPassthrough -- Read method proxying to upstream RPC via RpcPool.
+ *
+ * All read-only EVM JSON-RPC methods are forwarded directly to the
+ * upstream RPC endpoint. Signing and state-changing methods are NOT
+ * included -- those are handled by RpcMethodHandlers.
+ *
+ * PASS-01: Read methods pass through to upstream RPC
+ * PASS-02: Unsupported methods return -32601 (handled by caller)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md
+ */
+import { jsonRpcError, JSON_RPC_ERRORS, } from './json-rpc.js';
+// ── Passthrough Methods ───────────────────────────────────────────
+/**
+ * Set of all read-only EVM JSON-RPC methods that should be proxied
+ * directly to the upstream RPC endpoint.
+ */
+export const PASSTHROUGH_METHODS = new Set([
+    'eth_call',
+    'eth_getBalance',
+    'eth_blockNumber',
+    'eth_getBlockByNumber',
+    'eth_getBlockByHash',
+    'eth_getTransactionByHash',
+    'eth_getTransactionReceipt',
+    'eth_estimateGas',
+    'eth_gasPrice',
+    'eth_feeHistory',
+    'eth_maxPriorityFeePerGas',
+    'eth_getCode',
+    'eth_getStorageAt',
+    'eth_getLogs',
+    'eth_getTransactionCount',
+    'net_version',
+    'web3_clientVersion',
+    'eth_getBlockTransactionCountByNumber',
+    'eth_getBlockTransactionCountByHash',
+]);
+// ── RpcPassthrough ────────────────────────────────────────────────
+export class RpcPassthrough {
+    rpcPool;
+    constructor(rpcPool) {
+        this.rpcPool = rpcPool;
+    }
+    /**
+     * Check if a method should be passthrough-proxied.
+     */
+    isPassthrough(method) {
+        return PASSTHROUGH_METHODS.has(method);
+    }
+    /**
+     * Forward a JSON-RPC request to the upstream RPC endpoint.
+     * Preserves the original request id in the response.
+     *
+     * @param request - The JSON-RPC request to forward
+     * @param network - Network slug for RpcPool URL resolution
+     * @returns JSON-RPC response (success or error)
+     */
+    async forward(request, network) {
+        const requestId = request.id ?? null;
+        const url = this.rpcPool.getUrl(network);
+        try {
+            const resp = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    method: request.method,
+                    params: request.params ?? [],
+                    id: request.id ?? 1,
+                }),
+            });
+            if (!resp.ok) {
+                return jsonRpcError(requestId, JSON_RPC_ERRORS.SERVER_ERROR, `Upstream RPC error: ${resp.status}`);
+            }
+            const upstream = (await resp.json());
+            // Preserve original request id (upstream may use different id)
+            return { ...upstream, jsonrpc: '2.0', id: requestId };
+        }
+        catch (err) {
+            return jsonRpcError(requestId, JSON_RPC_ERRORS.SERVER_ERROR, `RPC proxy upstream error: ${err instanceof Error ? err.message : 'unknown'}`);
+        }
+    }
+}
+//# sourceMappingURL=passthrough.js.map

package/dist/rpc-proxy/passthrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough.js","sourceRoot":"","sources":["../../src/rpc-proxy/passthrough.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,YAAY,EACZ,eAAe,GAGhB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS;IACjD,UAAU;IACV,gBAAgB;IAChB,iBAAiB;IACjB,sBAAsB;IACtB,oBAAoB;IACpB,0BAA0B;IAC1B,2BAA2B;IAC3B,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,0BAA0B;IAC1B,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,yBAAyB;IACzB,aAAa;IACb,oBAAoB;IACpB,sCAAsC;IACtC,oCAAoC;CACrC,CAAC,CAAC;AAEH,qEAAqE;AAErE,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC;;OAEG;IACH,aAAa,CAAC,MAAc;QAC1B,OAAO,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB,EAAE,OAAe;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;oBAC5B,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC;iBACpB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,OAAO,YAAY,CACjB,SAAS,EACT,eAAe,CAAC,YAAY,EAC5B,uBAAuB,IAAI,CAAC,MAAM,EAAE,CACrC,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChE,+DAA+D;YAC/D,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAqB,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CACjB,SAAS,EACT,eAAe,CAAC,YAAY,EAC5B,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/rpc-proxy/sync-pipeline.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SyncPipelineExecutor -- Synchronous wrapper around the 6-stage pipeline.
+ *
+ * Converts the existing fire-and-forget pipeline flow into a synchronous
+ * request-response model for JSON-RPC. Three paths:
+ *
+ * 1. INSTANT: stage1-6 run directly, return txHash
+ * 2. DELAY: stage1-3.5 run, stage4Wait throws PIPELINE_HALTED,
+ *    delegate to CompletionWaiter for long-poll
+ * 3. APPROVAL: same as DELAY but with longer timeout
+ *
+ * Anti-Pattern 1: Does NOT modify any existing pipeline code.
+ * The PIPELINE_HALTED catch pattern keeps existing flow untouched.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md (Pattern 4)
+ */
+import { type PipelineContext } from '../pipeline/stages.js';
+import type { CompletionWaiter } from './completion-waiter.js';
+import type { SettingsService } from '../infrastructure/settings/settings-service.js';
+export declare class SyncPipelineExecutor {
+    private completionWaiter;
+    private settingsService?;
+    constructor(completionWaiter: CompletionWaiter, settingsService?: SettingsService | undefined);
+    /**
+     * Execute the 6-stage pipeline synchronously.
+     *
+     * For INSTANT tier: runs all stages and returns txHash.
+     * For DELAY/APPROVAL tier: catches PIPELINE_HALTED and delegates
+     * to CompletionWaiter for EventBus-based completion waiting.
+     *
+     * @param ctx - Pipeline context (same as existing pipeline)
+     * @returns Transaction hash
+     */
+    execute(ctx: PipelineContext): Promise<string>;
+    /**
+     * Resolve timeout based on tier and settings.
+     */
+    private resolveTimeout;
+}
+//# sourceMappingURL=sync-pipeline.d.ts.map

package/dist/rpc-proxy/sync-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-pipeline.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/sync-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAItF,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,eAAe,CAAC;gBADhB,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,CAAC,EAAE,eAAe,YAAA;IAG3C;;;;;;;;;OASG;IACG,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BpD;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/rpc-proxy/sync-pipeline.js

@@ -0,0 +1,74 @@
+/**
+ * SyncPipelineExecutor -- Synchronous wrapper around the 6-stage pipeline.
+ *
+ * Converts the existing fire-and-forget pipeline flow into a synchronous
+ * request-response model for JSON-RPC. Three paths:
+ *
+ * 1. INSTANT: stage1-6 run directly, return txHash
+ * 2. DELAY: stage1-3.5 run, stage4Wait throws PIPELINE_HALTED,
+ *    delegate to CompletionWaiter for long-poll
+ * 3. APPROVAL: same as DELAY but with longer timeout
+ *
+ * Anti-Pattern 1: Does NOT modify any existing pipeline code.
+ * The PIPELINE_HALTED catch pattern keeps existing flow untouched.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md (Pattern 4)
+ */
+import { WAIaaSError } from '@waiaas/core';
+import { stage1Validate, stage2Auth, stage3Policy, stage3_5GasCondition, stage4Wait, stage5Execute, stage6Confirm, } from '../pipeline/stages.js';
+// ── SyncPipelineExecutor ──────────────────────────────────────────
+export class SyncPipelineExecutor {
+    completionWaiter;
+    settingsService;
+    constructor(completionWaiter, settingsService) {
+        this.completionWaiter = completionWaiter;
+        this.settingsService = settingsService;
+    }
+    /**
+     * Execute the 6-stage pipeline synchronously.
+     *
+     * For INSTANT tier: runs all stages and returns txHash.
+     * For DELAY/APPROVAL tier: catches PIPELINE_HALTED and delegates
+     * to CompletionWaiter for EventBus-based completion waiting.
+     *
+     * @param ctx - Pipeline context (same as existing pipeline)
+     * @returns Transaction hash
+     */
+    async execute(ctx) {
+        // Set source for audit trail (SEC-04 preparation for Phase 400)
+        ctx.source = 'rpc-proxy';
+        // Stages 1-3.5: always run directly
+        await stage1Validate(ctx);
+        await stage2Auth(ctx);
+        await stage3Policy(ctx);
+        await stage3_5GasCondition(ctx);
+        try {
+            await stage4Wait(ctx);
+        }
+        catch (err) {
+            // DELAY/APPROVAL: stage4Wait throws PIPELINE_HALTED
+            if (err instanceof WAIaaSError && err.code === 'PIPELINE_HALTED') {
+                const timeoutMs = this.resolveTimeout(ctx.tier);
+                return this.completionWaiter.waitForCompletion(ctx.txId, timeoutMs);
+            }
+            throw err; // Non-HALTED errors propagate
+        }
+        // INSTANT: stages 5-6 directly
+        await stage5Execute(ctx);
+        await stage6Confirm(ctx);
+        return ctx.submitResult?.txHash ?? '';
+    }
+    /**
+     * Resolve timeout based on tier and settings.
+     */
+    resolveTimeout(tier) {
+        if (tier === 'DELAY') {
+            const s = this.settingsService?.get('rpc_proxy.delay_timeout_seconds');
+            return (s ? parseInt(s, 10) : 300) * 1000;
+        }
+        // APPROVAL (default)
+        const s = this.settingsService?.get('rpc_proxy.approval_timeout_seconds');
+        return (s ? parseInt(s, 10) : 600) * 1000;
+    }
+}
+//# sourceMappingURL=sync-pipeline.js.map

package/dist/rpc-proxy/sync-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-pipeline.js","sourceRoot":"","sources":["../../src/rpc-proxy/sync-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAI/B,qEAAqE;AAErE,MAAM,OAAO,oBAAoB;IAErB;IACA;IAFV,YACU,gBAAkC,EAClC,eAAiC;QADjC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,oBAAe,GAAf,eAAe,CAAkB;IACxC,CAAC;IAEJ;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,CAAC,GAAoB;QAChC,gEAAgE;QAC/D,GAAW,CAAC,MAAM,GAAG,WAAW,CAAC;QAElC,oCAAoC;QACpC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oDAAoD;YACpD,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACjE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChD,OAAO,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,8BAA8B;QAC3C,CAAC;QAED,+BAA+B;QAC/B,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAEzB,OAAO,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAa;QAClC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,iCAAiC,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAC5C,CAAC;QACD,qBAAqB;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAC1E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC5C,CAAC;CACF"}

package/dist/rpc-proxy/tx-adapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * RPC Transaction Adapter.
+ *
+ * Converts eth_sendTransaction params to WAIaaS TransactionRequest format,
+ * classifying transactions by type based on the `to` and `data` fields.
+ *
+ * Classification rules (mirrors tx-parser.ts selectors):
+ * - to=null/undefined → CONTRACT_DEPLOY
+ * - to + data(0xa9059cbb) → TOKEN_TRANSFER
+ * - to + data(0x095ea7b3) → APPROVE
+ * - to + data(other) → CONTRACT_CALL
+ * - to + no data → TRANSFER
+ *
+ * Pitfall 14: 0x23b872dd (transferFrom) falls through to CONTRACT_CALL.
+ * NFT transfers are NOT classified here.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-PITFALLS.md (Pitfall 14)
+ */
+export interface EthTransactionParams {
+    from?: string;
+    to?: string | null;
+    value?: string;
+    data?: string;
+    gas?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    nonce?: string;
+}
+/**
+ * Simplified TransactionRequest output for the RPC proxy layer.
+ * These are passed to the 6-stage pipeline which validates via Zod.
+ */
+export type RpcTransactionRequest = {
+    type: 'TRANSFER';
+    to: string;
+    amount: string;
+    network: string;
+} | {
+    type: 'TOKEN_TRANSFER';
+    tokenAddress: string;
+    to: string;
+    amount: string;
+    network: string;
+} | {
+    type: 'APPROVE';
+    tokenAddress: string;
+    spenderAddress: string;
+    amount: string;
+    network: string;
+} | {
+    type: 'CONTRACT_CALL';
+    to: string;
+    data: string;
+    value: string;
+    network: string;
+} | {
+    type: 'CONTRACT_DEPLOY';
+    bytecode: string;
+    value: string;
+    network: string;
+};
+export declare class RpcTransactionAdapter {
+    /**
+     * Convert eth_sendTransaction params[0] to WAIaaS TransactionRequest.
+     */
+    convert(params: EthTransactionParams, network: string): RpcTransactionRequest;
+}
+/**
+ * Convert chain ID number to hex string for eth_chainId responses.
+ * e.g., 1 → "0x1", 8453 → "0x2105"
+ */
+export declare function toHexChainId(chainId: number): string;
+/**
+ * Convert hex value string to decimal string.
+ * Returns '0' if undefined, empty, or '0x'.
+ */
+export declare function hexToDecimal(hex?: string): string;
+//# sourceMappingURL=tx-adapter.d.ts.map

package/dist/rpc-proxy/tx-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-adapter.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/tx-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAIlF,qBAAa,qBAAqB;IAChC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB;CA2D9E;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQjD"}

package/dist/rpc-proxy/tx-adapter.js

@@ -0,0 +1,117 @@
+/**
+ * RPC Transaction Adapter.
+ *
+ * Converts eth_sendTransaction params to WAIaaS TransactionRequest format,
+ * classifying transactions by type based on the `to` and `data` fields.
+ *
+ * Classification rules (mirrors tx-parser.ts selectors):
+ * - to=null/undefined → CONTRACT_DEPLOY
+ * - to + data(0xa9059cbb) → TOKEN_TRANSFER
+ * - to + data(0x095ea7b3) → APPROVE
+ * - to + data(other) → CONTRACT_CALL
+ * - to + no data → TRANSFER
+ *
+ * Pitfall 14: 0x23b872dd (transferFrom) falls through to CONTRACT_CALL.
+ * NFT transfers are NOT classified here.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-PITFALLS.md (Pitfall 14)
+ */
+// ── ERC-20 Selectors ──────────────────────────────────────────────
+const ERC20_TRANSFER_SELECTOR = '0xa9059cbb';
+const ERC20_APPROVE_SELECTOR = '0x095ea7b3';
+// ── Adapter ───────────────────────────────────────────────────────
+export class RpcTransactionAdapter {
+    /**
+     * Convert eth_sendTransaction params[0] to WAIaaS TransactionRequest.
+     */
+    convert(params, network) {
+        const { to, data, value } = params;
+        // CONTRACT_DEPLOY: no `to` field
+        if (to === null || to === undefined) {
+            return {
+                type: 'CONTRACT_DEPLOY',
+                bytecode: data ?? '0x',
+                value: hexToDecimal(value),
+                network,
+            };
+        }
+        // Has data? Classify by selector
+        if (data && data !== '0x' && data.length >= 10) {
+            const selector = data.slice(0, 10).toLowerCase();
+            // ERC-20 transfer(address,uint256)
+            if (selector === ERC20_TRANSFER_SELECTOR) {
+                const { address: recipient, amount } = decodeAddressAndUint256(data);
+                return {
+                    type: 'TOKEN_TRANSFER',
+                    tokenAddress: to,
+                    to: recipient,
+                    amount,
+                    network,
+                };
+            }
+            // ERC-20 approve(address,uint256)
+            if (selector === ERC20_APPROVE_SELECTOR) {
+                const { address: spender, amount } = decodeAddressAndUint256(data);
+                return {
+                    type: 'APPROVE',
+                    tokenAddress: to,
+                    spenderAddress: spender,
+                    amount,
+                    network,
+                };
+            }
+            // Other contract call (including transferFrom 0x23b872dd → Pitfall 14)
+            return {
+                type: 'CONTRACT_CALL',
+                to,
+                data,
+                value: hexToDecimal(value),
+                network,
+            };
+        }
+        // Native TRANSFER: to + no data (or empty data)
+        return {
+            type: 'TRANSFER',
+            to,
+            amount: hexToDecimal(value),
+            network,
+        };
+    }
+}
+// ── Utility Functions ─────────────────────────────────────────────
+/**
+ * Convert chain ID number to hex string for eth_chainId responses.
+ * e.g., 1 → "0x1", 8453 → "0x2105"
+ */
+export function toHexChainId(chainId) {
+    return '0x' + chainId.toString(16);
+}
+/**
+ * Convert hex value string to decimal string.
+ * Returns '0' if undefined, empty, or '0x'.
+ */
+export function hexToDecimal(hex) {
+    if (!hex || hex === '0x' || hex === '0x0') {
+        return '0';
+    }
+    // Remove 0x prefix and parse as BigInt for large values
+    const cleaned = hex.startsWith('0x') ? hex.slice(2) : hex;
+    if (!cleaned)
+        return '0';
+    return BigInt('0x' + cleaned).toString(10);
+}
+// ── Internal Helpers ──────────────────────────────────────────────
+/**
+ * Decode ABI-encoded (address, uint256) from calldata after the 4-byte selector.
+ * Used for ERC-20 transfer(address,uint256) and approve(address,uint256).
+ */
+function decodeAddressAndUint256(data) {
+    // data format: 0x{selector:8}{address:64}{uint256:64}
+    // Address is bytes 10-74 (last 40 chars of 64-char padded address)
+    const addressHex = data.slice(34, 74); // skip 0x + 8 selector + 24 padding
+    const amountHex = data.slice(74, 138);
+    const address = '0x' + addressHex.toLowerCase();
+    const amount = amountHex ? BigInt('0x' + amountHex).toString(10) : '0';
+    return { address, amount };
+}
+//# sourceMappingURL=tx-adapter.js.map

package/dist/rpc-proxy/tx-adapter.js.map

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

package/dist/services/async-polling-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-polling-service.d.ts","sourceRoot":"","sources":["../../src/services/async-polling-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,iBAAiB,CAAC;AAI9F,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5F,4DAA4D;IAC5D,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wFAAwF;IACxF,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAJ7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;gBAGrD,EAAE,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,EACxC,SAAS,CAAC,EAAE,qBAAqB,YAAA;IAGpD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,mDAAmD;IACnD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAwEpC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;;OAMG;YACW,aAAa;IAiF3B;;;;;;;OAOG;YACW,aAAa;CA0G5B"}
+{"version":3,"file":"async-polling-service.d.ts","sourceRoot":"","sources":["../../src/services/async-polling-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,iBAAiB,CAAC;AAI9F,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5F,4DAA4D;IAC5D,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wFAAwF;IACxF,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAJ7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;gBAGrD,EAAE,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,EACxC,SAAS,CAAC,EAAE,qBAAqB,YAAA;IAGpD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,mDAAmD;IACnD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAwEpC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;OAMG;YACW,aAAa;IAiF3B;;;;;;;OAOG;YACW,aAAa;CAqN5B"}