@walletchan/rpc 0.1.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2021-2025 Apoorv Lathey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# WalletChan RPC
+
+Local Ethereum JSON-RPC server for WalletChan approvals.
+
+WalletChan RPC gives scripts, CLIs, and AI agents a standard local RPC endpoint while keeping transaction and signature approval inside the user's connected wallet. Tools send normal Ethereum JSON-RPC to `localhost`; [WalletChan](https://walletchan.com) receives the request over WalletConnect and asks the user to approve it.
+
+> Agent skill: [SKILL.md](https://raw.githubusercontent.com/apoorvlathey/walletchan/master/apps/walletchan-rpc/SKILL.md)
+
+Use it for:
+
+- Giving AI agents wallet access through a local RPC, with every send or signature still requiring user approval
+- Foundry, Cast, viem, ethers, shell scripts, or any JSON-RPC client
+- User-approved sends, signatures, and ERC-5792 `wallet_sendCalls` batches
+- WalletConnect-compatible wallets, including [WalletChan](https://walletchan.com) and many mobile wallets
+
+## Usage
+
+Published package, choose one:
+
+```bash
+# npm
+npx @walletchan/rpc --chain base
+
+# pnpm
+pnpm dlx @walletchan/rpc --chain base
+
+# Yarn
+yarn dlx @walletchan/rpc --chain base
+
+# Bun
+bunx @walletchan/rpc --chain base
+```
+
+From this repo:
+
+```bash
+pnpm dev:walletchan-rpc --chain base
+```
+
+On first use, the CLI copies the `wc:` URI to your clipboard, then prints a terminal QR code and raw URI.
+
+- WalletChan extension: open More -> WalletConnect and paste.
+- Mobile wallets: scan the QR code.
+
+The local RPC and `SKILL.md` endpoint start immediately at `http://127.0.0.1:4209` by default. Wallet requests become available after the wallet session is approved.
+
+## Agent Skill
+
+Agents can fetch the live local skill/manual from the running RPC:
+
+```bash
+curl http://127.0.0.1:4209/SKILL.md
+```
+
+The live skill includes the current RPC URL, approved account, active chain, and batching state.
+
+## Chains
+
+Named chains are built in:
+
+```bash
+walletchan-rpc --chain base
+walletchan-rpc --chain base --chain ethereum
+walletchan-rpc --chain polygon --port 4210
+```
+
+Supported names:
+
+| Name       | Chain ID | Default RPC                       |
+| ---------- | -------- | --------------------------------- |
+| `base`     | 8453     | `https://mainnet.base.org`        |
+| `ethereum` | 1        | `https://eth.llamarpc.com`        |
+| `megaeth`  | 4326     | `https://mainnet.megaeth.com/rpc` |
+| `polygon`  | 137      | `https://polygon-rpc.com`         |
+| `unichain` | 130      | `https://mainnet.unichain.org`    |
+
+Override RPC URLs per selected chain:
+
+```bash
+walletchan-rpc --chain base --rpc base=https://mainnet.base.org
+walletchan-rpc --chain 84532 --rpc 84532=https://sepolia.base.org
+```
+
+## Batching
+
+ERC-5792 batching is enabled by default. The WalletConnect proposal includes:
+
+- `wallet_getCapabilities`
+- `wallet_sendCalls`
+- `wallet_getCallsStatus`
+- `wallet_showCallsStatus`
+
+For wallets that do not support batching:
+
+```bash
+walletchan-rpc --chain base --skip-batching
+```
+
+## JSON-RPC Behavior
+
+Wallet requests are sent through WalletConnect:
+
+- `eth_sendTransaction`
+- `personal_sign`
+- `eth_signTypedData_v3`
+- `eth_signTypedData_v4`
+- ERC-5792 methods, unless `--skip-batching` is set
+
+Read-only and unknown methods are forwarded to the active chain's upstream RPC.
+
+Local methods:
+
+- `eth_accounts`
+- `eth_requestAccounts`
+- `eth_chainId`
+- `net_version`
+- `web3_clientVersion`
+- `wallet_switchEthereumChain`
+
+Rejected methods:
+
+- `eth_sendRawTransaction`
+- `eth_sign`
+- `eth_signTransaction`
+
+## Session Lifecycle
+
+WalletConnect sessions persist across CLI restarts by default. If a compatible stored session exists for the same host and port, the CLI reuses it and skips the QR/paste flow.
+
+To discard stored sessions and force a fresh pairing:
+
+```bash
+walletchan-rpc --chain base --force-new-session
+```
+
+Use `--force-new-session` when switching wallets, changing to a wallet that supports different methods, or intentionally revoking stale local session state.
+
+## Environment
+
+`WALLETCONNECT_PROJECT_ID` is optional. If omitted, the CLI uses WalletChan's default public WalletConnect project ID.
+
+## Foundry
+
+Foundry is optional. WalletChan RPC is a standard JSON-RPC endpoint and is not restricted to Foundry.
+
+For a single call, agents should usually prefer `cast send` because it avoids creating a full Foundry script. Use Foundry's unlocked-account path so it sends `eth_sendTransaction` to the local RPC:
+
+```bash
+cast send 0xContractAddress \
+  "transfer(address,uint256)" 0xRecipient 1000000000000000000 \
+  --rpc-url http://127.0.0.1:4209 \
+  --unlocked \
+  --from 0xYourConnectedAddress
+```
+
+For larger flows that already live in a script, use the same unlocked-account path:
+
+```bash
+forge script script/Deploy.s.sol \
+  --rpc-url http://127.0.0.1:4209 \
+  --broadcast \
+  --unlocked \
+  --sender 0xYourConnectedAddress
+```
+
+Do not pass a private key to Foundry for this flow. Signed raw transactions are rejected because they bypass WalletChan approval.

package/SKILL.md

@@ -0,0 +1,149 @@
+---
+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
+
+WalletChan RPC is a local JSON-RPC proxy for wallet-approved Ethereum transactions and signatures. A user starts the CLI, approves or reuses a WalletConnect session, and then agents or tools send standard JSON-RPC to the local server.
+
+Package README: https://github.com/apoorvlathey/walletchan/blob/master/apps/walletchan-rpc/README.md
+
+## Package Setup
+
+If WalletChan RPC is not already running, ask the user to start it. For Base mainnet:
+
+```bash
+# npm
+npx @walletchan/rpc --chain base
+
+# pnpm
+pnpm dlx @walletchan/rpc --chain base
+
+# Yarn
+yarn dlx @walletchan/rpc --chain base
+
+# Bun
+bunx @walletchan/rpc --chain base
+```
+
+The CLI starts the local RPC and `SKILL.md` endpoint immediately, then displays a WalletConnect QR/URI if no reusable session exists. The user must approve the WalletConnect session before wallet send/sign requests can succeed. Stored WalletConnect sessions are reused across CLI restarts by default.
+
+When the RPC is running, prefer the live local skill because it contains the exact URL, connected account, active chain, and batching state:
+
+```bash
+curl -s http://127.0.0.1:4209/SKILL.md
+```
+
+The default local RPC URL is `http://127.0.0.1:4209`; the user may choose a different port with `--port`.
+
+## How To Use
+
+Send JSON-RPC over HTTP to the local RPC URL, usually `http://127.0.0.1:4209` or `http://127.0.0.1:4209/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:
+
+- `eth_sendTransaction`
+- `personal_sign`
+- `eth_signTypedData_v3`
+- `eth_signTypedData_v4`
+- `wallet_sendCalls`
+- `wallet_getCallsStatus`
+- `wallet_showCallsStatus`
+- `wallet_getCapabilities`
+
+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 http://127.0.0.1:4209/health
+curl -s http://127.0.0.1:4209/session
+curl -s http://127.0.0.1:4209/SKILL.md
+```
+
+```bash
+curl -s http://127.0.0.1:4209 \
+  -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": "0x2105",
+      "from": "0xYourApprovedAccount",
+      "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 http://127.0.0.1:4209 \
+  --unlocked \
+  --from 0xYourApprovedAccount
+```
+
+For larger flows that already live in a script, use the same unlocked-account path:
+
+```bash
+forge script script/Deploy.s.sol \
+  --rpc-url http://127.0.0.1:4209 \
+  --broadcast \
+  --unlocked \
+  --sender 0xYourApprovedAccount
+```
+
+Do not pass a private key for this flow.

package/dist/chains.d.ts

@@ -0,0 +1,20 @@
+export interface RuntimeChain {
+    name: string;
+    displayName: string;
+    chainId: number;
+    rpcUrl: string;
+}
+interface BuiltInChain extends RuntimeChain {
+    aliases: string[];
+}
+export declare function toHexChainId(chainId: number): string;
+export declare function toCaip2(chainId: number): string;
+export declare function parseChainId(value: unknown): number | null;
+export declare function findBuiltInChain(value: string): BuiltInChain | null;
+export declare function resolveChainInput(value: string): RuntimeChain;
+export declare function resolveRuntimeChains(chainInputs: string[], rpcInputs: string[]): RuntimeChain[];
+export declare function getChainById(chains: RuntimeChain[], chainId: number): RuntimeChain | null;
+export declare function formatChain(chain: RuntimeChain): string;
+export declare function formatChains(chains: RuntimeChain[]): string;
+export {};
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,YAAa,SAAQ,YAAY;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwCD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAU1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAYnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAkB7D;AAkBD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EAAE,GAClB,YAAY,EAAE,CA8BhB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEzF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAE3D"}

package/dist/chains.js

@@ -0,0 +1,130 @@
+const BUILTIN_CHAINS = [
+    {
+        name: "base",
+        displayName: "Base",
+        chainId: 8453,
+        rpcUrl: "https://mainnet.base.org",
+        aliases: ["base-mainnet"],
+    },
+    {
+        name: "ethereum",
+        displayName: "Ethereum",
+        chainId: 1,
+        rpcUrl: "https://eth.llamarpc.com",
+        aliases: ["eth", "mainnet"],
+    },
+    {
+        name: "megaeth",
+        displayName: "MegaETH",
+        chainId: 4326,
+        rpcUrl: "https://mainnet.megaeth.com/rpc",
+        aliases: ["mega"],
+    },
+    {
+        name: "polygon",
+        displayName: "Polygon",
+        chainId: 137,
+        rpcUrl: "https://polygon-rpc.com",
+        aliases: ["matic"],
+    },
+    {
+        name: "unichain",
+        displayName: "Unichain",
+        chainId: 130,
+        rpcUrl: "https://mainnet.unichain.org",
+        aliases: ["uni"],
+    },
+];
+export function toHexChainId(chainId) {
+    return `0x${chainId.toString(16)}`;
+}
+export function toCaip2(chainId) {
+    return `eip155:${chainId}`;
+}
+export function parseChainId(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return value;
+    }
+    if (typeof value !== "string" || value.trim() === "")
+        return null;
+    const trimmed = value.trim();
+    const parsed = trimmed.startsWith("0x")
+        ? Number.parseInt(trimmed, 16)
+        : Number(trimmed);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
+}
+export function findBuiltInChain(value) {
+    const normalized = value.trim().toLowerCase();
+    const chainId = parseChainId(normalized);
+    return (BUILTIN_CHAINS.find((chain) => {
+        return (chain.name === normalized ||
+            chain.aliases.includes(normalized) ||
+            chain.chainId === chainId);
+    }) || null);
+}
+export function resolveChainInput(value) {
+    const builtIn = findBuiltInChain(value);
+    if (builtIn) {
+        const { aliases: _aliases, ...chain } = builtIn;
+        return chain;
+    }
+    const chainId = parseChainId(value);
+    if (!chainId) {
+        throw new Error(`Unknown chain "${value}". Use a built-in name or numeric chain ID.`);
+    }
+    return {
+        name: String(chainId),
+        displayName: `Chain ${chainId}`,
+        chainId,
+        rpcUrl: "",
+    };
+}
+function parseRpcOverride(value) {
+    const separator = value.indexOf("=");
+    if (separator <= 0 || separator === value.length - 1) {
+        throw new Error(`Invalid --rpc value "${value}". Use chain=url, e.g. base=https://...`);
+    }
+    const key = value.slice(0, separator).trim();
+    const rpcUrl = value.slice(separator + 1).trim();
+    const parsedUrl = new URL(rpcUrl);
+    if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+        throw new Error(`RPC URL for ${key} must use http or https`);
+    }
+    return { chain: resolveChainInput(key), rpcUrl };
+}
+export function resolveRuntimeChains(chainInputs, rpcInputs) {
+    const selectedInputs = chainInputs.length > 0 ? chainInputs : ["base"];
+    const chains = new Map();
+    for (const input of selectedInputs) {
+        const chain = resolveChainInput(input);
+        chains.set(chain.chainId, chain);
+    }
+    for (const input of rpcInputs) {
+        const override = parseRpcOverride(input);
+        const selected = chains.get(override.chain.chainId);
+        if (!selected) {
+            throw new Error(`RPC override ${override.chain.name}=... does not match a selected chain. Add --chain ${override.chain.name}.`);
+        }
+        chains.set(override.chain.chainId, {
+            ...selected,
+            rpcUrl: override.rpcUrl,
+        });
+    }
+    const resolved = Array.from(chains.values());
+    for (const chain of resolved) {
+        if (!chain.rpcUrl) {
+            throw new Error(`Missing RPC URL for chain ${chain.name}. Add --rpc ${chain.name}=https://...`);
+        }
+    }
+    return resolved;
+}
+export function getChainById(chains, chainId) {
+    return chains.find((chain) => chain.chainId === chainId) || null;
+}
+export function formatChain(chain) {
+    return `${chain.name}(${chain.chainId})`;
+}
+export function formatChains(chains) {
+    return chains.map(formatChain).join(", ");
+}
+//# sourceMappingURL=chains.js.map

