@turnkey/gas-station 0.2.0

package/dist/config.js

@@ -0,0 +1,57 @@
+'use strict';
+
+var chains = require('viem/chains');
+
+// Default contract addresses (deterministically deployed across all chains)
+const DEFAULT_DELEGATE_CONTRACT = "0xC2a37Ee08cAc3778d9d05FF0a93FD5B553C77E3a";
+const DEFAULT_EXECUTION_CONTRACT = "0x4ece92b06C7d2d99d87f052E0Fca47Fb180c3348";
+// Chain preset configurations
+const CHAIN_PRESETS = {
+    BASE_MAINNET: {
+        chain: chains.base,
+        rpcUrl: process.env.BASE_RPC_URL || "",
+        tokens: {
+            USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        },
+    },
+    ETHEREUM_MAINNET: {
+        chain: chains.mainnet,
+        rpcUrl: process.env.ETH_RPC_URL || "",
+        tokens: {
+            USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        },
+    },
+    SEPOLIA: {
+        chain: chains.sepolia,
+        rpcUrl: process.env.SEPOLIA_RPC_URL || "",
+    },
+};
+/**
+ * Create a custom preset with validation
+ */
+function createCustomPreset(config) {
+    if (!config.chain) {
+        throw new Error("Chain configuration is required");
+    }
+    if (!config.rpcUrl) {
+        throw new Error("RPC URL is required");
+    }
+    return config;
+}
+/**
+ * Get a preset with optional environment variable overrides
+ */
+function getPreset(presetName, overrides) {
+    const preset = CHAIN_PRESETS[presetName];
+    if (!preset) {
+        throw new Error(`Unknown preset: ${presetName}. Available: ${Object.keys(CHAIN_PRESETS).join(", ")}`);
+    }
+    return { ...preset, ...overrides };
+}
+
+exports.CHAIN_PRESETS = CHAIN_PRESETS;
+exports.DEFAULT_DELEGATE_CONTRACT = DEFAULT_DELEGATE_CONTRACT;
+exports.DEFAULT_EXECUTION_CONTRACT = DEFAULT_EXECUTION_CONTRACT;
+exports.createCustomPreset = createCustomPreset;
+exports.getPreset = getPreset;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sources":["../src/config.ts"],"sourcesContent":[null],"names":["base","mainnet","sepolia"],"mappings":";;;;AAGA;AACO,MAAM,yBAAyB,GACpC;AACK,MAAM,0BAA0B,GACrC;AAsCF;AACO,MAAM,aAAa,GAAgC;AACxD,IAAA,YAAY,EAAE;AACZ,QAAA,KAAK,EAAEA,WAAI;AACX,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;AACtC,QAAA,MAAM,EAAE;AACN,YAAA,IAAI,EAAE,4CAA4C;AACnD,SAAA;AACF,KAAA;AACD,IAAA,gBAAgB,EAAE;AAChB,QAAA,KAAK,EAAEC,cAAO;AACd,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;AACrC,QAAA,MAAM,EAAE;AACN,YAAA,IAAI,EAAE,4CAA4C;AACnD,SAAA;AACF,KAAA;AACD,IAAA,OAAO,EAAE;AACP,QAAA,KAAK,EAAEC,cAAO;AACd,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;AAC1C,KAAA;;AAGH;;AAEG;AACG,SAAU,kBAAkB,CAAC,MAAmB,EAAA;AACpD,IAAA,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;AACjB,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IACpD;AACA,IAAA,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;AAClB,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;IACxC;AACA,IAAA,OAAO,MAAM;AACf;AAEA;;AAEG;AACG,SAAU,SAAS,CACvB,UAAsC,EACtC,SAAgC,EAAA;AAEhC,IAAA,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,MAAM,IAAI,KAAK,CACb,mBAAmB,UAAU,CAAA,aAAA,EAAgB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CACrF;IACH;AACA,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE;AACpC;;;;;;;;"}

package/dist/config.mjs

