hardhat-airsign 0.1.0

package/dist/SigningClient.js

@@ -0,0 +1,132 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SigningClient = void 0;
+const http_1 = __importDefault(require("http"));
+/**
+ * SigningClient — an HTTP client that deploy scripts use to talk to the
+ * already-running AirSign server (started via `airsign-start`).
+ *
+ * Uses plain Node.js `http` module — no extra dependencies.
+ * The server holds the HTTP connection open for `/api/sign` until
+ * the browser wallet responds (long-polling).
+ */
+class SigningClient {
+    constructor(port = 9090, host = "localhost") {
+        this.serverUrl = `http://${host}:${port}`;
+    }
+    // ─── Server Communication ──────────────────────────────────────
+    /**
+     * Check if the AirSign server is running.
+     */
+    async isServerRunning() {
+        try {
+            const data = await this._httpGet("/api/health");
+            return data.status === "ok";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the currently connected wallet address.
+     * Returns null if no wallet is connected.
+     */
+    async getWalletAddress() {
+        const data = await this._httpGet("/api/wallet");
+        return data.address || null;
+    }
+    /**
+     * Wait until a wallet is connected on the AirSign UI.
+     * Polls /api/wallet every `interval` ms until an address appears or timeout.
+     */
+    async waitForWallet(timeout = 120000, interval = 1000) {
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            try {
+                const address = await this.getWalletAddress();
+                if (address)
+                    return address;
+            }
+            catch {
+                // Server might not be ready yet, keep polling
+            }
+            await new Promise((r) => setTimeout(r, interval));
+        }
+        throw new Error(`Timed out waiting for wallet connection after ${timeout / 1000}s. ` +
+            `Make sure you have opened the AirSign UI and connected your wallet.`);
+    }
+    /**
+     * Send a signing request to the server.
+     * The server forwards it to the browser wallet and holds the connection
+     * open until the wallet responds (long-polling, up to 5 min).
+     */
+    sendSigningRequest(request, callback) {
+        this._httpPost("/api/sign", request, 300000)
+            .then((response) => callback(response))
+            .catch((err) => callback({
+            id: request.id,
+            success: false,
+            error: err.message || "Failed to communicate with AirSign server",
+        }));
+    }
+    // ─── HTTP Helpers (Node.js built-in, zero deps) ────────────────
+    _httpGet(path) {
+        return new Promise((resolve, reject) => {
+            const url = new URL(path, this.serverUrl);
+            http_1.default
+                .get(url.toString(), (res) => {
+                let data = "";
+                res.on("data", (chunk) => (data += chunk));
+                res.on("end", () => {
+                    try {
+                        resolve(JSON.parse(data));
+                    }
+                    catch {
+                        reject(new Error(`Invalid JSON response from server: ${data}`));
+                    }
+                });
+            })
+                .on("error", (err) => reject(new Error(`Cannot reach AirSign server: ${err.message}`)));
+        });
+    }
+    _httpPost(path, body, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            const url = new URL(path, this.serverUrl);
+            const data = JSON.stringify(body);
+            const req = http_1.default.request({
+                hostname: url.hostname,
+                port: url.port,
+                path: url.pathname,
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Content-Length": Buffer.byteLength(data),
+                },
+                timeout,
+            }, (res) => {
+                let resData = "";
+                res.on("data", (chunk) => (resData += chunk));
+                res.on("end", () => {
+                    try {
+                        resolve(JSON.parse(resData));
+                    }
+                    catch {
+                        reject(new Error(`Invalid JSON response from server: ${resData}`));
+                    }
+                });
+            });
+            req.on("error", (err) => reject(new Error(`Cannot reach AirSign server: ${err.message}`)));
+            req.on("timeout", () => {
+                req.destroy();
+                reject(new Error("Request to AirSign server timed out"));
+            });
+            req.write(data);
+            req.end();
+        });
+    }
+}
+exports.SigningClient = SigningClient;
+//# sourceMappingURL=SigningClient.js.map

package/dist/SigningClient.js.map

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

package/dist/SigningServer.d.ts

@@ -0,0 +1,70 @@
+import { SigningRequest, SigningResponse, SessionInfo, ProjectContext } from "./types";
+/**
+ * SigningServer — an Express + Socket.io server that:
+ * 1. Serves the signing web app (React UI)
+ * 2. Manages the WebSocket connection between plugin and signing app
+ * 3. Routes signing requests from Hardhat → browser and responses back
+ */
+export declare class SigningServer {
+    private app;
+    private httpServer;
+    private io;
+    private signerSocket;
+    private sessionInfo;
+    private pendingCallbacks;
+    private pendingTimeouts;
+    private signerConnectedPromise;
+    private signerConnectedResolve;
+    private isSignerConnected;
+    private _onAccountChanged;
+    private projectContext;
+    private runningProcess;
+    private runningProcessId;
+    constructor(port?: number, host?: string, appPath?: string, projectContext?: ProjectContext);
+    start(): Promise<SessionInfo>;
+    stop(): Promise<void>;
+    getSessionInfo(): SessionInfo;
+    /**
+     * Wait for a signer to connect from the browser.
+     * Returns the signer's wallet address.
+     */
+    waitForSigner(): Promise<string>;
+    /**
+     * Register a callback for when the wallet account changes.
+     */
+    onAccountChanged(callback: (address: string) => void): void;
+    /**
+     * Send a signing request to the connected browser wallet.
+     * Calls the callback when the signer responds.
+     */
+    sendSigningRequest(request: SigningRequest, callback: (response: SigningResponse) => void): void;
+    private setupSocketHandlers;
+    /**
+     * Clear a pending callback and its associated timeout.
+     */
+    private clearPendingCallback;
+    /**
+     * Reject all pending signing requests with an error message.
+     */
+    private rejectAllPending;
+    /**
+     * Scan the project's scripts/ directory for .js and .ts files.
+     */
+    private discoverScripts;
+    /**
+     * Execute a Hardhat script or task as a child process.
+     * Streams stdout/stderr to all connected socket.io clients.
+     */
+    private executeProcess;
+    /**
+     * Kill the currently running process.
+     */
+    private killRunningProcess;
+    private generateSessionId;
+    /**
+     * Try to find the pre-built signing app in multiple locations.
+     * Returns the path if found, null otherwise.
+     */
+    private resolveAppPath;
+}
+//# sourceMappingURL=SigningServer.d.ts.map

package/dist/SigningServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SigningServer.d.ts","sourceRoot":"","sources":["../src/SigningServer.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,cAAc,EACd,eAAe,EAIf,WAAW,EACX,cAAc,EAIf,MAAM,SAAS,CAAC;AAKjB;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,EAAE,CAA6D;IACvE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CACZ;IACZ,OAAO,CAAC,eAAe,CAA0C;IAGjE,OAAO,CAAC,sBAAsB,CAAkB;IAChD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,iBAAiB,CAAkB;IAG3C,OAAO,CAAC,iBAAiB,CAA4C;IAGrE,OAAO,CAAC,cAAc,CAA+B;IAGrD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,gBAAgB,CAAuB;gBAG7C,IAAI,GAAE,MAAa,EACnB,IAAI,GAAE,MAAkB,EACxB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,cAAc;IAwQ3B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAS7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQtC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI3D;;;OAGG;IACH,kBAAkB,CAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,GAC5C,IAAI;IA2CP,OAAO,CAAC,mBAAmB;IA8F3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8FtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,cAAc;CA2BvB"}