@0xkey-io/gas-station 0.1.0

package/dist/intentBuilder.js

@@ -0,0 +1,259 @@
+'use strict';
+
+var viem = require('viem');
+var gasStationUtils = require('./gasStationUtils.js');
+
+class IntentBuilder {
+    constructor(config) {
+        this.callData = "0x";
+        this.ethAmount = 0n;
+        this.config = config;
+    }
+    /**
+     * Set the target contract for this intent execution
+     */
+    setTarget(contract) {
+        this.outputContract = contract;
+        return this;
+    }
+    /**
+     * Set the ETH value to send with this intent
+     */
+    withValue(value) {
+        this.ethAmount = value;
+        return this;
+    }
+    /**
+     * Set a specific nonce (otherwise will be auto-fetched)
+     */
+    withNonce(nonce) {
+        this.nonce = nonce;
+        return this;
+    }
+    /**
+     * Set an expiration deadline (unix timestamp in seconds)
+     * If not set, defaults to 1 hour from now
+     */
+    withDeadline(deadline) {
+        this.deadline = deadline;
+        return this;
+    }
+    /**
+     * Set the call data directly (for pre-encoded function calls)
+     */
+    withCallData(callData) {
+        this.callData = callData;
+        return this;
+    }
+    /**
+     * Add a contract call to this intent
+     */
+    callContract(params) {
+        this.outputContract = params.contract;
+        this.callData = viem.encodeFunctionData({
+            abi: params.abi,
+            functionName: params.functionName,
+            args: params.args,
+        });
+        if (params.value) {
+            this.ethAmount = params.value;
+        }
+        return this;
+    }
+    /**
+     * Convenience method for ERC20 transfers
+     */
+    transferToken(token, to, amount) {
+        return this.callContract({
+            contract: token,
+            abi: gasStationUtils.ERC20_ABI,
+            functionName: "transfer",
+            args: [to, amount],
+        });
+    }
+    /**
+     * Convenience method for ERC20 approvals
+     */
+    approveToken(token, spender, amount) {
+        return this.callContract({
+            contract: token,
+            abi: gasStationUtils.ERC20_ABI,
+            functionName: "approve",
+            args: [spender, amount],
+        });
+    }
+    /**
+     * Convenience method for native ETH transfers
+     */
+    transferETH(to, amount) {
+        this.outputContract = to;
+        this.callData = "0x";
+        this.ethAmount = amount;
+        return this;
+    }
+    /**
+     * Signs the execution intent using EIP-712
+     * Returns a complete ExecutionIntent ready for execution
+     */
+    async sign(currentNonce) {
+        if (!this.outputContract) {
+            throw new Error("No target contract set. Use setTarget() or callContract()");
+        }
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = this.deadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for gas station execution
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // keccak256("Execution(uint128 nonce,uint32 deadline,address to,uint256 value,bytes data)")
+        const types = {
+            Execution: [
+                { name: "nonce", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "data", type: "bytes" },
+            ],
+        };
+        const message = {
+            nonce,
+            deadline,
+            to: this.outputContract,
+            value: this.ethAmount,
+            data: this.callData,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "Execution",
+            message,
+        });
+        return {
+            nonce,
+            deadline,
+            outputContract: this.outputContract,
+            ethAmount: this.ethAmount,
+            callData: this.callData,
+            signature,
+            eoaAddress: this.config.eoaAddress,
+        };
+    }
+    /**
+     * Signs an approval then execution intent using EIP-712
+     * This allows atomic approval of an ERC20 token followed by execution
+     * Returns a complete ApprovalExecutionIntent ready for execution
+     */
+    async signApprovalExecution(currentNonce, erc20Address, spender, approveAmount) {
+        if (!this.outputContract) {
+            throw new Error("No target contract set. Use setTarget() or callContract()");
+        }
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = this.deadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for approve then execute
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // Based on hashApproveThenExecute from the contract
+        // keccak256("ApproveThenExecute(uint128 nonce,uint32 deadline,address erc20Contract,address spender,uint256 approveAmount,address to,uint256 value,bytes data)")
+        const types = {
+            ApproveThenExecute: [
+                { name: "nonce", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "erc20Contract", type: "address" },
+                { name: "spender", type: "address" },
+                { name: "approveAmount", type: "uint256" },
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "data", type: "bytes" },
+            ],
+        };
+        const message = {
+            nonce,
+            deadline,
+            erc20Contract: erc20Address,
+            spender,
+            approveAmount,
+            to: this.outputContract,
+            value: this.ethAmount,
+            data: this.callData,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "ApproveThenExecute",
+            message,
+        });
+        return {
+            nonce,
+            deadline,
+            outputContract: this.outputContract,
+            ethAmount: this.ethAmount,
+            callData: this.callData,
+            signature,
+            eoaAddress: this.config.eoaAddress,
+            erc20Address,
+            spender,
+            approveAmount,
+        };
+    }
+    /**
+     * Signs a session signature for USDC transfer authorization in the reimbursable gas station.
+     * This authorizes the reimbursable contract to interact with the USDC contract on behalf of the EOA.
+     * The session signature does NOT commit to a specific amount - amounts are specified at execution time.
+     * This allows the same session signature to be cached and reused for multiple transactions.
+     * Returns an 85-byte packed signature that can be passed to executeWithReimbursement().
+     */
+    async signSessionForUSDCTransfer(currentNonce, usdcAddress, reimbursableContract, sessionDeadline) {
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = sessionDeadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for session execution
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // Based on hashSessionExecution from the delegate contract
+        // keccak256("SessionExecution(uint128 counter,uint32 deadline,address sender,address to)")
+        const types = {
+            SessionExecution: [
+                { name: "counter", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "sender", type: "address" },
+                { name: "to", type: "address" },
+            ],
+        };
+        const message = {
+            counter: nonce,
+            deadline,
+            sender: reimbursableContract,
+            to: usdcAddress,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "SessionExecution",
+            message,
+        });
+        return gasStationUtils.packSessionSignature({ signature, nonce, deadline });
+    }
+    // Static factory method for quick intent creation
+    static create(config) {
+        return new IntentBuilder(config);
+    }
+}
+
+exports.IntentBuilder = IntentBuilder;
+//# sourceMappingURL=intentBuilder.js.map