package/dist/chains.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import { type RuntimeChain } from "./chains.js";
+export interface CliConfig {
+    chains: RuntimeChain[];
+    forceNewSession: boolean;
+    host: string;
+    includeBatching: boolean;
+    port: number;
+    projectId: string;
+    requestTimeoutSeconds: number;
+    upstreamTimeoutMs: number;
+}
+export declare function parseCli(argv: string[]): CliConfig;
+export declare function formatCliSummary(config: CliConfig): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKpF,MAAM,WAAW,SAAS;IACxB,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;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA0BD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAgElD;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAO1D"}

package/dist/cli.js

@@ -0,0 +1,78 @@
+import { Command } from "commander";
+import { formatChains, resolveRuntimeChains } from "./chains.js";
+import { style } from "./logger.js";
+const DEFAULT_PROJECT_ID = "56262dba600174595278ffdf73ceb06f";
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+function parsePositiveInteger(value, label) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return parsed;
+}
+export function parseCli(argv) {
+    const program = new Command();
+    program
+        .name("walletchan-rpc")
+        .description("Local JSON-RPC proxy that routes wallet requests through WalletConnect")
+        .option("-c, --chain <name-or-id>", "chain to expose; repeatable", collect, [])
+        .option("-r, --rpc <chain=url>", "override upstream RPC for a selected chain; repeatable", collect, [])
+        .option("-p, --port <number>", "local RPC port", "4209")
+        .option("--force-new-session", "discard stored WalletConnect sessions and show a fresh pairing URI")
+        .option("--project-id <id>", "WalletConnect project ID")
+        .option("--skip-batching", "do not require or expose ERC-5792 wallet_sendCalls")
+        .option("--request-timeout <seconds>", "WalletConnect request timeout", "300")
+        .option("--upstream-timeout <milliseconds>", "upstream RPC timeout", "15000")
+        .addHelpText("after", `
+
+Examples:
+  walletchan-rpc --chain base
+  walletchan-rpc --chain base --chain ethereum
+  walletchan-rpc --chain base --rpc base=https://mainnet.base.org
+  walletchan-rpc --chain 84532 --rpc 84532=https://sepolia.base.org
+`)
+        .parse(stripForwardedSeparator(argv));
+    const options = program.opts();
+    const projectId = options.projectId ||
+        process.env.WALLETCONNECT_PROJECT_ID ||
+        process.env.WC_PROJECT_ID ||
+        process.env.VITE_WALLETCONNECT_PROJECT_ID ||
+        process.env.VITE_WC_PROJECT_ID ||
+        DEFAULT_PROJECT_ID;
+    const requestTimeoutSeconds = parsePositiveInteger(options.requestTimeout, "--request-timeout");
+    if (requestTimeoutSeconds < 300) {
+        throw new Error("--request-timeout must be at least 300 seconds for WalletConnect");
+    }
+    const config = {
+        chains: resolveRuntimeChains(options.chain, options.rpc),
+        forceNewSession: Boolean(options.forceNewSession),
+        host: "127.0.0.1",
+        includeBatching: !options.skipBatching,
+        port: parsePositiveInteger(options.port, "--port"),
+        projectId,
+        requestTimeoutSeconds,
+        upstreamTimeoutMs: parsePositiveInteger(options.upstreamTimeout, "--upstream-timeout"),
+    };
+    if (config.port > 65535) {
+        throw new Error("--port must be between 1 and 65535");
+    }
+    if (!config.projectId) {
+        throw new Error("WalletConnect project ID is required");
+    }
+    return config;
+}
+function stripForwardedSeparator(argv) {
+    return argv.filter((value, index) => index < 2 || value !== "--");
+}
+export function formatCliSummary(config) {
+    return [
+        style.green(`Local RPC: http://${config.host}:${config.port}`),
+        style.purple(`SKILL.md:  http://${config.host}:${config.port}/SKILL.md`),
+        `Chains:    ${formatChains(config.chains)}`,
+        `Batching:  ${config.includeBatching ? "enabled" : "disabled"}`,
+    ].join("\n");
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/clipboard.d.ts

@@ -0,0 +1,7 @@
+export interface ClipboardResult {
+    success: boolean;
+    command?: string;
+    error?: string;
+}
+export declare function copyToClipboard(value: string): Promise<ClipboardResult>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAW7E"}