@walletchan/rpc 0.1.0

package/dist/rpcServer.js

@@ -0,0 +1,59 @@
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { formatChains } from "./chains.js";
+import { log } from "./logger.js";
+import { handleRpcRequest } from "./rpcHandler.js";
+import { errorResponse } from "./rpcTypes.js";
+import { formatRuntimeSkill } from "./skill.js";
+export function startRpcServer(config, context) {
+    const app = new Hono();
+    async function handleRpc(c) {
+        try {
+            const body = await c.req.json();
+            if (Array.isArray(body)) {
+                if (body.length === 0) {
+                    return c.json(errorResponse(null, -32600, "Invalid empty JSON-RPC batch"), 400);
+                }
+                const responses = await Promise.all(body.map((request) => handleRpcRequest(request, context)));
+                return c.json(responses.filter((response) => response !== null));
+            }
+            const response = await handleRpcRequest(body, context);
+            return response ? c.json(response) : c.body(null, 204);
+        }
+        catch {
+            return c.json(errorResponse(null, -32700, "Parse error"), 400);
+        }
+    }
+    app.post("/", handleRpc);
+    app.post("/rpc", handleRpc);
+    app.get("/skill.md", (c) => skillResponse(c, config, context));
+    app.get("/SKILL.md", (c) => skillResponse(c, config, context));
+    app.get("/health", (c) => c.json({
+        ok: true,
+        connected: context.wallet.connected,
+        activeChainId: context.getActiveChain().chainId,
+        chains: context.chains.map((chain) => ({
+            name: chain.name,
+            chainId: chain.chainId,
+        })),
+    }));
+    app.get("/session", (c) => c.json({
+        connected: context.wallet.connected,
+        activeChainId: context.getActiveChain().chainId,
+        chains: formatChains(context.chains),
+        session: context.wallet.connected ? context.wallet.getSessionInfo() : null,
+    }));
+    return serve({
+        fetch: app.fetch,
+        hostname: config.host,
+        port: config.port,
+    }, () => {
+        log.dim("RPC server ready");
+    });
+}
+function skillResponse(c, config, context) {
+    return c.body(formatRuntimeSkill(config, context), 200, {
+        "Content-Type": "text/markdown; charset=utf-8",
+    });
+}
+//# sourceMappingURL=rpcServer.js.map

package/dist/rpcServer.js.map

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

package/dist/rpcTypes.d.ts

@@ -0,0 +1,29 @@
+export type JsonRpcId = string | number | null;
+export interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: JsonRpcId;
+    method?: unknown;
+    params?: unknown;
+}
+export interface JsonRpcErrorPayload {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result?: unknown;
+    error?: JsonRpcErrorPayload;
+}
+export declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+export declare function successResponse(id: JsonRpcId, result: unknown): JsonRpcResponse;
+export declare function errorResponse(id: JsonRpcId, code: number, message: string, data?: unknown): JsonRpcResponse;
+export declare function getErrorCode(error: unknown, fallback?: number): number;
+export declare function getErrorMessage(error: unknown, fallback?: string): string;
+export declare function getParamsArray(request: JsonRpcRequest): unknown[];
+//# sourceMappingURL=rpcTypes.d.ts.map

package/dist/rpcTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcTypes.d.ts","sourceRoot":"","sources":["../src/rpcTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aAEZ,IAAI,CAAC,EAAE,OAAO;gBAFd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,OAAO,YAAA;CAIjC;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe,CAE/E;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,eAAe,CAMjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAS,GAAG,MAAM,CAItE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAmB,GAAG,MAAM,CAInF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,EAAE,CAIjE"}

package/dist/rpcTypes.js

