browser-evm-signer 0.1.0

package/esm/transport.js

@@ -0,0 +1,60 @@
+import { custom, hexToString } from "viem";
+import { getRpcUrl } from "./config.js";
+/** Create a viem custom transport that routes wallet methods through WalletSigner. */
+export function walletSignerTransport(signer, options) {
+    return custom({
+        async request({ method, params }) {
+            switch (method) {
+                case "personal_sign": {
+                    const [messageHex] = params;
+                    const message = hexToString(messageHex);
+                    const { signature } = await signer.signMessage({ message });
+                    return signature;
+                }
+                case "eth_sendTransaction": {
+                    const [tx] = params;
+                    const sendParams = { to: tx.to };
+                    if (tx.data)
+                        sendParams.data = tx.data;
+                    if (tx.value)
+                        sendParams.value = BigInt(tx.value).toString();
+                    if (tx.gas)
+                        sendParams.gasLimit = BigInt(tx.gas).toString();
+                    if (tx.maxFeePerGas)
+                        sendParams.maxFeePerGas = BigInt(tx.maxFeePerGas).toString();
+                    if (tx.maxPriorityFeePerGas) {
+                        sendParams.maxPriorityFeePerGas = BigInt(tx.maxPriorityFeePerGas).toString();
+                    }
+                    if (tx.chainId)
+                        sendParams.chainId = Number(BigInt(tx.chainId));
+                    const { txHash } = await signer.sendTransaction(sendParams);
+                    return txHash;
+                }
+                case "eth_signTypedData_v4": {
+                    const [, typedDataJson] = params;
+                    const { domain, types, primaryType, message } = JSON.parse(typedDataJson);
+                    const { signature } = await signer.signTypedData({ domain, types, primaryType, message });
+                    return signature;
+                }
+                case "eth_chainId":
+                    return `0x${signer.defaultChainId.toString(16)}`;
+                default: {
+                    const rpcUrl = options?.rpcUrl ?? getRpcUrl(signer.defaultChainId);
+                    if (!rpcUrl) {
+                        throw new Error(`No RPC URL for chain ${signer.defaultChainId}. Provide rpcUrl in transport options.`);
+                    }
+                    const resp = await fetch(rpcUrl, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params: params ?? [] }),
+                    });
+                    const json = await resp.json();
+                    if (json.error) {
+                        throw new Error(json.error.message ?? JSON.stringify(json.error));
+                    }
+                    return json.result;
+                }
+            }
+        },
+    }, { retryCount: 0 });
+}

package/esm/types.d.ts

