@arcsign/hardhat-plugin 1.0.0

package/dist/ArcSignProvider.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ArcSign Provider
+ *
+ * Manages connection to ArcSign Dashboard and creates signers.
+ */
+import { Provider } from "ethers";
+import { ArcSignClient } from "./ArcSignClient";
+import { ArcSignSigner } from "./ArcSignSigner";
+export declare class ArcSignProvider {
+    private client;
+    private accounts;
+    constructor(wsUrl?: string);
+    /**
+     * Connect to ArcSign Dashboard
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from ArcSign Dashboard
+     */
+    disconnect(): void;
+    /**
+     * Check if connected
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Get available accounts
+     */
+    getAccounts(): Promise<string[]>;
+    /**
+     * Get signers for all accounts
+     */
+    getSigners(provider: Provider): Promise<ArcSignSigner[]>;
+    /**
+     * Get a signer for a specific address
+     */
+    getSigner(address: string, provider: Provider): Promise<ArcSignSigner>;
+    /**
+     * Get the underlying client
+     */
+    getClient(): ArcSignClient;
+    /**
+     * Get developer session status
+     */
+    getSession(): Promise<{
+        active: boolean;
+        session?: {
+            enabled: boolean;
+            expires_at: number;
+            trusted_networks: string[];
+            sign_count: number;
+        };
+        remaining_ms?: number;
+        message?: string;
+    }>;
+    /**
+     * Create a developer session for auto-signing testnets
+     */
+    createSession(params: {
+        walletId: string;
+        durationMinutes?: number;
+        trustedNetworks?: string[];
+        maxGasLimit?: string;
+    }): Promise<{
+        status: string;
+        session: {
+            enabled: boolean;
+            created_at: number;
+            expires_at: number;
+            trusted_networks: string[];
+            sign_count: number;
+        };
+    }>;
+    /**
+     * End the current developer session
+     */
+    endSession(): Promise<{
+        status: string;
+        sign_count?: number;
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=ArcSignProvider.d.ts.map

package/dist/ArcSignProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcSignProvider.d.ts","sourceRoot":"","sources":["../src/ArcSignProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,KAAK,GAAE,MAA8B;IAIjD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAarC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgB9D;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB5E;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACG,UAAU;;;;;;;;;;;IAIhB;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;IASD;;OAEG;IACG,UAAU;;;;;CAGjB"}

package/dist/ArcSignProvider.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * ArcSign Provider
+ *
+ * Manages connection to ArcSign Dashboard and creates signers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcSignProvider = void 0;
+const ArcSignClient_1 = require("./ArcSignClient");
+const ArcSignSigner_1 = require("./ArcSignSigner");
+class ArcSignProvider {
+    constructor(wsUrl = "ws://127.0.0.1:9527") {
+        this.accounts = [];
+        this.client = new ArcSignClient_1.ArcSignClient(wsUrl);
+    }
+    /**
+     * Connect to ArcSign Dashboard
+     */
+    async connect() {
+        await this.client.connect();
+        // Verify connection with ping
+        const pingResult = await this.client.ping();
+        console.log(`[ArcSign] ✓ Connected to ${pingResult.wallet} v${pingResult.version}`);
+        // Get available accounts
+        const accountsResult = await this.client.getAccounts();
+        this.accounts = accountsResult.accounts;
+        if (this.accounts.length === 0) {
+            console.warn("[ArcSign] ⚠️ No accounts available. Please unlock a wallet in ArcSign Dashboard.");
+        }
+        else {
+            console.log(`[ArcSign] Available accounts:`);
+            this.accounts.forEach((addr, i) => {
+                console.log(`[ArcSign]   [${i}] ${addr}`);
+            });
+        }
+    }
+    /**
+     * Disconnect from ArcSign Dashboard
+     */
+    disconnect() {
+        this.client.disconnect();
+    }
+    /**
+     * Check if connected
+     */
+    async isConnected() {
+        if (!this.client.isConnected()) {
+            return false;
+        }
+        try {
+            await this.client.ping();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get available accounts
+     */
+    async getAccounts() {
+        if (this.accounts.length === 0) {
+            const result = await this.client.getAccounts();
+            this.accounts = result.accounts;
+        }
+        return this.accounts;
+    }
+    /**
+     * Get signers for all accounts
+     */
+    async getSigners(provider) {
+        const accounts = await this.getAccounts();
+        if (accounts.length === 0) {
+            throw new Error("No accounts available from ArcSign. " +
+                "Please make sure:\n" +
+                "  1. ArcSign Dashboard is running\n" +
+                "  2. A wallet is unlocked\n" +
+                "  3. The wallet has at least one address");
+        }
+        return accounts.map((address) => new ArcSignSigner_1.ArcSignSigner(address, this.client, provider));
+    }
+    /**
+     * Get a signer for a specific address
+     */
+    async getSigner(address, provider) {
+        const accounts = await this.getAccounts();
+        const normalizedAddress = address.toLowerCase();
+        const matchedAddress = accounts.find((a) => a.toLowerCase() === normalizedAddress);
+        if (!matchedAddress) {
+            throw new Error(`Address ${address} is not available in ArcSign. ` +
+                `Available addresses: ${accounts.join(", ")}`);
+        }
+        return new ArcSignSigner_1.ArcSignSigner(matchedAddress, this.client, provider);
+    }
+    /**
+     * Get the underlying client
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Get developer session status
+     */
+    async getSession() {
+        return this.client.getDevSession();
+    }
+    /**
+     * Create a developer session for auto-signing testnets
+     */
+    async createSession(params) {
+        return this.client.createDevSession({
+            wallet_id: params.walletId,
+            duration_minutes: params.durationMinutes,
+            trusted_networks: params.trustedNetworks,
+            max_gas_limit: params.maxGasLimit,
+        });
+    }
+    /**
+     * End the current developer session
+     */
+    async endSession() {
+        return this.client.endDevSession();
+    }
+}
+exports.ArcSignProvider = ArcSignProvider;
+//# sourceMappingURL=ArcSignProvider.js.map

package/dist/ArcSignProvider.js.map

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

package/dist/ArcSignSigner.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ArcSign Signer
+ *
+ * Implements ethers.js Signer interface using ArcSign wallet.
+ */
+import { AbstractSigner, Provider, TransactionRequest, TransactionResponse, TypedDataDomain, TypedDataField } from "ethers";
+import { ArcSignClient } from "./ArcSignClient";
+export declare class ArcSignSigner extends AbstractSigner {
+    private client;
+    private _address;
+    readonly address: string;
+    constructor(address: string, client: ArcSignClient, provider?: Provider | null);
+    /**
+     * Get current script context (detected at call time)
+     */
+    private getCurrentScriptContext;
+    /**
+     * Detect script context from stack trace
+     * Note: Should be called at signing time to capture the actual script
+     */
+    private detectScriptContext;
+    /**
+     * Connect this signer to a provider
+     */
+    connect(provider: Provider | null): ArcSignSigner;
+    /**
+     * Get the address
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Sign a message (EIP-191)
+     */
+    signMessage(message: string | Uint8Array): Promise<string>;
+    /**
+     * Sign typed data (EIP-712)
+     */
+    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
+    /**
+     * Sign a transaction
+     */
+    signTransaction(tx: TransactionRequest): Promise<string>;
+    /**
+     * Send a transaction
+     */
+    sendTransaction(tx: TransactionRequest): Promise<TransactionResponse>;
+    /**
+     * Format address for display
+     */
+    private formatAddress;
+    /**
+     * Convert base64 encoded string to hex with 0x prefix
+     * ArcSign returns signed transactions in base64, but RPC expects hex
+     */
+    private base64ToHex;
+}
+//# sourceMappingURL=ArcSignSigner.d.ts.map

package/dist/ArcSignSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcSignSigner.d.ts","sourceRoot":"","sources":["../src/ArcSignSigner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC5H,OAAO,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAC;AAG5D,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAGzB,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,GAAE,QAAQ,GAAG,IAAW;IAOpF;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2C3B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,aAAa;IAIjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhE;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC;IA4BlB;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6C9D;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgB3E;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAMpB"}

package/dist/ArcSignSigner.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * ArcSign Signer
+ *
+ * Implements ethers.js Signer interface using ArcSign wallet.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcSignSigner = void 0;
+const ethers_1 = require("ethers");
+const path_1 = __importDefault(require("path"));
+class ArcSignSigner extends ethers_1.AbstractSigner {
+    constructor(address, client, provider = null) {
+        super(provider);
+        this.client = client;
+        this._address = address;
+        this.address = address;
+    }
+    /**
+     * Get current script context (detected at call time)
+     */
+    getCurrentScriptContext() {
+        return this.detectScriptContext();
+    }
+    /**
+     * Detect script context from stack trace
+     * Note: Should be called at signing time to capture the actual script
+     */
+    detectScriptContext() {
+        const stack = new Error().stack || "";
+        const lines = stack.split("\n");
+        // Debug: log stack trace to help troubleshoot
+        console.log("[ArcSign] Stack trace for script detection:");
+        lines.slice(0, 10).forEach(line => console.log("  ", line));
+        // Look for scripts/ directory or common deploy patterns in stack
+        for (const line of lines) {
+            // Match both formats: "at func (path:line:col)" and "at path:line:col"
+            const match = line.match(/(?:at\s+(?:[\w.<>]+\s+)?)?(?:\()?([^()]+\.(ts|js)):\d+:\d+/);
+            if (match) {
+                const filePath = match[1];
+                // Skip node_modules and internal files
+                if (filePath.includes("node_modules"))
+                    continue;
+                // Check for common script patterns
+                if (filePath.includes("scripts/") ||
+                    filePath.includes("deploy") ||
+                    filePath.includes("hardhat") ||
+                    filePath.endsWith(".ts") ||
+                    filePath.endsWith(".js")) {
+                    const scriptName = path_1.default.basename(filePath);
+                    // Skip if it's our own files
+                    if (scriptName.includes("ArcSign"))
+                        continue;
+                    console.log("[ArcSign] Detected script:", scriptName);
+                    return {
+                        script_name: scriptName,
+                        project_path: path_1.default.dirname(filePath),
+                        is_dev_wallet: true,
+                    };
+                }
+            }
+        }
+        console.log("[ArcSign] Could not detect script name from stack trace");
+        return {
+            is_dev_wallet: true,
+        };
+    }
+    /**
+     * Connect this signer to a provider
+     */
+    connect(provider) {
+        return new ArcSignSigner(this._address, this.client, provider);
+    }
+    /**
+     * Get the address
+     */
+    async getAddress() {
+        return this._address;
+    }
+    /**
+     * Sign a message (EIP-191)
+     */
+    async signMessage(message) {
+        const messageStr = typeof message === "string"
+            ? message
+            : "0x" + Buffer.from(message).toString("hex");
+        console.log(`[ArcSign] Signing message with ${this.formatAddress(this._address)}...`);
+        console.log(`[ArcSign] ⏳ Waiting for approval in ArcSign Dashboard...`);
+        const result = await this.client.personalSign(this._address, messageStr, {
+            ...this.getCurrentScriptContext(),
+            description: "Sign Message",
+        });
+        console.log(`[ArcSign] ✓ Message signed`);
+        return result.signature;
+    }
+    /**
+     * Sign typed data (EIP-712)
+     */
+    async signTypedData(domain, types, value) {
+        const typedData = {
+            types: {
+                EIP712Domain: [
+                    { name: "name", type: "string" },
+                    { name: "version", type: "string" },
+                    { name: "chainId", type: "uint256" },
+                    { name: "verifyingContract", type: "address" },
+                ],
+                ...types,
+            },
+            primaryType: Object.keys(types)[0],
+            domain,
+            message: value,
+        };
+        console.log(`[ArcSign] Signing typed data with ${this.formatAddress(this._address)}...`);
+        console.log(`[ArcSign] ⏳ Waiting for approval in ArcSign Dashboard...`);
+        const result = await this.client.signTypedData(this._address, typedData, {
+            ...this.getCurrentScriptContext(),
+            description: "Sign Typed Data",
+        });
+        console.log(`[ArcSign] ✓ Typed data signed`);
+        return result.signature;
+    }
+    /**
+     * Sign a transaction
+     */
+    async signTransaction(tx) {
+        if (!this.provider) {
+            throw new Error("Provider not set");
+        }
+        // Resolve addresses and estimate gas if needed
+        const resolvedTx = await this.populateTransaction(tx);
+        console.log(`[ArcSign] Signing transaction...`);
+        console.log(`[ArcSign]   From: ${this.formatAddress(this._address)}`);
+        console.log(`[ArcSign]   To: ${resolvedTx.to ? this.formatAddress(resolvedTx.to.toString()) : "(Contract Deploy)"}`);
+        console.log(`[ArcSign]   Value: ${resolvedTx.value || "0"}`);
+        console.log(`[ArcSign] ⏳ Waiting for approval in ArcSign Dashboard...`);
+        const network = await this.provider.getNetwork();
+        const result = await this.client.devSignTransaction({
+            from: this._address,
+            to: resolvedTx.to?.toString() || "",
+            data: resolvedTx.data?.toString() || "0x",
+            value: resolvedTx.value?.toString(),
+            gas: resolvedTx.gasLimit?.toString(),
+            gasPrice: resolvedTx.gasPrice?.toString(),
+            maxFeePerGas: resolvedTx.maxFeePerGas?.toString(),
+            maxPriorityFeePerGas: resolvedTx.maxPriorityFeePerGas?.toString(),
+            chainId: Number(network.chainId),
+            nonce: resolvedTx.nonce !== undefined ? Number(resolvedTx.nonce) : undefined,
+            context: {
+                ...this.getCurrentScriptContext(),
+                description: resolvedTx.to ? "Contract Call" : "Deploy Contract",
+            },
+        });
+        if (!result.signed_tx) {
+            throw new Error("No signed transaction returned");
+        }
+        console.log(`[ArcSign] ✓ Transaction signed`);
+        // The signed_tx from ArcSign is base64 encoded - convert to hex with 0x prefix
+        // RPC nodes expect hex format for eth_sendRawTransaction
+        const signedTxHex = this.base64ToHex(result.signed_tx);
+        return signedTxHex;
+    }
+    /**
+     * Send a transaction
+     */
+    async sendTransaction(tx) {
+        if (!this.provider) {
+            throw new Error("Provider not set");
+        }
+        // Sign the transaction
+        const signedTx = await this.signTransaction(tx);
+        // Broadcast it
+        console.log(`[ArcSign] Broadcasting transaction...`);
+        const response = await this.provider.broadcastTransaction(signedTx);
+        console.log(`[ArcSign] ✓ Transaction submitted: ${response.hash}`);
+        return response;
+    }
+    /**
+     * Format address for display
+     */
+    formatAddress(address) {
+        if (address.length >= 10) {
+            return `${address.slice(0, 6)}...${address.slice(-4)}`;
+        }
+        return address;
+    }
+    /**
+     * Convert base64 encoded string to hex with 0x prefix
+     * ArcSign returns signed transactions in base64, but RPC expects hex
+     */
+    base64ToHex(base64) {
+        // Decode base64 to bytes
+        const bytes = Buffer.from(base64, "base64");
+        // Convert to hex with 0x prefix
+        return "0x" + bytes.toString("hex");
+    }
+}
+exports.ArcSignSigner = ArcSignSigner;
+//# sourceMappingURL=ArcSignSigner.js.map

package/dist/ArcSignSigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcSignSigner.js","sourceRoot":"","sources":["../src/ArcSignSigner.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,mCAA4H;AAE5H,gDAAwB;AAExB,MAAa,aAAc,SAAQ,uBAAc;IAO/C,YAAY,OAAe,EAAE,MAAqB,EAAE,WAA4B,IAAI;QAClF,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACpC,CAAC;IAED;;;OAGG;IACK,mBAAmB;QACzB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhC,8CAA8C;QAC9C,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC3D,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAE5D,iEAAiE;QACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,uEAAuE;YACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YACvF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1B,uCAAuC;gBACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAAE,SAAS;gBAEhD,mCAAmC;gBACnC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAC7B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAC3B,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;oBAC5B,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACxB,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7B,MAAM,UAAU,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC3C,6BAA6B;oBAC7B,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;wBAAE,SAAS;oBAE7C,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,UAAU,CAAC,CAAC;oBACtD,OAAO;wBACL,WAAW,EAAE,UAAU;wBACvB,YAAY,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;wBACpC,aAAa,EAAE,IAAI;qBACpB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACvE,OAAO;YACL,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAyB;QAC/B,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAA4B;QAC5C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ;YAC5C,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEhD,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE;YACvE,GAAG,IAAI,CAAC,uBAAuB,EAAE;YACjC,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,MAAuB,EACvB,KAAuC,EACvC,KAA8B;QAE9B,MAAM,SAAS,GAAG;YAChB,KAAK,EAAE;gBACL,YAAY,EAAE;oBACZ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACnC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;iBAC/C;gBACD,GAAG,KAAK;aACT;YACD,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM;YACN,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE;YACvE,GAAG,IAAI,CAAC,uBAAuB,EAAE;YACjC,WAAW,EAAE,iBAAiB;SAC/B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,EAAsB;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,+CAA+C;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAEtD,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,mBAAmB,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACrH,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YACnC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI;YACzC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE;YACnC,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACpC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACzC,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,QAAQ,EAAE;YACjD,oBAAoB,EAAE,UAAU,CAAC,oBAAoB,EAAE,QAAQ,EAAE;YACjE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAChC,KAAK,EAAE,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5E,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,uBAAuB,EAAE;gBACjC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB;aACjE;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAE9C,+EAA+E;QAC/E,yDAAyD;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,EAAsB;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAEhD,eAAe;QACf,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,sCAAsC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAEnE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,OAAe;QACnC,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACzB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,MAAc;QAChC,yBAAyB;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5C,gCAAgC;QAChC,OAAO,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AAhOD,sCAgOC"}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @arcsign/hardhat-plugin
+ *
+ * Hardhat plugin for secure transaction signing with ArcSign wallet.
+ * Eliminates the need for private keys in .env files.
+ *
+ * Usage in hardhat.config.ts:
+ *
+ * ```typescript
+ * import "@arcsign/hardhat-plugin";
+ *
+ * export default {
+ *   networks: {
+ *     mainnet: {
+ *       url: process.env.RPC_URL,
+ *       accounts: [],     // Empty - ArcSign provides signers
+ *       arcsign: true,    // Enable ArcSign for this network
+ *     },
+ *   },
+ * };
+ * ```
+ */
+import { ArcSignProvider } from "./ArcSignProvider";
+import { ArcSignClient } from "./ArcSignClient";
+declare module "hardhat/types/runtime" {
+    interface HardhatRuntimeEnvironment {
+        arcsign: {
+            provider: ArcSignProvider;
+            client: ArcSignClient;
+            isConnected: () => Promise<boolean>;
+            getAccounts: () => Promise<string[]>;
+            getExplorerApiKey: (explorer: string) => Promise<string | null>;
+        };
+    }
+}
+declare module "hardhat/types/config" {
+    interface HardhatConfig {
+        etherscan?: {
+            apiKey?: string | Record<string, string>;
+            customChains?: unknown[];
+        };
+    }
+}
+export { ArcSignProvider } from "./ArcSignProvider";
+export { ArcSignSigner } from "./ArcSignSigner";
+export { ArcSignClient } from "./ArcSignClient";
+export { getExplorerForChainId, isTestnet, getChainIdForNetwork } from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAShD,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,yBAAyB;QACjC,OAAO,EAAE;YACP,QAAQ,EAAE,eAAe,CAAC;YAC1B,MAAM,EAAE,aAAa,CAAC;YACtB,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACpC,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACrC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;SACjE,CAAC;KACH;CACF;AAGD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,aAAa;QACrB,SAAS,CAAC,EAAE;YACV,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;SAC1B,CAAC;KACH;CACF;AAgKD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}