@@ -0,0 +1,51 @@
+import { sepolia, mainnet, base } from 'viem/chains';
+
+// Default contract addresses (deterministically deployed across all chains)
+const DEFAULT_DELEGATE_CONTRACT = "0xC2a37Ee08cAc3778d9d05FF0a93FD5B553C77E3a";
+const DEFAULT_EXECUTION_CONTRACT = "0x4ece92b06C7d2d99d87f052E0Fca47Fb180c3348";
+// Chain preset configurations
+const CHAIN_PRESETS = {
+    BASE_MAINNET: {
+        chain: base,
+        rpcUrl: process.env.BASE_RPC_URL || "",
+        tokens: {
+            USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        },
+    },
+    ETHEREUM_MAINNET: {
+        chain: mainnet,
+        rpcUrl: process.env.ETH_RPC_URL || "",
+        tokens: {
+            USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        },
+    },
+    SEPOLIA: {
+        chain: sepolia,
+        rpcUrl: process.env.SEPOLIA_RPC_URL || "",
+    },
+};
+/**
+ * Create a custom preset with validation
+ */
+function createCustomPreset(config) {
+    if (!config.chain) {
+        throw new Error("Chain configuration is required");
+    }
+    if (!config.rpcUrl) {
+        throw new Error("RPC URL is required");
+    }
+    return config;
+}
+/**
+ * Get a preset with optional environment variable overrides
+ */
+function getPreset(presetName, overrides) {
+    const preset = CHAIN_PRESETS[presetName];
+    if (!preset) {
+        throw new Error(`Unknown preset: ${presetName}. Available: ${Object.keys(CHAIN_PRESETS).join(", ")}`);
+    }
+    return { ...preset, ...overrides };
+}
+
+export { CHAIN_PRESETS, DEFAULT_DELEGATE_CONTRACT, DEFAULT_EXECUTION_CONTRACT, createCustomPreset, getPreset };
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","sources":["../src/config.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;AACO,MAAM,yBAAyB,GACpC;AACK,MAAM,0BAA0B,GACrC;AAsCF;AACO,MAAM,aAAa,GAAgC;AACxD,IAAA,YAAY,EAAE;AACZ,QAAA,KAAK,EAAE,IAAI;AACX,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;AACtC,QAAA,MAAM,EAAE;AACN,YAAA,IAAI,EAAE,4CAA4C;AACnD,SAAA;AACF,KAAA;AACD,IAAA,gBAAgB,EAAE;AAChB,QAAA,KAAK,EAAE,OAAO;AACd,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;AACrC,QAAA,MAAM,EAAE;AACN,YAAA,IAAI,EAAE,4CAA4C;AACnD,SAAA;AACF,KAAA;AACD,IAAA,OAAO,EAAE;AACP,QAAA,KAAK,EAAE,OAAO;AACd,QAAA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;AAC1C,KAAA;;AAGH;;AAEG;AACG,SAAU,kBAAkB,CAAC,MAAmB,EAAA;AACpD,IAAA,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;AACjB,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IACpD;AACA,IAAA,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;AAClB,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;IACxC;AACA,IAAA,OAAO,MAAM;AACf;AAEA;;AAEG;AACG,SAAU,SAAS,CACvB,UAAsC,EACtC,SAAgC,EAAA;AAEhC,IAAA,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,MAAM,IAAI,KAAK,CACb,mBAAmB,UAAU,CAAA,aAAA,EAAgB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CACrF;IACH;AACA,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE;AACpC;;;;"}

package/dist/gasStationClient.d.ts