@@ -0,0 +1,79 @@
+export interface ChainConfig {
+    id: number;
+    name: string;
+    rpcUrl: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    blockExplorer?: string;
+}
+export type RequestType = "connect" | "send_transaction" | "sign_message" | "sign_typed_data";
+export interface BaseRequest {
+    id: string;
+    type: RequestType;
+    chainId?: number;
+    createdAt: number;
+}
+export interface ConnectRequest extends BaseRequest {
+    type: "connect";
+    address?: string;
+}
+export interface SendTransactionRequest extends BaseRequest {
+    type: "send_transaction";
+    to: string;
+    value?: string;
+    data?: string;
+    gasLimit?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+}
+export interface SignMessageRequest extends BaseRequest {
+    type: "sign_message";
+    message: string;
+    address?: string;
+}
+export interface SignTypedDataRequest extends BaseRequest {
+    type: "sign_typed_data";
+    domain: TypedDataDomain;
+    types: Record<string, TypedDataField[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+    address?: string;
+}
+export interface TypedDataDomain {
+    name?: string;
+    version?: string;
+    chainId?: number;
+    verifyingContract?: string;
+    salt?: string;
+}
+export interface TypedDataField {
+    name: string;
+    type: string;
+}
+export type PendingRequest = ConnectRequest | SendTransactionRequest | SignMessageRequest | SignTypedDataRequest;
+export interface SuccessResult {
+    success: true;
+    result: string;
+}
+export interface ErrorResult {
+    success: false;
+    error: string;
+}
+export type RequestResult = SuccessResult | ErrorResult;
+export interface PendingEntry<T extends PendingRequest = PendingRequest> {
+    request: T;
+    resolve: (result: RequestResult) => void;
+    reject: (error: Error) => void;
+}
+export interface PendingApiResponse {
+    request: PendingRequest;
+}
+export interface CompleteApiRequest {
+    success: boolean;
+    result?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/types.d.ts.map

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

package/esm/types.js

@@ -0,0 +1 @@
+export {};

package/esm/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/esm/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,OAAO,QAAe,CAAC"}

package/esm/version.js

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function getVersion() {
+    try {
+        const dir = dirname(fileURLToPath(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url));
+        const pkg = JSON.parse(readFileSync(join(dir, "..", "package.json"), "utf-8"));
+        return pkg.version;
+    }
+    catch {
+        return "dev";
+    }
+}
+export const VERSION = getVersion();

package/esm/viem-account.d.ts

@@ -0,0 +1,27 @@
+import type { Address, CustomSource, CustomTransport } from "viem";
+import type { WalletSigner } from "./wallet-signer.js";
+import { type WalletSignerTransportOptions } from "./transport.js";
+/** A viem-compatible hybrid account: type "json-rpc" for transport-routed sends, with signMessage/signTypedData. */
+export interface ViemBrowserAccount {
+    address: Address;
+    type: "json-rpc";
+    signMessage: CustomSource["signMessage"];
+    signTypedData: CustomSource["signTypedData"];
+    signTransaction: never;
+}
+export interface ConnectWalletViemOptions extends WalletSignerTransportOptions {
+    /** Pre-connected address — skips the connectWallet() browser prompt if provided. */
+    address?: Address;
+}
+/**
+ * Connect to a browser wallet and return a viem-compatible hybrid account + custom transport.
+ *
+ * The account uses type "json-rpc" so viem routes eth_sendTransaction through the transport
+ * (which forwards to the browser wallet), while signMessage/signTypedData are available for
+ * direct calls from application code.
+ */
+export declare function connectWalletViem(signer: WalletSigner, options?: ConnectWalletViemOptions): Promise<{
+    account: ViemBrowserAccount;
+    transport: CustomTransport;
+}>;
+//# sourceMappingURL=viem-account.d.ts.map

package/esm/viem-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-account.d.ts","sourceRoot":"","sources":["../src/viem-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAO,MAAM,MAAM,CAAC;AAExE,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAyB,KAAK,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAE1F,oHAAoH;AACpH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IACzC,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IAC7C,eAAe,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,CA8BtE"}

package/esm/viem-account.js

@@ -0,0 +1,36 @@
+import { walletSignerTransport } from "./transport.js";
+/**
+ * Connect to a browser wallet and return a viem-compatible hybrid account + custom transport.
+ *
+ * The account uses type "json-rpc" so viem routes eth_sendTransaction through the transport
+ * (which forwards to the browser wallet), while signMessage/signTypedData are available for
+ * direct calls from application code.
+ */
+export async function connectWalletViem(signer, options) {
+    const address = (options?.address ?? (await signer.connectWallet()).address);
+    const signMessage = async ({ message }) => {
+        let msg;
+        if (typeof message === "string") {
+            msg = message;
+        }
+        else {
+            msg = typeof message.raw === "string" ? message.raw : new TextDecoder().decode(message.raw);
+        }
+        const { signature } = await signer.signMessage({ message: msg });
+        return signature;
+    };
+    // viem's CustomSource["signTypedData"] uses heavily generic conditional types (TypedDataDefinition)
+    // that TypeScript can't prove assignable to any concrete type inside the generic callback.
+    const signTypedData = async (params) => {
+        const { signature } = await signer.signTypedData(params);
+        return signature;
+    };
+    const account = {
+        address,
+        type: "json-rpc",
+        signMessage,
+        signTypedData,
+        signTransaction: undefined,
+    };
+    return { account, transport: walletSignerTransport(signer, options) };
+}

package/esm/wallet-signer.d.ts

@@ -0,0 +1,106 @@
+import { PendingStore } from "./pending-store.js";
+import type { TypedDataDomain, TypedDataField } from "./types.js";
+export interface WalletSignerOptions {
+    port?: number;
+    defaultChainId?: number;
+    /** Control browser opening: true (default) = auto-open, false = don't open, function = custom handler */
+    openBrowser?: boolean | ((url: string) => void | Promise<void>);
+}
+export interface SendTransactionParams {
+    to: string;
+    value?: string;
+    data?: string;
+    chainId?: number;
+    gasLimit?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+}
+export interface SignMessageParams {
+    message: string;
+    address?: string;
+    chainId?: number;
+}
+export interface SignTypedDataParams {
+    domain: TypedDataDomain;
+    types: Record<string, TypedDataField[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+    address?: string;
+    chainId?: number;
+}
+export interface ConnectResult {
+    address: string;
+    approvalUrl: string;
+}
+export interface TransactionResult {
+    txHash: string;
+    approvalUrl: string;
+}
+export interface SignResult {
+    signature: string;
+    approvalUrl: string;
+}
+export interface BalanceResult {
+    balance: string;
+    wei: string;
+    symbol: string;
+}
+/**
+ * Programmatic interface to the wallet signer.
+ * Each instance owns its own PendingStore and HTTP server.
+ */
+export declare class WalletSigner {
+    private _port;
+    private _defaultChainId;
+    private _pendingStore;
+    private _openBrowser;
+    private _httpServer;
+    constructor(options?: WalletSignerOptions);
+    /** The PendingStore owned by this signer */
+    get pendingStore(): PendingStore;
+    /** The configured default chain ID */
+    get defaultChainId(): number;
+    /** The HTTP server port, or null if not yet started */
+    get port(): number | null;
+    /**
+     * Start the HTTP server explicitly. Called automatically on first signing call.
+     * Returns the port the server is listening on.
+     */
+    start(): Promise<number>;
+    /**
+     * Connect to a browser wallet and get the wallet address.
+     * Opens a browser window for user approval.
+     */
+    connectWallet(options?: {
+        chainId?: number;
+        address?: string;
+    }): Promise<ConnectResult>;
+    /**
+     * Send a transaction via the connected browser wallet.
+     * Opens a browser window for user approval.
+     */
+    sendTransaction(params: SendTransactionParams): Promise<TransactionResult>;
+    /**
+     * Sign a message using personal_sign.
+     * Opens a browser window for user approval.
+     */
+    signMessage(params: SignMessageParams): Promise<SignResult>;
+    /**
+     * Sign EIP-712 typed data.
+     * Opens a browser window for user approval.
+     */
+    signTypedData(params: SignTypedDataParams): Promise<SignResult>;
+    /**
+     * Get the native token balance of an address.
+     * Does not require browser interaction — reads directly from the blockchain.
+     */
+    getBalance(params: {
+        address: string;
+        chainId?: number;
+    }): Promise<BalanceResult>;
+    /**
+     * Shut down the HTTP server and cancel all pending requests.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=wallet-signer.d.ts.map

package/esm/wallet-signer.d.ts.map

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

package/esm/wallet-signer.js

@@ -0,0 +1,178 @@
+import { createPublicClient, formatEther, http } from "viem";
+import { PendingStore } from "./pending-store.js";
+import { createHttpServer } from "./http-server.js";
+import { buildConnectUrl, buildSignUrl, openBrowser } from "./browser.js";
+import { CHAINS, getDefaultChainId, getPort, getRpcUrl } from "./config.js";
+/**
+ * Programmatic interface to the wallet signer.
+ * Each instance owns its own PendingStore and HTTP server.
+ */
+export class WalletSigner {
+    constructor(options) {
+        Object.defineProperty(this, "_port", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_defaultChainId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_pendingStore", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_openBrowser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_httpServer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        this._port = options?.port ?? getPort();
+        this._defaultChainId = options?.defaultChainId ?? getDefaultChainId();
+        this._pendingStore = new PendingStore();
+        const ob = options?.openBrowser ?? true;
+        if (typeof ob === "function") {
+            this._openBrowser = ob;
+        }
+        else if (ob) {
+            this._openBrowser = openBrowser;
+        }
+        else {
+            this._openBrowser = () => { };
+        }
+    }
+    /** The PendingStore owned by this signer */
+    get pendingStore() {
+        return this._pendingStore;
+    }
+    /** The configured default chain ID */
+    get defaultChainId() {
+        return this._defaultChainId;
+    }
+    /** The HTTP server port, or null if not yet started */
+    get port() {
+        return this._httpServer?.port ?? null;
+    }
+    /**
+     * Start the HTTP server explicitly. Called automatically on first signing call.
+     * Returns the port the server is listening on.
+     */
+    async start() {
+        if (this._httpServer) {
+            return this._httpServer.port;
+        }
+        this._httpServer = await createHttpServer(this._pendingStore, this._port);
+        return this._httpServer.port;
+    }
+    /**
+     * Connect to a browser wallet and get the wallet address.
+     * Opens a browser window for user approval.
+     */
+    async connectWallet(options) {
+        const chainId = options?.chainId ?? this._defaultChainId;
+        const port = await this.start();
+        const { id, promise } = this._pendingStore.createConnectRequest({ chainId, address: options?.address });
+        const approvalUrl = buildConnectUrl(port, id);
+        await this._openBrowser(approvalUrl);
+        const result = await promise;
+        if (!result.success)
+            throw new Error(result.error);
+        return { address: result.result, approvalUrl };
+    }
+    /**
+     * Send a transaction via the connected browser wallet.
+     * Opens a browser window for user approval.
+     */
+    async sendTransaction(params) {
+        const port = await this.start();
+        const { id, promise } = this._pendingStore.createSendTransactionRequest({
+            ...params,
+            chainId: params.chainId ?? this._defaultChainId,
+        });
+        const approvalUrl = buildSignUrl(port, id);
+        await this._openBrowser(approvalUrl);
+        const result = await promise;
+        if (!result.success)
+            throw new Error(result.error);
+        return { txHash: result.result, approvalUrl };
+    }
+    /**
+     * Sign a message using personal_sign.
+     * Opens a browser window for user approval.
+     */
+    async signMessage(params) {
+        const port = await this.start();
+        const { id, promise } = this._pendingStore.createSignMessageRequest({
+            ...params,
+            chainId: params.chainId ?? this._defaultChainId,
+        });
+        const approvalUrl = buildSignUrl(port, id);
+        await this._openBrowser(approvalUrl);
+        const result = await promise;
+        if (!result.success)
+            throw new Error(result.error);
+        return { signature: result.result, approvalUrl };
+    }
+    /**
+     * Sign EIP-712 typed data.
+     * Opens a browser window for user approval.
+     */
+    async signTypedData(params) {
+        const port = await this.start();
+        const { id, promise } = this._pendingStore.createSignTypedDataRequest({
+            ...params,
+            chainId: params.chainId ?? this._defaultChainId,
+        });
+        const approvalUrl = buildSignUrl(port, id);
+        await this._openBrowser(approvalUrl);
+        const result = await promise;
+        if (!result.success)
+            throw new Error(result.error);
+        return { signature: result.result, approvalUrl };
+    }
+    /**
+     * Get the native token balance of an address.
+     * Does not require browser interaction — reads directly from the blockchain.
+     */
+    async getBalance(params) {
+        const chainId = params.chainId ?? this._defaultChainId;
+        const rpcUrl = getRpcUrl(chainId);
+        if (!rpcUrl)
+            throw new Error(`Unknown chain ID: ${chainId}. No RPC URL configured.`);
+        const client = createPublicClient({ transport: http(rpcUrl) });
+        const balance = await client.getBalance({
+            address: params.address,
+        });
+        const chain = CHAINS[chainId];
+        const symbol = chain?.nativeCurrency.symbol || "ETH";
+        return {
+            balance: formatEther(balance),
+            wei: balance.toString(),
+            symbol,
+        };
+    }
+    /**
+     * Shut down the HTTP server and cancel all pending requests.
+     */
+    async shutdown() {
+        if (this._httpServer) {
+            await this._httpServer.stop();
+            this._httpServer = null;
+        }
+        for (const id of this._pendingStore.getPendingIds()) {
+            this._pendingStore.cancel(id, "Wallet signer shutting down");
+        }
+    }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "browser-evm-signer",
+  "version": "0.1.0",
+  "description": "Route EVM transactions to browser wallets for signing — standalone library, no MCP dependency",
+  "keywords": [
+    "wallet",
+    "ethereum",
+    "evm",
+    "metamask",
+    "eip-6963",
+    "browser-wallet",
+    "signing",
+    "blockchain",
+    "web3",
+    "non-custodial",
+    "transaction-signing",
+    "viem"
+  ],
+  "author": "Nikolay Bryskin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nikicat/mcp-wallet-signer"
+  },
+  "license": "MIT",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./esm/mod.d.ts",
+        "default": "./esm/mod.js"
+      }
+    }
+  },
+  "scripts": {},
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "open": "10.1.0"
+  },
+  "_generatedBy": "dnt@dev",
+  "peerDependencies": {
+    "viem": "2.46.2"
+  }
+}