@@ -0,0 +1,39 @@
+export class RpcError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+    }
+}
+export function successResponse(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+export function errorResponse(id, code, message, data) {
+    return {
+        jsonrpc: "2.0",
+        id,
+        error: data === undefined ? { code, message } : { code, message, data },
+    };
+}
+export function getErrorCode(error, fallback = -32000) {
+    if (error instanceof RpcError)
+        return error.code;
+    const code = error?.code;
+    return typeof code === "number" && Number.isInteger(code) ? code : fallback;
+}
+export function getErrorMessage(error, fallback = "Request failed") {
+    if (error instanceof Error && error.message)
+        return error.message;
+    const message = error?.message;
+    return typeof message === "string" && message ? message : fallback;
+}
+export function getParamsArray(request) {
+    if (request.params === undefined)
+        return [];
+    if (Array.isArray(request.params))
+        return request.params;
+    throw new RpcError(-32602, "params must be an array");
+}
+//# sourceMappingURL=rpcTypes.js.map

package/dist/rpcTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcTypes.js","sourceRoot":"","sources":["../src/rpcTypes.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAU;IAGhC,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,EAAa,EAAE,MAAe;IAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAa,EACb,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC,KAAK;IAC5D,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACjD,MAAM,IAAI,GAAI,KAA4B,EAAE,IAAI,CAAC;IACjD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,QAAQ,GAAG,gBAAgB;IACzE,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IAClE,MAAM,OAAO,GAAI,KAA+B,EAAE,OAAO,CAAC;IAC1D,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IACzD,MAAM,IAAI,QAAQ,CAAC,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACxD,CAAC"}

package/dist/skill.d.ts

@@ -0,0 +1,4 @@
+import type { CliConfig } from "./cli.js";
+import type { RpcContext } from "./rpcHandler.js";
+export declare function formatRuntimeSkill(config: CliConfig, context: RpcContext): string;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiBlD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAsIjF"}

package/dist/skill.js

@@ -0,0 +1,158 @@
+import { formatChains, toHexChainId } from "./chains.js";
+const APPROVAL_METHODS = [
+    "eth_sendTransaction",
+    "personal_sign",
+    "eth_signTypedData_v3",
+    "eth_signTypedData_v4",
+];
+const BATCH_METHODS = [
+    "wallet_getCapabilities",
+    "wallet_sendCalls",
+    "wallet_getCallsStatus",
+    "wallet_showCallsStatus",
+];
+export function formatRuntimeSkill(config, context) {
+    const rpcUrl = `http://${config.host}:${config.port}`;
+    const activeChain = context.getActiveChain();
+    const activeChainId = toHexChainId(activeChain.chainId);
+    const session = getSession(context);
+    const accounts = session?.accounts || [];
+    const preferredAccount = accounts[0] || "0xYourApprovedAccount";
+    const methods = context.includeBatching
+        ? [...APPROVAL_METHODS, ...BATCH_METHODS]
+        : APPROVAL_METHODS;
+    return `---
+name: walletchan-rpc
+description: Use when sending Ethereum JSON-RPC, Foundry, or ERC-5792 wallet_sendCalls requests through a local WalletChan RPC server with user wallet approval.
+---
+
+# WalletChan RPC
+
+This skill was served by a live WalletChan RPC instance. Use the runtime details below as authoritative for this session.
+
+## Runtime
+
+- RPC URL: \`${rpcUrl}\`
+- Connected: \`${context.wallet.connected ? "yes" : "no"}\`
+- Approved accounts: ${accounts.length > 0 ? accounts.map((account) => `\`${account}\``).join(", ") : "`none`"}
+- Active chain: \`${activeChain.name}\` (${activeChain.chainId}, \`${activeChainId}\`)
+- Configured chains: \`${formatChains(context.chains)}\`
+- Batching: \`${context.includeBatching ? "enabled" : "disabled"}\`
+- Wallet: \`${session?.peerName || "unknown"}\`${session?.peerUrl ? ` (${session.peerUrl})` : ""}
+
+## How To Use
+
+Send standard JSON-RPC over HTTP to \`${rpcUrl}\` or \`${rpcUrl}/rpc\`. Any JSON-RPC client can use this endpoint, including JavaScript code, shell scripts, viem, ethers, Foundry, or an AI agent.
+
+Use these wallet methods:
+
+${methods.map((method) => `- \`${method}\``).join("\n")}
+
+Read-only JSON-RPC methods may be forwarded to the configured upstream RPC. Local account and chain methods include \`eth_accounts\`, \`eth_requestAccounts\`, \`eth_chainId\`, \`net_version\`, \`web3_clientVersion\`, and \`wallet_switchEthereumChain\`.
+
+## Safety Rules
+
+- Use \`eth_sendTransaction\` for sends. Never use \`eth_sendRawTransaction\`, \`eth_sign\`, or \`eth_signTransaction\`.
+- Every send/sign/batch request opens a user approval prompt in the connected wallet.
+- If the wallet rejects a request, report the rejection to the user. Do not retry rejected sends automatically.
+- Use only an approved account from \`eth_accounts\` as \`from\` or Foundry \`--sender\`.
+- If a request targets a different configured chain, include the target \`chainId\` or call \`wallet_switchEthereumChain\` first.
+- WalletConnect sessions persist across CLI restarts. Ask the user to restart with \`--force-new-session\` only when they want a fresh pairing.
+
+## Discovery
+
+\`\`\`bash
+curl -s ${rpcUrl}/health
+curl -s ${rpcUrl}/session
+curl -s ${rpcUrl}/SKILL.md
+\`\`\`
+
+\`\`\`bash
+curl -s ${rpcUrl} \\
+  -H 'content-type: application/json' \\
+  -d '{"jsonrpc":"2.0","id":1,"method":"eth_accounts","params":[]}'
+\`\`\`
+
+## wallet_sendCalls
+
+When batching is enabled, prefer \`wallet_sendCalls\` for related write actions that should be reviewed and submitted together. The goal is to reduce the number of wallet approval popups for one user intent while preserving a clear wallet confirmation.
+
+Use \`wallet_sendCalls\` when:
+
+- A later call depends on an earlier call in the same user intent.
+- The user asks for several related sends or contract writes, such as sending tokens or ETH to multiple addresses, distributing payments, claiming several rewards, minting several NFTs from the same collection, or doing several same-protocol actions.
+- The flow would otherwise require multiple approvals for one task, such as \`approve + swap\`, \`approve + stake\`, \`approve + deposit\`, \`approve + bridge\`, or \`claim + stake\`.
+- The calls must target one chain and use the same approved \`from\` account.
+
+For dependent actions such as \`approve + swap\` or \`approve + stake\`, set \`atomicRequired: true\` so the wallet must execute all calls atomically or none of the material effects should land onchain. Put calls in execution order: approval first, then the action that consumes the approval. For independent but related actions, such as sending tokens to multiple recipients, still prefer one \`wallet_sendCalls\` request so the user reviews one batch instead of several popups.
+
+Do not use \`wallet_sendCalls\` for unrelated actions that the user should consider separately, for cross-chain flows, or as a blind retry after the user rejects a request. If the user query describes one cohesive task with multiple same-chain writes, batch it.
+
+After \`wallet_sendCalls\`, record the returned bundle ID. WalletChan returns an object with \`id\`; some wallets may call this \`batchId\`. Poll \`wallet_getCallsStatus\` with that ID until status is terminal, or use \`wallet_showCallsStatus\` to open the bundle's explorer view.
+
+\`\`\`json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "wallet_sendCalls",
+  "params": [
+    {
+      "version": "2.0.0",
+      "chainId": "${activeChainId}",
+      "from": "${preferredAccount}",
+      "atomicRequired": true,
+      "calls": [
+        {
+          "to": "0xTokenAddress",
+          "value": "0x0",
+          "data": "0xApproveCalldata"
+        },
+        {
+          "to": "0xSwapOrStakeContract",
+          "value": "0x0",
+          "data": "0xSwapOrStakeCalldata"
+        }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+## Optional Foundry Examples
+
+These examples are optional. WalletChan RPC is a standard JSON-RPC endpoint and is not restricted to Foundry.
+
+For a single call, \`cast send\` is often convenient because it avoids creating a full Foundry script. Use Foundry's unlocked-account path so Foundry sends \`eth_sendTransaction\` to WalletChan RPC:
+
+\`\`\`bash
+cast send 0xContractAddress \\
+  "transfer(address,uint256)" 0xRecipient 1000000000000000000 \\
+  --rpc-url ${rpcUrl} \\
+  --unlocked \\
+  --from ${preferredAccount}
+\`\`\`
+
+For larger flows that already live in a script, use the same unlocked-account path:
+
+\`\`\`bash
+forge script script/Deploy.s.sol \\
+  --rpc-url ${rpcUrl} \\
+  --broadcast \\
+  --unlocked \\
+  --sender ${preferredAccount}
+\`\`\`
+
+Do not pass a private key for this flow.
+`;
+}
+function getSession(context) {
+    if (!context.wallet.connected)
+        return null;
+    try {
+        return context.wallet.getSessionInfo();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,gBAAgB,GAAG;IACvB,qBAAqB;IACrB,eAAe;IACf,sBAAsB;IACtB,sBAAsB;CACvB,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,wBAAwB;IACxB,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;CACzB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,OAAmB;IACvE,MAAM,MAAM,GAAG,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,uBAAuB,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe;QACrC,CAAC,CAAC,CAAC,GAAG,gBAAgB,EAAE,GAAG,aAAa,CAAC;QACzC,CAAC,CAAC,gBAAgB,CAAC;IAErB,OAAO;;;;;;;;;;;eAWM,MAAM;iBACJ,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;uBACjC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ;oBAC1F,WAAW,CAAC,IAAI,OAAO,WAAW,CAAC,OAAO,OAAO,aAAa;yBACzD,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;gBACrC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;cAClD,OAAO,EAAE,QAAQ,IAAI,SAAS,KAAK,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE;;;;wCAIxD,MAAM,WAAW,MAAM;;;;EAI7D,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;UAgB7C,MAAM;UACN,MAAM;UACN,MAAM;;;;UAIN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA8BI,aAAa;iBAChB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4BnB,MAAM;;WAET,gBAAgB;;;;;;;cAOb,MAAM;;;aAGP,gBAAgB;;;;CAI5B,CAAC;AACF,CAAC;AAED,SAAS,UAAU,CAAC,OAAmB;IACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/upstream.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeChain } from "./chains.js";
+import type { JsonRpcRequest, JsonRpcResponse } from "./rpcTypes.js";
+export declare function forwardToUpstream(request: JsonRpcRequest, chain: RuntimeChain, timeoutMs: number): Promise<JsonRpcResponse>;
+//# sourceMappingURL=upstream.d.ts.map

package/dist/upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.d.ts","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrE,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAuB1B"}

package/dist/upstream.js

@@ -0,0 +1,21 @@
+import { errorResponse } from "./rpcTypes.js";
+export async function forwardToUpstream(request, chain, timeoutMs) {
+    try {
+        const response = await fetch(chain.rpcUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ ...request, jsonrpc: "2.0" }),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const data = (await response.json());
+        if (!response.ok) {
+            return errorResponse(request.id ?? null, -32603, `Upstream RPC error on ${chain.name}: ${response.status} ${response.statusText}`);
+        }
+        return data;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to reach upstream RPC";
+        return errorResponse(request.id ?? null, -32603, `Upstream RPC error on ${chain.name}: ${message}`);
+    }
+}
+//# sourceMappingURL=upstream.js.map

