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

package/dist/rpc-proxy/dispatcher.js

@@ -0,0 +1,54 @@
+/**
+ * RpcDispatcher -- Orchestrates JSON-RPC method classification and handler routing.
+ *
+ * Entry point for the RPC proxy: classifies each method as intercept, passthrough,
+ * or unsupported, then delegates to the appropriate handler.
+ *
+ * Supports both single and batch JSON-RPC 2.0 requests.
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md
+ */
+import { jsonRpcError, isNotification, JSON_RPC_ERRORS, } from './json-rpc.js';
+import { classifyMethod } from './method-handlers.js';
+// -- RpcDispatcher -----------------------------------------------------------
+export class RpcDispatcher {
+    methodHandlers;
+    passthrough;
+    constructor(deps) {
+        this.methodHandlers = deps.methodHandlers;
+        this.passthrough = deps.passthrough;
+    }
+    /**
+     * Dispatch a single JSON-RPC request to the appropriate handler.
+     */
+    async dispatch(request, ctx, pipelineDeps) {
+        const id = request.id ?? null;
+        const classification = classifyMethod(request.method, this.passthrough);
+        switch (classification) {
+            case 'intercept':
+                return this.methodHandlers.handle(request.method, request.params, id, ctx, pipelineDeps);
+            case 'passthrough':
+                return this.passthrough.forward(request, ctx.network);
+            case 'unsupported':
+                return jsonRpcError(id, JSON_RPC_ERRORS.METHOD_NOT_FOUND, 'Method not found: ' + request.method);
+        }
+    }
+    /**
+     * Dispatch a batch of JSON-RPC requests.
+     *
+     * All requests are dispatched concurrently via Promise.all.
+     * Notifications (requests without `id`) are dispatched for side effects
+     * but their responses are filtered from the result per JSON-RPC 2.0 spec.
+     */
+    async dispatchBatch(requests, ctx, pipelineDeps) {
+        const results = await Promise.all(requests.map(async (request) => ({
+            response: await this.dispatch(request, ctx, pipelineDeps),
+            isNotification: isNotification(request),
+        })));
+        // Filter out notification responses per JSON-RPC 2.0 spec
+        return results
+            .filter((r) => !r.isNotification)
+            .map((r) => r.response);
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/rpc-proxy/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,GAGhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAatD,+EAA+E;AAE/E,MAAM,OAAO,aAAa;IACP,cAAc,CAAoB;IAClC,WAAW,CAAiB;IAE7C,YAAY,IAAuB;QACjC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAuB,EACvB,GAAmB,EACnB,YAAiB;QAEjB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC;QAC9B,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAExE,QAAQ,cAAc,EAAE,CAAC;YACvB,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAC/B,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAA+B,EACvC,EAAE,EACF,GAAG,EACH,YAAY,CACb,CAAC;YAEJ,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAExD,KAAK,aAAa;gBAChB,OAAO,YAAY,CACjB,EAAE,EACF,eAAe,CAAC,gBAAgB,EAChC,oBAAoB,GAAG,OAAO,CAAC,MAAM,CACtC,CAAC;QACN,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,QAA0B,EAC1B,GAAmB,EACnB,YAAiB;QAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/B,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC;YACzD,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC;SACxC,CAAC,CAAC,CACJ,CAAC;QAEF,0DAA0D;QAC1D,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+/**
+ * RPC Proxy module barrel export.
+ *
+ * Core engine for the EVM JSON-RPC proxy that intercepts signing methods
+ * and proxies read methods to upstream RPC endpoints.
+ */
+export { type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, type JsonRpcErrorResponse, type JsonRpcError, type ParseResult, jsonRpcSuccess, jsonRpcError, parseJsonRpcBody, isNotification, JSON_RPC_ERRORS, } from './json-rpc.js';
+export { RpcTransactionAdapter, toHexChainId, hexToDecimal, type EthTransactionParams, type RpcTransactionRequest, } from './tx-adapter.js';
+export { CompletionWaiter } from './completion-waiter.js';
+export { SyncPipelineExecutor } from './sync-pipeline.js';
+export { NonceTracker } from './nonce-tracker.js';
+export { RpcPassthrough, PASSTHROUGH_METHODS } from './passthrough.js';
+export { RpcMethodHandlers, classifyMethod, INTERCEPT_METHODS, type HandlerContext, } from './method-handlers.js';
+export { RpcDispatcher, type RpcDispatcherDeps } from './dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/rpc-proxy/index.js

@@ -0,0 +1,15 @@
+/**
+ * RPC Proxy module barrel export.
+ *
+ * Core engine for the EVM JSON-RPC proxy that intercepts signing methods
+ * and proxies read methods to upstream RPC endpoints.
+ */
+export { jsonRpcSuccess, jsonRpcError, parseJsonRpcBody, isNotification, JSON_RPC_ERRORS, } from './json-rpc.js';
+export { RpcTransactionAdapter, toHexChainId, hexToDecimal, } from './tx-adapter.js';
+export { CompletionWaiter } from './completion-waiter.js';
+export { SyncPipelineExecutor } from './sync-pipeline.js';
+export { NonceTracker } from './nonce-tracker.js';
+export { RpcPassthrough, PASSTHROUGH_METHODS } from './passthrough.js';
+export { RpcMethodHandlers, classifyMethod, INTERCEPT_METHODS, } from './method-handlers.js';
+export { RpcDispatcher } from './dispatcher.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpc-proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAOL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,YAAY,GAGb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,78 @@
+/**
+ * JSON-RPC 2.0 protocol utilities for the RPC proxy.
+ *
+ * Provides request parsing, response building, and standard error codes
+ * following the JSON-RPC 2.0 specification (https://www.jsonrpc.org/specification).
+ *
+ * Key spec compliance (Pitfall 9):
+ * - `id` type is preserved exactly (number, string, or null)
+ * - Success response has `result` but NOT `error`
+ * - Error response has `error` but NOT `result`
+ * - Notification = request without `id` field (not same as id=null)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-PITFALLS.md (Pitfall 9)
+ */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown[];
+    id?: string | number | null;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcSuccessResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result: unknown;
+}
+export interface JsonRpcErrorResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    error: JsonRpcError;
+}
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+export declare const JSON_RPC_ERRORS: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly SERVER_ERROR: -32000;
+};
+/**
+ * Build a JSON-RPC 2.0 success response.
+ * Result and error are mutually exclusive per spec.
+ */
+export declare function jsonRpcSuccess(id: string | number | null, result: unknown): JsonRpcSuccessResponse;
+/**
+ * Build a JSON-RPC 2.0 error response.
+ * Result and error are mutually exclusive per spec.
+ */
+export declare function jsonRpcError(id: string | number | null, code: number, message: string, data?: unknown): JsonRpcErrorResponse;
+export type ParseResult = {
+    type: 'single';
+    request: JsonRpcRequest;
+} | {
+    type: 'batch';
+    requests: JsonRpcRequest[];
+} | {
+    type: 'error';
+    response: JsonRpcErrorResponse;
+};
+/**
+ * Parse a JSON-RPC 2.0 request body (already JSON-parsed).
+ *
+ * Returns single request, batch of requests, or error response.
+ * Validates `jsonrpc === '2.0'` and `method` is string.
+ * Does NOT validate `params` (method handlers do that).
+ */
+export declare function parseJsonRpcBody(body: unknown): ParseResult;
+/**
+ * A notification is a request without an `id` field.
+ * Note: `id: null` is valid and is NOT a notification.
+ */
+export declare function isNotification(req: JsonRpcRequest): boolean;
+//# sourceMappingURL=json-rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/json-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAI5E,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAIX;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,OAAO,GACd,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,oBAAoB,CAMtB;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAItD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CA8C3D;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAE3D"}

