moltspay 0.2.2 → 0.2.4

package/dist/wallet/index.js

@@ -30,13 +30,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/wallet/index.ts
 var wallet_exports = {};
 __export(wallet_exports, {
+  AllowanceWallet: () => AllowanceWallet,
+  PermitSigner: () => PermitSigner,
   PermitWallet: () => PermitWallet,
   SecureWallet: () => SecureWallet,
   Wallet: () => Wallet,
   createWallet: () => createWallet,
   formatPermitRequest: () => formatPermitRequest,
+  generatePermitInstructions: () => generatePermitInstructions,
   getWalletAddress: () => getWalletAddress,
   loadWallet: () => loadWallet,
+  signPermit: () => signPermit,
   walletExists: () => walletExists
 });
 module.exports = __toCommonJS(wallet_exports);
@@ -976,15 +980,363 @@ After signing, send { v, r, s, deadline } to the Agent.
 
 \u26A0\uFE0F Note: This authorization only allows the Agent to spend up to ${amount} USDC from your wallet. Your private key is never exposed.`;
 }
+
+// src/wallet/signPermit.ts
+var import_ethers4 = require("ethers");
+async function signPermit(config, params) {
+  const chain = config.chain || "base";
+  const chainConfig = getChain(chain);
+  const privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
+  if (!privateKey) {
+    throw new Error("privateKey is required");
+  }
+  const rpcUrl = config.rpcUrl || chainConfig.rpc;
+  const provider = new import_ethers4.ethers.JsonRpcProvider(rpcUrl);
+  const wallet = new import_ethers4.ethers.Wallet(privateKey, provider);
+  const usdcContract = new import_ethers4.ethers.Contract(chainConfig.usdc, ERC20_ABI, provider);
+  const nonce = Number(await usdcContract.nonces(wallet.address));
+  let deadline;
+  if (!params.deadline) {
+    deadline = Math.floor(Date.now() / 1e3) + 30 * 60;
+  } else if (params.deadline < 1e6) {
+    deadline = Math.floor(Date.now() / 1e3) + params.deadline * 60;
+  } else {
+    deadline = params.deadline;
+  }
+  const value = BigInt(Math.floor(params.amount * 1e6)).toString();
+  const domain = {
+    name: "USD Coin",
+    version: "2",
+    chainId: chainConfig.chainId,
+    verifyingContract: chainConfig.usdc
+  };
+  const types = {
+    Permit: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "deadline", type: "uint256" }
+    ]
+  };
+  const message = {
+    owner: wallet.address,
+    spender: params.spender,
+    value,
+    nonce,
+    deadline
+  };
+  const signature = await wallet.signTypedData(domain, types, message);
+  const sig = import_ethers4.ethers.Signature.from(signature);
+  return {
+    owner: wallet.address,
+    spender: params.spender,
+    value,
+    deadline,
+    nonce,
+    v: sig.v,
+    r: sig.r,
+    s: sig.s
+  };
+}
+var PermitSigner = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async sign(params) {
+    return signPermit(this.config, params);
+  }
+};
+
+// src/wallet/AllowanceWallet.ts
+var import_ethers5 = require("ethers");
+var PERMIT_ABI2 = [
+  ...ERC20_ABI,
+  "function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)",
+  "function transferFrom(address from, address to, uint256 amount) returns (bool)",
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function nonces(address owner) view returns (uint256)"
+];
+var AllowanceWallet = class {
+  chain;
+  chainConfig;
+  address;
+  // Agent's address
+  wallet;
+  provider;
+  usdcContract;
+  /** Stored permits from owners */
+  permits = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.chain = config.chain || "base_sepolia";
+    this.chainConfig = getChain(this.chain);
+    const rpcUrl = config.rpcUrl || this.chainConfig.rpc;
+    this.provider = new import_ethers5.ethers.JsonRpcProvider(rpcUrl);
+    this.wallet = new import_ethers5.ethers.Wallet(config.privateKey, this.provider);
+    this.address = this.wallet.address;
+    this.usdcContract = new import_ethers5.ethers.Contract(
+      this.chainConfig.usdc,
+      PERMIT_ABI2,
+      this.wallet
+    );
+  }
+  /**
+   * Store a Permit received from Owner
+   * Call this when Owner sends you a signed Permit
+   */
+  storePermit(permit) {
+    const ownerLower = permit.owner.toLowerCase();
+    this.permits.set(ownerLower, permit);
+  }
+  /**
+   * Get stored Permit for an owner
+   */
+  getPermit(owner) {
+    return this.permits.get(owner.toLowerCase());
+  }
+  /**
+   * Check allowance status with an owner
+   */
+  async checkAllowance(owner) {
+    const ownerAddress = import_ethers5.ethers.getAddress(owner);
+    const [allowance, ownerBalance, agentGasBalance] = await Promise.all([
+      this.usdcContract.allowance(ownerAddress, this.address),
+      this.usdcContract.balanceOf(ownerAddress),
+      this.provider.getBalance(this.address)
+    ]);
+    const allowanceNum = Number(allowance) / 1e6;
+    const hasGas = Number(import_ethers5.ethers.formatEther(agentGasBalance)) >= 1e-4;
+    return {
+      owner: ownerAddress,
+      agent: this.address,
+      allowance: allowanceNum.toFixed(2),
+      ownerBalance: (Number(ownerBalance) / 1e6).toFixed(2),
+      agentGasBalance: import_ethers5.ethers.formatEther(agentGasBalance),
+      canSpend: allowanceNum > 0 && hasGas,
+      chain: this.chainConfig.name
+    };
+  }
+  /**
+   * Spend from Owner's wallet using Permit allowance
+   * 
+   * @example
+   * ```typescript
+   * const agent = new AllowanceWallet({ 
+   *   chain: 'base',
+   *   privateKey: process.env.AGENT_KEY  // Only needs gas
+   * });
+   * 
+   * // Owner gave us a Permit
+   * agent.storePermit(ownerPermit);
+   * 
+   * // Spend to pay for a service
+   * const result = await agent.spend({
+   *   to: '0xServiceProvider...',
+   *   amount: 2.99,
+   * });
+   * ```
+   */
+  async spend(params) {
+    const { to, amount, permit } = params;
+    try {
+      const toAddress = import_ethers5.ethers.getAddress(to);
+      const amountWei = BigInt(Math.floor(amount * 1e6));
+      let ownerPermit = permit;
+      let ownerAddress;
+      if (ownerPermit) {
+        ownerAddress = import_ethers5.ethers.getAddress(ownerPermit.owner);
+        this.storePermit(ownerPermit);
+      } else {
+        for (const [owner, p] of this.permits) {
+          const allowance = await this.usdcContract.allowance(owner, this.address);
+          if (BigInt(allowance) >= amountWei) {
+            ownerAddress = import_ethers5.ethers.getAddress(owner);
+            ownerPermit = p;
+            break;
+          }
+        }
+        if (!ownerPermit) {
+          return {
+            success: false,
+            error: "No valid permit found. Ask Owner to sign a Permit first.",
+            from: "",
+            to: toAddress,
+            amount
+          };
+        }
+      }
+      const currentAllowance = await this.usdcContract.allowance(ownerAddress, this.address);
+      if (BigInt(currentAllowance) < amountWei) {
+        const now = Math.floor(Date.now() / 1e3);
+        if (ownerPermit.deadline < now) {
+          return {
+            success: false,
+            error: `Permit expired at ${new Date(ownerPermit.deadline * 1e3).toISOString()}. Ask Owner for a new Permit.`,
+            from: ownerAddress,
+            to: toAddress,
+            amount
+          };
+        }
+        const currentNonce = await this.usdcContract.nonces(ownerAddress);
+        if (Number(currentNonce) !== ownerPermit.nonce) {
+          return {
+            success: false,
+            error: `Permit nonce mismatch (expected ${ownerPermit.nonce}, got ${currentNonce}). Owner may have used this permit or signed a new one.`,
+            from: ownerAddress,
+            to: toAddress,
+            amount
+          };
+        }
+        console.log("[AllowanceWallet] Submitting permit on-chain...");
+        const permitTx = await this.usdcContract.permit(
+          ownerAddress,
+          this.address,
+          ownerPermit.value,
+          ownerPermit.deadline,
+          ownerPermit.v,
+          ownerPermit.r,
+          ownerPermit.s
+        );
+        await permitTx.wait();
+        console.log("[AllowanceWallet] Permit submitted:", permitTx.hash);
+      }
+      console.log("[AllowanceWallet] Executing transferFrom...");
+      const tx = await this.usdcContract.transferFrom(
+        ownerAddress,
+        toAddress,
+        amountWei
+      );
+      const receipt = await tx.wait();
+      const newAllowance = await this.usdcContract.allowance(ownerAddress, this.address);
+      return {
+        success: true,
+        txHash: tx.hash,
+        from: ownerAddress,
+        to: toAddress,
+        amount,
+        remainingAllowance: (Number(newAllowance) / 1e6).toFixed(2),
+        explorerUrl: `${this.chainConfig.explorerTx}${tx.hash}`
+      };
+    } catch (error) {
+      const message = error.message;
+      if (message.includes("ERC20InsufficientAllowance")) {
+        return {
+          success: false,
+          error: "Insufficient allowance. Ask Owner to sign a new Permit with higher amount.",
+          from: "",
+          to,
+          amount
+        };
+      }
+      if (message.includes("ERC20InsufficientBalance")) {
+        return {
+          success: false,
+          error: "Owner's wallet has insufficient USDC balance.",
+          from: "",
+          to,
+          amount
+        };
+      }
+      return {
+        success: false,
+        error: message,
+        from: "",
+        to,
+        amount
+      };
+    }
+  }
+  /**
+   * Get Agent's gas balance (ETH)
+   */
+  async getGasBalance() {
+    const balance = await this.provider.getBalance(this.address);
+    return import_ethers5.ethers.formatEther(balance);
+  }
+};
+function generatePermitInstructions(params) {
+  const { ownerAddress, agentAddress, amount, deadlineHours = 24, chain = "base" } = params;
+  const chainConfig = getChain(chain);
+  const deadline = Math.floor(Date.now() / 1e3) + deadlineHours * 3600;
+  const value = BigInt(Math.floor(amount * 1e6)).toString();
+  const eip712Domain = {
+    name: "USD Coin",
+    version: "2",
+    chainId: chainConfig.chainId,
+    verifyingContract: chainConfig.usdc
+  };
+  const typedData = {
+    types: {
+      EIP712Domain: [
+        { name: "name", type: "string" },
+        { name: "version", type: "string" },
+        { name: "chainId", type: "uint256" },
+        { name: "verifyingContract", type: "address" }
+      ],
+      Permit: [
+        { name: "owner", type: "address" },
+        { name: "spender", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" }
+      ]
+    },
+    primaryType: "Permit",
+    domain: eip712Domain,
+    message: {
+      owner: ownerAddress,
+      spender: agentAddress,
+      value,
+      nonce: "<GET_FROM_USDC_CONTRACT>",
+      // Owner needs to query this
+      deadline
+    }
+  };
+  const instructions = `
+\u{1F510} **Grant USDC Spending Allowance to Your Agent**
+
+Your Agent (${agentAddress}) is requesting permission to spend up to ${amount} USDC from your wallet.
+
+**What this does:**
+- Allows your Agent to pay for services on your behalf
+- Your USDC stays in YOUR wallet until spent
+- Agent can only spend up to the authorized amount
+- Expires in ${deadlineHours} hours
+- You can revoke anytime by moving your USDC
+
+**How to sign (MetaMask / any web3 wallet):**
+
+1. Go to https://etherscan.io/address/${chainConfig.usdc}#readContract
+2. Query \`nonces(${ownerAddress})\` to get your current nonce
+3. Use eth_signTypedData_v4 with the data below (replace nonce)
+4. Send the signature {v, r, s, deadline, nonce} to your Agent
+
+**Chain:** ${chainConfig.name}
+**USDC Contract:** ${chainConfig.usdc}
+
+**EIP-712 Typed Data:**
+\`\`\`json
+${JSON.stringify(typedData, null, 2)}
+\`\`\`
+
+\u26A0\uFE0F Never share your private key. This signature only authorizes spending, not wallet access.
+`;
+  return { instructions, typedData, eip712Domain };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AllowanceWallet,
+  PermitSigner,
   PermitWallet,
   SecureWallet,
   Wallet,
   createWallet,
   formatPermitRequest,
+  generatePermitInstructions,
   getWalletAddress,
   loadWallet,
+  signPermit,
   walletExists
 });
 //# sourceMappingURL=index.js.map