@@ -0,0 +1,71 @@
+import { type SignedAuthorization } from "viem";
+import type { GasStationConfig, ExecutionIntent } from "./config";
+import { IntentBuilder } from "./intentBuilder";
+export declare class GasStationClient {
+    private walletClient;
+    private publicClient;
+    private delegateContract;
+    private executionContract;
+    constructor(config: GasStationConfig);
+    /**
+     * Sign an EIP-7702 authorization to delegate control to the gas station contract
+     * Call this with an end-user client to get a signed authorization
+     * The authorization can then be submitted by the paymaster using submitAuthorization()
+     */
+    signAuthorization(): Promise<SignedAuthorization>;
+    /**
+     * Submit signed EIP-7702 authorization transaction(s)
+     * Supports authorizing multiple EOAs in a single transaction
+     * Call this with a paymaster client to broadcast the authorization transaction
+     * The paymaster pays for the gas
+     */
+    submitAuthorizations(authorizations: SignedAuthorization[]): Promise<{
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+    }>;
+    /**
+     * Check if an EOA is delegated to the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    isAuthorized(eoaAddress?: `0x${string}`): Promise<boolean>;
+    /**
+     * Get the current nonce for an EOA address from the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    getNonce(eoaAddress?: `0x${string}`): Promise<bigint>;
+    /**
+     * Attempts to get the revert reason from a failed transaction.
+     * Replays the transaction via eth_call to extract detailed error information.
+     *
+     * This helps surface on-chain failure reasons such as:
+     * - Out of gas errors
+     * - Revert with reason strings
+     * - Custom error selectors
+     * - Insufficient balance errors
+     */
+    private getRevertReason;
+    /**
+     * Create an intent builder for composing complex transactions
+     * Call this with an end-user client to create intents for signing
+     */
+    createIntent(): IntentBuilder;
+    /**
+     * Sign an execution transaction for a signed intent (paymaster signs, doesn't send)
+     * This is useful for testing policies - the paymaster attempts to sign the execution
+     * but doesn't actually broadcast it to the network.
+     * Call this with a paymaster client to test if the paymaster can sign the execution.
+     */
+    signExecution(intent: ExecutionIntent): Promise<`0x${string}`>;
+    /**
+     * Execute a signed intent through the gas station contract.
+     * Packs the execution data according to the delegate contract's expected format and
+     * submits it via the execution contract.
+     * Call this with a paymaster client to submit and pay for the transaction.
+     */
+    execute(intent: ExecutionIntent): Promise<{
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+        gasUsed: bigint;
+    }>;
+}
+//# sourceMappingURL=gasStationClient.d.ts.map

package/dist/gasStationClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasStationClient.d.ts","sourceRoot":"","sources":["../src/gasStationClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAMzB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKlE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,MAAM,EAAE,gBAAgB;IAYpC;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAUvD;;;;;OAKG;IACG,oBAAoB,CACxB,cAAc,EAAE,mBAAmB,EAAE,GACpC,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IA8B1D;;;OAGG;IACG,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAahE;;;OAGG;IACG,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D;;;;;;;;;OASG;YACW,eAAe;IAkD7B;;;OAGG;IACH,YAAY,IAAI,aAAa;IAa7B;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAkCpE;;;;;OAKG;IACG,OAAO,CACX,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA8C5E"}

package/dist/gasStationClient.js