package/dist/rpc-proxy/json-rpc.js

@@ -0,0 +1,123 @@
+/**
+ * JSON-RPC 2.0 protocol utilities for the RPC proxy.
+ *
+ * Provides request parsing, response building, and standard error codes
+ * following the JSON-RPC 2.0 specification (https://www.jsonrpc.org/specification).
+ *
+ * Key spec compliance (Pitfall 9):
+ * - `id` type is preserved exactly (number, string, or null)
+ * - Success response has `result` but NOT `error`
+ * - Error response has `error` but NOT `result`
+ * - Notification = request without `id` field (not same as id=null)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-PITFALLS.md (Pitfall 9)
+ */
+// ── Error Codes ───────────────────────────────────────────────────
+export const JSON_RPC_ERRORS = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    SERVER_ERROR: -32000,
+};
+// ── Response Builders ─────────────────────────────────────────────
+/**
+ * Build a JSON-RPC 2.0 success response.
+ * Result and error are mutually exclusive per spec.
+ */
+export function jsonRpcSuccess(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+/**
+ * Build a JSON-RPC 2.0 error response.
+ * Result and error are mutually exclusive per spec.
+ */
+export function jsonRpcError(id, code, message, data) {
+    const error = { code, message };
+    if (data !== undefined) {
+        error.data = data;
+    }
+    return { jsonrpc: '2.0', id, error };
+}
+// ── Body Parsing ──────────────────────────────────────────────────
+/**
+ * Parse a JSON-RPC 2.0 request body (already JSON-parsed).
+ *
+ * Returns single request, batch of requests, or error response.
+ * Validates `jsonrpc === '2.0'` and `method` is string.
+ * Does NOT validate `params` (method handlers do that).
+ */
+export function parseJsonRpcBody(body) {
+    if (body === null || body === undefined || typeof body !== 'object') {
+        return {
+            type: 'error',
+            response: jsonRpcError(null, JSON_RPC_ERRORS.INVALID_REQUEST, 'Invalid Request'),
+        };
+    }
+    // Batch request (array)
+    if (Array.isArray(body)) {
+        if (body.length === 0) {
+            return {
+                type: 'error',
+                response: jsonRpcError(null, JSON_RPC_ERRORS.INVALID_REQUEST, 'Empty batch array'),
+            };
+        }
+        const requests = [];
+        for (const item of body) {
+            const validated = validateSingleRequest(item);
+            if (!validated) {
+                // Skip invalid items in batch (spec allows partial processing)
+                // but for simplicity, return error for any invalid item
+                return {
+                    type: 'error',
+                    response: jsonRpcError(null, JSON_RPC_ERRORS.INVALID_REQUEST, 'Invalid Request in batch'),
+                };
+            }
+            requests.push(validated);
+        }
+        return { type: 'batch', requests };
+    }
+    // Single request
+    const validated = validateSingleRequest(body);
+    if (!validated) {
+        return {
+            type: 'error',
+            response: jsonRpcError(null, JSON_RPC_ERRORS.INVALID_REQUEST, 'Invalid Request'),
+        };
+    }
+    return { type: 'single', request: validated };
+}
+// ── Notification Detection ────────────────────────────────────────
+/**
+ * A notification is a request without an `id` field.
+ * Note: `id: null` is valid and is NOT a notification.
+ */
+export function isNotification(req) {
+    return req.id === undefined;
+}
+// ── Helpers ───────────────────────────────────────────────────────
+function validateSingleRequest(obj) {
+    if (obj === null || obj === undefined || typeof obj !== 'object' || Array.isArray(obj)) {
+        return null;
+    }
+    const rec = obj;
+    if (rec.jsonrpc !== '2.0') {
+        return null;
+    }
+    if (typeof rec.method !== 'string') {
+        return null;
+    }
+    const request = {
+        jsonrpc: '2.0',
+        method: rec.method,
+    };
+    if (rec.params !== undefined) {
+        request.params = rec.params;
+    }
+    if ('id' in rec) {
+        request.id = rec.id;
+    }
+    return request;
+}
+//# sourceMappingURL=json-rpc.js.map

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

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

package/dist/rpc-proxy/method-handlers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * RPC Method Handlers -- Signing method intercept for the RPC proxy.
+ *
+ * Routes intercepted JSON-RPC methods to the appropriate WAIaaS pipeline:
+ * - eth_sendTransaction → 6-stage pipeline via SyncPipelineExecutor
+ * - eth_signTransaction → sign-only pipeline
+ * - personal_sign, eth_sign → sign-message pipeline (personal)
+ * - eth_signTypedData_v4 → sign-message pipeline (typedData)
+ * - eth_accounts → session wallet address
+ * - eth_chainId → URL-derived hex chain ID
+ * - eth_sendRawTransaction → explicit rejection (SIGN-07)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md
+ */
+import { type JsonRpcResponse } from './json-rpc.js';
+import type { RpcTransactionAdapter } from './tx-adapter.js';
+import type { SyncPipelineExecutor } from './sync-pipeline.js';
+import type { NonceTracker } from './nonce-tracker.js';
+import type { RpcPassthrough } from './passthrough.js';
+export declare const INTERCEPT_METHODS: Set<string>;
+/**
+ * Classify a JSON-RPC method into intercept, passthrough, or unsupported.
+ */
+export declare function classifyMethod(method: string, passthrough: RpcPassthrough): 'intercept' | 'passthrough' | 'unsupported';
+export interface HandlerContext {
+    walletId: string;
+    walletAddress: string;
+    chainId: number;
+    network: string;
+    chain: string;
+    sessionId?: string;
+}
+export declare class RpcMethodHandlers {
+    private syncPipeline;
+    private txAdapter;
+    constructor(syncPipeline: SyncPipelineExecutor, txAdapter: RpcTransactionAdapter, _nonceTracker: NonceTracker);
+    /**
+     * Handle an intercepted JSON-RPC method.
+     *
+     * @param method - JSON-RPC method name
+     * @param params - Method parameters
+     * @param id - Request id (preserved in response)
+     * @param ctx - Handler context (wallet, chain, session)
+     * @param deps - Pipeline dependencies
+     * @returns JSON-RPC response
+     */
+    handle(method: string, params: unknown[] | undefined, id: string | number | null, ctx: HandlerContext, deps: any): Promise<JsonRpcResponse>;
+    private handleEthSendTransaction;
+    private handleEthSignTransaction;
+    private handlePersonalSign;
+    private handleEthSign;
+    private handleEthSignTypedDataV4;
+}
+//# sourceMappingURL=method-handlers.d.ts.map

package/dist/rpc-proxy/method-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-handlers.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/method-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,eAAO,MAAM,iBAAiB,aAW5B,CAAC;AAIH;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,cAAc,GAC1B,WAAW,GAAG,aAAa,GAAG,aAAa,CAI7C;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,SAAS;gBADT,YAAY,EAAE,oBAAoB,EAClC,SAAS,EAAE,qBAAqB,EACxC,aAAa,EAAE,YAAY;IAG7B;;;;;;;;;OASG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAC7B,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,eAAe,CAAC;YAgDb,wBAAwB;YAiCxB,wBAAwB;YA2BxB,kBAAkB;YAyBlB,aAAa;YAyBb,wBAAwB;CAwBvC"}

package/dist/rpc-proxy/method-handlers.js

@@ -0,0 +1,171 @@
+/**
+ * RPC Method Handlers -- Signing method intercept for the RPC proxy.
+ *
+ * Routes intercepted JSON-RPC methods to the appropriate WAIaaS pipeline:
+ * - eth_sendTransaction → 6-stage pipeline via SyncPipelineExecutor
+ * - eth_signTransaction → sign-only pipeline
+ * - personal_sign, eth_sign → sign-message pipeline (personal)
+ * - eth_signTypedData_v4 → sign-message pipeline (typedData)
+ * - eth_accounts → session wallet address
+ * - eth_chainId → URL-derived hex chain ID
+ * - eth_sendRawTransaction → explicit rejection (SIGN-07)
+ *
+ * @see .planning/research/m31-14-rpc-proxy-ARCHITECTURE.md
+ */
+import { jsonRpcSuccess, jsonRpcError, JSON_RPC_ERRORS, } from './json-rpc.js';
+import { toHexChainId } from './tx-adapter.js';
+import { executeSignOnly } from '../pipeline/sign-only.js';
+import { executeSignMessage } from '../pipeline/sign-message.js';
+// ── Intercept Methods ─────────────────────────────────────────────
+export const INTERCEPT_METHODS = new Set([
+    'eth_sendTransaction',
+    'eth_signTransaction',
+    'eth_accounts',
+    'eth_requestAccounts',
+    'eth_chainId',
+    'net_version',
+    'personal_sign',
+    'eth_sign',
+    'eth_signTypedData_v4',
+    'eth_sendRawTransaction',
+]);
+// ── Method Classification ─────────────────────────────────────────
+/**
+ * Classify a JSON-RPC method into intercept, passthrough, or unsupported.
+ */
+export function classifyMethod(method, passthrough) {
+    if (INTERCEPT_METHODS.has(method))
+        return 'intercept';
+    if (passthrough.isPassthrough(method))
+        return 'passthrough';
+    return 'unsupported';
+}
+// ── RpcMethodHandlers ─────────────────────────────────────────────
+export class RpcMethodHandlers {
+    syncPipeline;
+    txAdapter;
+    constructor(syncPipeline, txAdapter, _nonceTracker) {
+        this.syncPipeline = syncPipeline;
+        this.txAdapter = txAdapter;
+    }
+    /**
+     * Handle an intercepted JSON-RPC method.
+     *
+     * @param method - JSON-RPC method name
+     * @param params - Method parameters
+     * @param id - Request id (preserved in response)
+     * @param ctx - Handler context (wallet, chain, session)
+     * @param deps - Pipeline dependencies
+     * @returns JSON-RPC response
+     */
+    async handle(method, params, id, ctx, deps) {
+        switch (method) {
+            // ── Account Discovery ─────────────────────────
+            case 'eth_accounts':
+            case 'eth_requestAccounts':
+                return jsonRpcSuccess(id, [ctx.walletAddress]);
+            // ── Chain Identity ────────────────────────────
+            case 'eth_chainId':
+                return jsonRpcSuccess(id, toHexChainId(ctx.chainId));
+            case 'net_version':
+                return jsonRpcSuccess(id, ctx.chainId.toString());
+            // ── Transaction Signing + Submission ──────────
+            case 'eth_sendTransaction':
+                return this.handleEthSendTransaction(params, id, ctx, deps);
+            // ── Transaction Signing (no broadcast) ────────
+            case 'eth_signTransaction':
+                return this.handleEthSignTransaction(params, id, ctx, deps);
+            // ── Message Signing ───────────────────────────
+            case 'personal_sign':
+                return this.handlePersonalSign(params, id, ctx, deps);
+            case 'eth_sign':
+                return this.handleEthSign(params, id, ctx, deps);
+            case 'eth_signTypedData_v4':
+                return this.handleEthSignTypedDataV4(params, id, ctx, deps);
+            // ── Explicit Rejection ────────────────────────
+            case 'eth_sendRawTransaction':
+                return jsonRpcError(id, JSON_RPC_ERRORS.INVALID_PARAMS, 'eth_sendRawTransaction is not supported. Use eth_sendTransaction instead — WAIaaS signs transactions internally.');
+            // ── Unsupported ───────────────────────────────
+            default:
+                return jsonRpcError(id, JSON_RPC_ERRORS.METHOD_NOT_FOUND, `Method ${method} not supported`);
+        }
+    }
+    // ── Private Handlers ──────────────────────────────────────────
+    async handleEthSendTransaction(params, id, ctx, deps) {
+        try {
+            const txParams = (params?.[0] ?? {});
+            const request = this.txAdapter.convert(txParams, ctx.network);
+            // Build pipeline context
+            const pipelineCtx = {
+                ...deps,
+                walletId: ctx.walletId,
+                resolvedNetwork: ctx.network,
+                request,
+                txId: '', // Will be generated by stage1Validate
+                sessionId: ctx.sessionId,
+            };
+            const txHash = await this.syncPipeline.execute(pipelineCtx);
+            return jsonRpcSuccess(id, txHash);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Transaction execution failed';
+            // ASYNC-04: Include txId in timeout error data for client recovery
+            const txIdMatch = message.match(/Transaction ([a-f0-9-]+) timed out/);
+            if (txIdMatch) {
+                return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message, { txId: txIdMatch[1] });
+            }
+            return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message);
+        }
+    }
+    async handleEthSignTransaction(params, id, ctx, deps) {
+        try {
+            const txParams = (params?.[0] ?? {});
+            // Build a serialized unsigned transaction string for sign-only pipeline
+            // The sign-only pipeline expects a serialized transaction hex
+            const txHex = JSON.stringify(txParams);
+            const result = await executeSignOnly(deps, ctx.walletId, { transaction: txHex, chain: ctx.chain, network: ctx.network }, ctx.sessionId);
+            return jsonRpcSuccess(id, result.signedTransaction);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Transaction signing failed';
+            return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message);
+        }
+    }
+    async handlePersonalSign(params, id, ctx, deps) {
+        try {
+            // personal_sign params: [message, address]
+            const message = params?.[0] ?? '';
+            const result = await executeSignMessage(deps, ctx.walletId, ctx.chain, { signType: 'personal', message }, ctx.sessionId);
+            return jsonRpcSuccess(id, result.signature);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Message signing failed';
+            return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message);
+        }
+    }
+    async handleEthSign(params, id, ctx, deps) {
+        try {
+            // eth_sign params: [address, message] -- reversed from personal_sign!
+            const msgData = params?.[1] ?? '';
+            const result = await executeSignMessage(deps, ctx.walletId, ctx.chain, { signType: 'personal', message: msgData }, ctx.sessionId);
+            return jsonRpcSuccess(id, result.signature);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Message signing failed';
+            return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message);
+        }
+    }
+    async handleEthSignTypedDataV4(params, id, ctx, deps) {
+        try {
+            // eth_signTypedData_v4 params: [address, typedDataJsonString]
+            const typedDataJson = params?.[1] ?? '';
+            const result = await executeSignMessage(deps, ctx.walletId, ctx.chain, { signType: 'typedData', message: typedDataJson }, ctx.sessionId);
+            return jsonRpcSuccess(id, result.signature);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Typed data signing failed';
+            return jsonRpcError(id, JSON_RPC_ERRORS.SERVER_ERROR, message);
+        }
+    }
+}
+//# sourceMappingURL=method-handlers.js.map

