browser-evm-signer 0.1.0

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/esm/_dnt.polyfills.js

@@ -0,0 +1,127 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/browser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Open a URL in the default browser
+ */
+export declare function openBrowser(url: string): Promise<void>;
+/**
+ * Build the URL for a specific signing request
+ */
+export declare function buildSignUrl(port: number, requestId: string): string;
+/**
+ * Build the URL for wallet connection
+ */
+export declare function buildConnectUrl(port: number, requestId: string): string;
+//# sourceMappingURL=browser.d.ts.map

package/esm/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE"}

package/esm/browser.js

@@ -0,0 +1,28 @@
+/**
+ * Open a URL in the default browser
+ */
+export async function openBrowser(url) {
+    try {
+        // Dynamic import: avoids pulling in `open` (and its `is-wsl` dep) at module load time,
+        // which matters when a consumer provides a custom openBrowser and never needs this default.
+        const { default: open } = await import("open");
+        await open(url);
+    }
+    catch (error) {
+        // Log error but don't throw - the user might want to open the URL manually
+        console.error(`[mcp-wallet-signer] Failed to open browser: ${error}`);
+        console.error(`[mcp-wallet-signer] Please open this URL manually: ${url}`);
+    }
+}
+/**
+ * Build the URL for a specific signing request
+ */
+export function buildSignUrl(port, requestId) {
+    return `http://127.0.0.1:${port}/sign/${requestId}`;
+}
+/**
+ * Build the URL for wallet connection
+ */
+export function buildConnectUrl(port, requestId) {
+    return `http://127.0.0.1:${port}/connect/${requestId}`;
+}

package/esm/config.d.ts

@@ -0,0 +1,8 @@
+import type { ChainConfig } from "./types.js";
+export declare const DEFAULT_PORT = 3847;
+export declare function getPort(): number;
+export declare function getDefaultChainId(): number;
+export declare const CHAINS: Record<number, ChainConfig>;
+export declare function getChainConfig(chainId: number): ChainConfig | undefined;
+export declare function getRpcUrl(chainId: number): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/esm/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,YAAY,OAAO,CAAC;AAGjC,wBAAgB,OAAO,IAAI,MAAM,CAShC;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAGD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAiE9C,CAAC;AAGF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEvE;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D"}

package/esm/config.js

@@ -0,0 +1,100 @@
+import process from "node:process";
+// Default HTTP server port
+export const DEFAULT_PORT = 3847;
+// Get port from environment or use default
+export function getPort() {
+    const envPort = process.env.EVM_MCP_PORT;
+    if (envPort) {
+        const parsed = parseInt(envPort, 10);
+        if (!isNaN(parsed) && parsed > 0 && parsed < 65536) {
+            return parsed;
+        }
+    }
+    return DEFAULT_PORT;
+}
+// Get default chain ID from environment or use mainnet
+export function getDefaultChainId() {
+    const envChain = process.env.EVM_MCP_DEFAULT_CHAIN;
+    if (envChain) {
+        const parsed = parseInt(envChain, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return 1; // Ethereum mainnet
+}
+// Built-in chain configurations
+export const CHAINS = {
+    // Ethereum Mainnet
+    1: {
+        id: 1,
+        name: "Ethereum",
+        rpcUrl: "https://eth.llamarpc.com",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorer: "https://etherscan.io",
+    },
+    // Sepolia Testnet
+    11155111: {
+        id: 11155111,
+        name: "Sepolia",
+        rpcUrl: "https://rpc.sepolia.org",
+        nativeCurrency: { name: "Sepolia Ether", symbol: "ETH", decimals: 18 },
+        blockExplorer: "https://sepolia.etherscan.io",
+    },
+    // Polygon
+    137: {
+        id: 137,
+        name: "Polygon",
+        rpcUrl: "https://polygon-rpc.com",
+        nativeCurrency: { name: "MATIC", symbol: "MATIC", decimals: 18 },
+        blockExplorer: "https://polygonscan.com",
+    },
+    // Arbitrum One
+    42161: {
+        id: 42161,
+        name: "Arbitrum One",
+        rpcUrl: "https://arb1.arbitrum.io/rpc",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorer: "https://arbiscan.io",
+    },
+    // Optimism
+    10: {
+        id: 10,
+        name: "Optimism",
+        rpcUrl: "https://mainnet.optimism.io",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorer: "https://optimistic.etherscan.io",
+    },
+    // Base
+    8453: {
+        id: 8453,
+        name: "Base",
+        rpcUrl: "https://mainnet.base.org",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorer: "https://basescan.org",
+    },
+    // Avalanche C-Chain
+    43114: {
+        id: 43114,
+        name: "Avalanche",
+        rpcUrl: "https://api.avax.network/ext/bc/C/rpc",
+        nativeCurrency: { name: "AVAX", symbol: "AVAX", decimals: 18 },
+        blockExplorer: "https://snowtrace.io",
+    },
+    // BNB Smart Chain
+    56: {
+        id: 56,
+        name: "BNB Smart Chain",
+        rpcUrl: "https://bsc-dataseed.binance.org",
+        nativeCurrency: { name: "BNB", symbol: "BNB", decimals: 18 },
+        blockExplorer: "https://bscscan.com",
+    },
+};
+// Get chain config by ID, with fallback for unknown chains
+export function getChainConfig(chainId) {
+    return CHAINS[chainId];
+}
+// Get RPC URL for a chain
+export function getRpcUrl(chainId) {
+    return CHAINS[chainId]?.rpcUrl;
+}

package/esm/http-server.d.ts

@@ -0,0 +1,17 @@
+import { PendingStore } from "./pending-store.js";
+/**
+ * Create an HTTP server bound to a PendingStore.
+ * Returns the port and a stop function.
+ */
+export declare function createHttpServer(store: PendingStore, port?: number): Promise<{
+    port: number;
+    stop: () => Promise<void>;
+}>;
+/**
+ * Start a test server on a random port using the default PendingStore.
+ */
+export declare function startTestServer(): Promise<{
+    port: number;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=http-server.d.ts.map

package/esm/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAuC,MAAM,oBAAoB,CAAC;AA+VvF;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAmBtD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAEtF"}