package/dist/intentBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentBuilder.js","sources":["../src/intentBuilder.ts"],"sourcesContent":[null],"names":["encodeFunctionData","ERC20_ABI","packSessionSignature"],"mappings":"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"}

package/dist/intentBuilder.mjs

@@ -0,0 +1,257 @@
+import { encodeFunctionData } from 'viem';
+import { ERC20_ABI, packSessionSignature } from './gasStationUtils.mjs';
+
+class IntentBuilder {
+    constructor(config) {
+        this.callData = "0x";
+        this.ethAmount = 0n;
+        this.config = config;
+    }
+    /**
+     * Set the target contract for this intent execution
+     */
+    setTarget(contract) {
+        this.outputContract = contract;
+        return this;
+    }
+    /**
+     * Set the ETH value to send with this intent
+     */
+    withValue(value) {
+        this.ethAmount = value;
+        return this;
+    }
+    /**
+     * Set a specific nonce (otherwise will be auto-fetched)
+     */
+    withNonce(nonce) {
+        this.nonce = nonce;
+        return this;
+    }
+    /**
+     * Set an expiration deadline (unix timestamp in seconds)
+     * If not set, defaults to 1 hour from now
+     */
+    withDeadline(deadline) {
+        this.deadline = deadline;
+        return this;
+    }
+    /**
+     * Set the call data directly (for pre-encoded function calls)
+     */
+    withCallData(callData) {
+        this.callData = callData;
+        return this;
+    }
+    /**
+     * Add a contract call to this intent
+     */
+    callContract(params) {
+        this.outputContract = params.contract;
+        this.callData = encodeFunctionData({
+            abi: params.abi,
+            functionName: params.functionName,
+            args: params.args,
+        });
+        if (params.value) {
+            this.ethAmount = params.value;
+        }
+        return this;
+    }
+    /**
+     * Convenience method for ERC20 transfers
+     */
+    transferToken(token, to, amount) {
+        return this.callContract({
+            contract: token,
+            abi: ERC20_ABI,
+            functionName: "transfer",
+            args: [to, amount],
+        });
+    }
+    /**
+     * Convenience method for ERC20 approvals
+     */
+    approveToken(token, spender, amount) {
+        return this.callContract({
+            contract: token,
+            abi: ERC20_ABI,
+            functionName: "approve",
+            args: [spender, amount],
+        });
+    }
+    /**
+     * Convenience method for native ETH transfers
+     */
+    transferETH(to, amount) {
+        this.outputContract = to;
+        this.callData = "0x";
+        this.ethAmount = amount;
+        return this;
+    }
+    /**
+     * Signs the execution intent using EIP-712
+     * Returns a complete ExecutionIntent ready for execution
+     */
+    async sign(currentNonce) {
+        if (!this.outputContract) {
+            throw new Error("No target contract set. Use setTarget() or callContract()");
+        }
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = this.deadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for gas station execution
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // keccak256("Execution(uint128 nonce,uint32 deadline,address to,uint256 value,bytes data)")
+        const types = {
+            Execution: [
+                { name: "nonce", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "data", type: "bytes" },
+            ],
+        };
+        const message = {
+            nonce,
+            deadline,
+            to: this.outputContract,
+            value: this.ethAmount,
+            data: this.callData,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "Execution",
+            message,
+        });
+        return {
+            nonce,
+            deadline,
+            outputContract: this.outputContract,
+            ethAmount: this.ethAmount,
+            callData: this.callData,
+            signature,
+            eoaAddress: this.config.eoaAddress,
+        };
+    }
+    /**
+     * Signs an approval then execution intent using EIP-712
+     * This allows atomic approval of an ERC20 token followed by execution
+     * Returns a complete ApprovalExecutionIntent ready for execution
+     */
+    async signApprovalExecution(currentNonce, erc20Address, spender, approveAmount) {
+        if (!this.outputContract) {
+            throw new Error("No target contract set. Use setTarget() or callContract()");
+        }
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = this.deadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for approve then execute
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // Based on hashApproveThenExecute from the contract
+        // keccak256("ApproveThenExecute(uint128 nonce,uint32 deadline,address erc20Contract,address spender,uint256 approveAmount,address to,uint256 value,bytes data)")
+        const types = {
+            ApproveThenExecute: [
+                { name: "nonce", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "erc20Contract", type: "address" },
+                { name: "spender", type: "address" },
+                { name: "approveAmount", type: "uint256" },
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "data", type: "bytes" },
+            ],
+        };
+        const message = {
+            nonce,
+            deadline,
+            erc20Contract: erc20Address,
+            spender,
+            approveAmount,
+            to: this.outputContract,
+            value: this.ethAmount,
+            data: this.callData,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "ApproveThenExecute",
+            message,
+        });
+        return {
+            nonce,
+            deadline,
+            outputContract: this.outputContract,
+            ethAmount: this.ethAmount,
+            callData: this.callData,
+            signature,
+            eoaAddress: this.config.eoaAddress,
+            erc20Address,
+            spender,
+            approveAmount,
+        };
+    }
+    /**
+     * Signs a session signature for USDC transfer authorization in the reimbursable gas station.
+     * This authorizes the reimbursable contract to interact with the USDC contract on behalf of the EOA.
+     * The session signature does NOT commit to a specific amount - amounts are specified at execution time.
+     * This allows the same session signature to be cached and reused for multiple transactions.
+     * Returns an 85-byte packed signature that can be passed to executeWithReimbursement().
+     */
+    async signSessionForUSDCTransfer(currentNonce, usdcAddress, reimbursableContract, sessionDeadline) {
+        const nonce = this.nonce ?? currentNonce;
+        // Default deadline: 1 hour from now
+        const deadline = sessionDeadline ?? Math.floor(Date.now() / 1000) + 60 * 60;
+        // EIP-712 domain and types for session execution
+        const domain = {
+            name: "TKGasDelegate",
+            version: "1",
+            chainId: this.config.chainId,
+            verifyingContract: this.config.eoaAddress,
+        };
+        // Based on hashSessionExecution from the delegate contract
+        // keccak256("SessionExecution(uint128 counter,uint32 deadline,address sender,address to)")
+        const types = {
+            SessionExecution: [
+                { name: "counter", type: "uint128" },
+                { name: "deadline", type: "uint32" },
+                { name: "sender", type: "address" },
+                { name: "to", type: "address" },
+            ],
+        };
+        const message = {
+            counter: nonce,
+            deadline,
+            sender: reimbursableContract,
+            to: usdcAddress,
+        };
+        const signature = await this.config.eoaWalletClient.signTypedData({
+            account: this.config.eoaWalletClient.account,
+            domain,
+            types,
+            primaryType: "SessionExecution",
+            message,
+        });
+        return packSessionSignature({ signature, nonce, deadline });
+    }
+    // Static factory method for quick intent creation
+    static create(config) {
+        return new IntentBuilder(config);
+    }
+}
+
+export { IntentBuilder };
+//# sourceMappingURL=intentBuilder.mjs.map

package/dist/intentBuilder.mjs.map

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