package/dist/upstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.js","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,KAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACpD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,aAAa,CAClB,OAAO,CAAC,EAAE,IAAI,IAAI,EAClB,CAAC,KAAK,EACN,yBAAyB,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACjF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC;QACxF,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/dist/walletConnect.d.ts

@@ -0,0 +1,44 @@
+import type { RuntimeChain } from "./chains.js";
+export interface WalletConnectBridgeConfig {
+    chains: RuntimeChain[];
+    forceNewSession: boolean;
+    host: string;
+    includeBatching: boolean;
+    port: number;
+    projectId: string;
+    requestTimeoutSeconds: number;
+}
+export interface SessionInfo {
+    accounts: string[];
+    peerName: string;
+    peerUrl: string;
+    topic: string;
+}
+export declare class WalletConnectBridge {
+    private readonly config;
+    private client;
+    private session;
+    private readonly methods;
+    constructor(config: WalletConnectBridgeConfig);
+    get connected(): boolean;
+    get sessionTopic(): string | null;
+    init(): Promise<SessionInfo | null>;
+    createSessionProposal(): Promise<{
+        uri: string;
+        approval: () => Promise<SessionInfo>;
+    }>;
+    request(chainId: number, method: string, params: unknown[]): Promise<unknown>;
+    getAccounts(chainId?: number): string[];
+    getSessionInfo(): SessionInfo;
+    disconnectStored(message?: string): Promise<void>;
+    close(): void;
+    private attachListeners;
+    private validateSession;
+    private restoreStoredSession;
+    private disconnectStoredSessions;
+    private disconnectTopic;
+    private getClient;
+    private getSession;
+    private getChainLabel;
+}
+//# sourceMappingURL=walletConnect.d.ts.map

package/dist/walletConnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletConnect.d.ts","sourceRoot":"","sources":["../src/walletConnect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgChD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAKlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;gBAEN,MAAM,EAAE,yBAAyB;IAM9D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA8BnC,qBAAqB,IAAI,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;KACtC,CAAC;IA4BI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBnF,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAKvC,cAAc,IAAI,WAAW;IAUvB,gBAAgB,CAAC,OAAO,SAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,oBAAoB;YAgBd,wBAAwB;YAkBxB,eAAe;IAY7B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,aAAa;CAItB"}