@@ -0,0 +1,237 @@
+'use strict';
+
+var viem = require('viem');
+var gasStation = require('./abi/gas-station.js');
+var config = require('./config.js');
+var intentBuilder = require('./intentBuilder.js');
+var gasStationUtils = require('./gasStationUtils.js');
+
+class GasStationClient {
+    constructor(config$1) {
+        this.walletClient = config$1.walletClient;
+        this.publicClient = gasStationUtils.createPublicClientForChain(config$1.walletClient.chain, config$1.walletClient.transport.url);
+        this.delegateContract =
+            config$1.delegateContract ?? config.DEFAULT_DELEGATE_CONTRACT;
+        this.executionContract =
+            config$1.executionContract ?? config.DEFAULT_EXECUTION_CONTRACT;
+    }
+    /**
+     * Sign an EIP-7702 authorization to delegate control to the gas station contract
+     * Call this with an end-user client to get a signed authorization
+     * The authorization can then be submitted by the paymaster using submitAuthorization()
+     */
+    async signAuthorization() {
+        const authorization = await this.walletClient.signAuthorization({
+            contractAddress: this.delegateContract,
+            account: this.walletClient.account,
+            chainId: 0, // 0 means valid on any EIP-7702 compatible chain
+        });
+        return authorization;
+    }
+    /**
+     * Submit signed EIP-7702 authorization transaction(s)
+     * Supports authorizing multiple EOAs in a single transaction
+     * Call this with a paymaster client to broadcast the authorization transaction
+     * The paymaster pays for the gas
+     */
+    async submitAuthorizations(authorizations) {
+        if (authorizations.length === 0) {
+            throw new Error("Authorization list cannot be empty");
+        }
+        const authTxHash = await this.walletClient.sendTransaction({
+            from: "0x0000000000000000000000000000000000000000",
+            authorizationList: authorizations,
+            to: "0x0000000000000000000000000000000000000000",
+            type: "eip7702",
+            account: this.walletClient.account,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: authTxHash,
+        });
+        if (receipt.status !== "success") {
+            // Try to get the revert reason if available
+            const revertReason = await this.getRevertReason(authTxHash);
+            throw new Error(`Authorization failed: ${revertReason || "Transaction reverted"}. ` +
+                `Gas used: ${receipt.gasUsed}/${receipt.cumulativeGasUsed}. ` +
+                `Transaction hash: ${authTxHash}`);
+        }
+        return { txHash: authTxHash, blockNumber: receipt.blockNumber };
+    }
+    /**
+     * Check if an EOA is delegated to the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    async isAuthorized(eoaAddress) {
+        const address = eoaAddress ?? this.walletClient.account.address;
+        const isAuthorized = await this.publicClient.readContract({
+            address: this.executionContract,
+            abi: gasStation.gasStationAbi,
+            functionName: "isDelegated",
+            args: [address],
+        });
+        return isAuthorized;
+    }
+    /**
+     * Get the current nonce for an EOA address from the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    async getNonce(eoaAddress) {
+        const address = eoaAddress ?? this.walletClient.account.address;
+        const nonce = await this.publicClient.readContract({
+            address: this.executionContract,
+            abi: gasStation.gasStationAbi,
+            functionName: "getNonce",
+            args: [address],
+        });
+        return nonce;
+    }
+    /**
+     * Attempts to get the revert reason from a failed transaction.
+     * Replays the transaction via eth_call to extract detailed error information.
+     *
+     * This helps surface on-chain failure reasons such as:
+     * - Out of gas errors
+     * - Revert with reason strings
+     * - Custom error selectors
+     * - Insufficient balance errors
+     */
+    async getRevertReason(txHash) {
+        try {
+            const tx = await this.publicClient.getTransaction({ hash: txHash });
+            // Replay the transaction via eth_call to trigger the revert and get the reason
+            await this.publicClient.call({
+                to: tx.to,
+                data: tx.input,
+                gas: tx.gas,
+                value: tx.value,
+            });
+            // If call succeeds, we don't have a revert reason (shouldn't happen for failed tx)
+            return null;
+        }
+        catch (error) {
+            // Extract revert reason from error message
+            if (error?.details) {
+                return error.details;
+            }
+            if (error?.message) {
+                // Check for out of gas errors
+                const outOfGasMatch = error.message.match(/out of gas/i);
+                if (outOfGasMatch) {
+                    return "Out of gas";
+                }
+                // Check for standard revert with reason string
+                const revertMatch = error.message.match(/reverted with reason string '([^']+)'/);
+                if (revertMatch) {
+                    return revertMatch[1];
+                }
+                // Check for custom errors (Solidity 0.8.4+)
+                const customErrorMatch = error.message.match(/reverted with the following \(custom\) error:\s*([^\n]+)/);
+                if (customErrorMatch) {
+                    return customErrorMatch[1];
+                }
+                // Return the full error message if no specific pattern matches
+                return error.message;
+            }
+            return null;
+        }
+    }
+    /**
+     * Create an intent builder for composing complex transactions
+     * Call this with an end-user client to create intents for signing
+     */
+    createIntent() {
+        if (!this.walletClient.account?.address) {
+            throw new Error(`Wallet client account is not properly configured. Account: ${JSON.stringify(this.walletClient.account)}`);
+        }
+        return intentBuilder.IntentBuilder.create({
+            eoaWalletClient: this.walletClient,
+            chainId: this.walletClient.chain.id,
+            eoaAddress: this.walletClient.account.address,
+        });
+    }
+    /**
+     * Sign an execution transaction for a signed intent (paymaster signs, doesn't send)
+     * This is useful for testing policies - the paymaster attempts to sign the execution
+     * but doesn't actually broadcast it to the network.
+     * Call this with a paymaster client to test if the paymaster can sign the execution.
+     */
+    async signExecution(intent) {
+        // Pack the execution data (signature, nonce, deadline, args)
+        const packedData = gasStationUtils.packExecutionData({
+            signature: intent.signature,
+            nonce: intent.nonce,
+            deadline: intent.deadline,
+            args: intent.callData,
+        });
+        // Encode the function call data
+        const callData = viem.encodeFunctionData({
+            abi: gasStation.gasStationAbi,
+            functionName: "execute",
+            args: [
+                intent.eoaAddress,
+                intent.outputContract,
+                intent.ethAmount,
+                packedData,
+            ],
+        });
+        // Sign the transaction without sending it
+        const signedTx = await this.walletClient.signTransaction({
+            to: this.executionContract,
+            data: callData,
+            gas: BigInt(200000),
+            type: "eip1559",
+            account: this.walletClient.account,
+            chain: this.walletClient.chain,
+        });
+        return signedTx;
+    }
+    /**
+     * Execute a signed intent through the gas station contract.
+     * Packs the execution data according to the delegate contract's expected format and
+     * submits it via the execution contract.
+     * Call this with a paymaster client to submit and pay for the transaction.
+     */
+    async execute(intent) {
+        // Pack the execution data (signature, nonce, deadline, args)
+        const packedData = gasStationUtils.packExecutionData({
+            signature: intent.signature,
+            nonce: intent.nonce,
+            deadline: intent.deadline,
+            args: intent.callData,
+        });
+        // Call the unified execute function with explicit parameters
+        const txHash = await this.walletClient.sendTransaction({
+            to: this.executionContract,
+            data: viem.encodeFunctionData({
+                abi: gasStation.gasStationAbi,
+                functionName: "execute",
+                args: [
+                    intent.eoaAddress,
+                    intent.outputContract,
+                    intent.ethAmount,
+                    packedData,
+                ],
+            }),
+            gas: BigInt(200000),
+            account: this.walletClient.account,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        if (receipt.status !== "success") {
+            // Try to get the revert reason if available
+            const revertReason = await this.getRevertReason(txHash);
+            throw new Error(`Execution failed: ${revertReason || "Transaction reverted"}. ` +
+                `Gas used: ${receipt.gasUsed}/${receipt.cumulativeGasUsed}. ` +
+                `Transaction hash: ${txHash}`);
+        }
+        return {
+            txHash,
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+}
+
+exports.GasStationClient = GasStationClient;
+//# sourceMappingURL=gasStationClient.js.map

package/dist/gasStationClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasStationClient.js","sources":["../src/gasStationClient.ts"],"sourcesContent":[null],"names":["config","createPublicClientForChain","DEFAULT_DELEGATE_CONTRACT","DEFAULT_EXECUTION_CONTRACT","gasStationAbi","IntentBuilder","packExecutionData","encodeFunctionData"],"mappings":"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"}

package/dist/gasStationClient.mjs

@@ -0,0 +1,235 @@
+import { encodeFunctionData } from 'viem';
+import { gasStationAbi } from './abi/gas-station.mjs';
+import { DEFAULT_DELEGATE_CONTRACT, DEFAULT_EXECUTION_CONTRACT } from './config.mjs';
+import { IntentBuilder } from './intentBuilder.mjs';
+import { createPublicClientForChain, packExecutionData } from './gasStationUtils.mjs';
+
+class GasStationClient {
+    constructor(config) {
+        this.walletClient = config.walletClient;
+        this.publicClient = createPublicClientForChain(config.walletClient.chain, config.walletClient.transport.url);
+        this.delegateContract =
+            config.delegateContract ?? DEFAULT_DELEGATE_CONTRACT;
+        this.executionContract =
+            config.executionContract ?? DEFAULT_EXECUTION_CONTRACT;
+    }
+    /**
+     * Sign an EIP-7702 authorization to delegate control to the gas station contract
+     * Call this with an end-user client to get a signed authorization
+     * The authorization can then be submitted by the paymaster using submitAuthorization()
+     */
+    async signAuthorization() {
+        const authorization = await this.walletClient.signAuthorization({
+            contractAddress: this.delegateContract,
+            account: this.walletClient.account,
+            chainId: 0, // 0 means valid on any EIP-7702 compatible chain
+        });
+        return authorization;
+    }
+    /**
+     * Submit signed EIP-7702 authorization transaction(s)
+     * Supports authorizing multiple EOAs in a single transaction
+     * Call this with a paymaster client to broadcast the authorization transaction
+     * The paymaster pays for the gas
+     */
+    async submitAuthorizations(authorizations) {
+        if (authorizations.length === 0) {
+            throw new Error("Authorization list cannot be empty");
+        }
+        const authTxHash = await this.walletClient.sendTransaction({
+            from: "0x0000000000000000000000000000000000000000",
+            authorizationList: authorizations,
+            to: "0x0000000000000000000000000000000000000000",
+            type: "eip7702",
+            account: this.walletClient.account,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: authTxHash,
+        });
+        if (receipt.status !== "success") {
+            // Try to get the revert reason if available
+            const revertReason = await this.getRevertReason(authTxHash);
+            throw new Error(`Authorization failed: ${revertReason || "Transaction reverted"}. ` +
+                `Gas used: ${receipt.gasUsed}/${receipt.cumulativeGasUsed}. ` +
+                `Transaction hash: ${authTxHash}`);
+        }
+        return { txHash: authTxHash, blockNumber: receipt.blockNumber };
+    }
+    /**
+     * Check if an EOA is delegated to the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    async isAuthorized(eoaAddress) {
+        const address = eoaAddress ?? this.walletClient.account.address;
+        const isAuthorized = await this.publicClient.readContract({
+            address: this.executionContract,
+            abi: gasStationAbi,
+            functionName: "isDelegated",
+            args: [address],
+        });
+        return isAuthorized;
+    }
+    /**
+     * Get the current nonce for an EOA address from the gas station contract
+     * If no address is provided, uses the signer's address
+     */
+    async getNonce(eoaAddress) {
+        const address = eoaAddress ?? this.walletClient.account.address;
+        const nonce = await this.publicClient.readContract({
+            address: this.executionContract,
+            abi: gasStationAbi,
+            functionName: "getNonce",
+            args: [address],
+        });
+        return nonce;
+    }
+    /**
+     * Attempts to get the revert reason from a failed transaction.
+     * Replays the transaction via eth_call to extract detailed error information.
+     *
+     * This helps surface on-chain failure reasons such as:
+     * - Out of gas errors
+     * - Revert with reason strings
+     * - Custom error selectors
+     * - Insufficient balance errors
+     */
+    async getRevertReason(txHash) {
+        try {
+            const tx = await this.publicClient.getTransaction({ hash: txHash });
+            // Replay the transaction via eth_call to trigger the revert and get the reason
+            await this.publicClient.call({
+                to: tx.to,
+                data: tx.input,
+                gas: tx.gas,
+                value: tx.value,
+            });
+            // If call succeeds, we don't have a revert reason (shouldn't happen for failed tx)
+            return null;
+        }
+        catch (error) {
+            // Extract revert reason from error message
+            if (error?.details) {
+                return error.details;
+            }
+            if (error?.message) {
+                // Check for out of gas errors
+                const outOfGasMatch = error.message.match(/out of gas/i);
+                if (outOfGasMatch) {
+                    return "Out of gas";
+                }
+                // Check for standard revert with reason string
+                const revertMatch = error.message.match(/reverted with reason string '([^']+)'/);
+                if (revertMatch) {
+                    return revertMatch[1];
+                }
+                // Check for custom errors (Solidity 0.8.4+)
+                const customErrorMatch = error.message.match(/reverted with the following \(custom\) error:\s*([^\n]+)/);
+                if (customErrorMatch) {
+                    return customErrorMatch[1];
+                }
+                // Return the full error message if no specific pattern matches
+                return error.message;
+            }
+            return null;
+        }
+    }
+    /**
+     * Create an intent builder for composing complex transactions
+     * Call this with an end-user client to create intents for signing
+     */
+    createIntent() {
+        if (!this.walletClient.account?.address) {
+            throw new Error(`Wallet client account is not properly configured. Account: ${JSON.stringify(this.walletClient.account)}`);
+        }
+        return IntentBuilder.create({
+            eoaWalletClient: this.walletClient,
+            chainId: this.walletClient.chain.id,
+            eoaAddress: this.walletClient.account.address,
+        });
+    }
+    /**
+     * Sign an execution transaction for a signed intent (paymaster signs, doesn't send)
+     * This is useful for testing policies - the paymaster attempts to sign the execution
+     * but doesn't actually broadcast it to the network.
+     * Call this with a paymaster client to test if the paymaster can sign the execution.
+     */
+    async signExecution(intent) {
+        // Pack the execution data (signature, nonce, deadline, args)
+        const packedData = packExecutionData({
+            signature: intent.signature,
+            nonce: intent.nonce,
+            deadline: intent.deadline,
+            args: intent.callData,
+        });
+        // Encode the function call data
+        const callData = encodeFunctionData({
+            abi: gasStationAbi,
+            functionName: "execute",
+            args: [
+                intent.eoaAddress,
+                intent.outputContract,
+                intent.ethAmount,
+                packedData,
+            ],
+        });
+        // Sign the transaction without sending it
+        const signedTx = await this.walletClient.signTransaction({
+            to: this.executionContract,
+            data: callData,
+            gas: BigInt(200000),
+            type: "eip1559",
+            account: this.walletClient.account,
+            chain: this.walletClient.chain,
+        });
+        return signedTx;
+    }
+    /**
+     * Execute a signed intent through the gas station contract.
+     * Packs the execution data according to the delegate contract's expected format and
+     * submits it via the execution contract.
+     * Call this with a paymaster client to submit and pay for the transaction.
+     */
+    async execute(intent) {
+        // Pack the execution data (signature, nonce, deadline, args)
+        const packedData = packExecutionData({
+            signature: intent.signature,
+            nonce: intent.nonce,
+            deadline: intent.deadline,
+            args: intent.callData,
+        });
+        // Call the unified execute function with explicit parameters
+        const txHash = await this.walletClient.sendTransaction({
+            to: this.executionContract,
+            data: encodeFunctionData({
+                abi: gasStationAbi,
+                functionName: "execute",
+                args: [
+                    intent.eoaAddress,
+                    intent.outputContract,
+                    intent.ethAmount,
+                    packedData,
+                ],
+            }),
+            gas: BigInt(200000),
+            account: this.walletClient.account,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        if (receipt.status !== "success") {
+            // Try to get the revert reason if available
+            const revertReason = await this.getRevertReason(txHash);
+            throw new Error(`Execution failed: ${revertReason || "Transaction reverted"}. ` +
+                `Gas used: ${receipt.gasUsed}/${receipt.cumulativeGasUsed}. ` +
+                `Transaction hash: ${txHash}`);
+        }
+        return {
+            txHash,
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+}
+
+export { GasStationClient };
+//# sourceMappingURL=gasStationClient.mjs.map