package/dist/rpc-proxy/method-handlers.js.map

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

package/dist/rpc-proxy/nonce-tracker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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)
+ */
+export declare class NonceTracker {
+    private tracker;
+    /**
+     * Get the next nonce for an address.
+     * Returns max(onchainNonce, localNextNonce) and increments local counter.
+     */
+    getNextNonce(address: string, onchainNonce: number): number;
+    /**
+     * Confirm a nonce has been included on-chain.
+     * Removes from pending set.
+     */
+    confirmNonce(address: string, nonce: number): void;
+    /**
+     * Rollback a nonce allocation (transaction failed before submission).
+     * Removes from pending and recalculates nextNonce.
+     */
+    rollbackNonce(address: string, nonce: number): void;
+    /**
+     * Get adjusted transaction count for eth_getTransactionCount('pending') interception.
+     * Returns max of on-chain pending count and local next nonce.
+     */
+    getAdjustedTransactionCount(address: string, onchainPendingCount: number): number;
+    /**
+     * Clear all tracking state.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=nonce-tracker.d.ts.map

package/dist/rpc-proxy/nonce-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce-tracker.d.ts","sourceRoot":"","sources":["../../src/rpc-proxy/nonce-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAmC;IAElD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAgB3D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBnD;;;OAGG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,MAAM;IAOjF;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}