moltspay 0.2.3 → 0.2.4

package/dist/index.mjs

@@ -1211,8 +1211,284 @@ var PermitSigner = class {
   }
 };
 
-// src/permit/Permit.ts
+// src/wallet/AllowanceWallet.ts
 import { ethers as ethers6 } from "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 ethers6.JsonRpcProvider(rpcUrl);
+    this.wallet = new ethers6.Wallet(config.privateKey, this.provider);
+    this.address = this.wallet.address;
+    this.usdcContract = new ethers6.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 = ethers6.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(ethers6.formatEther(agentGasBalance)) >= 1e-4;
+    return {
+      owner: ownerAddress,
+      agent: this.address,
+      allowance: allowanceNum.toFixed(2),
+      ownerBalance: (Number(ownerBalance) / 1e6).toFixed(2),
+      agentGasBalance: ethers6.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 = ethers6.getAddress(to);
+      const amountWei = BigInt(Math.floor(amount * 1e6));
+      let ownerPermit = permit;
+      let ownerAddress;
+      if (ownerPermit) {
+        ownerAddress = ethers6.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 = ethers6.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 ethers6.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 };
+}
+
+// src/permit/Permit.ts
+import { ethers as ethers7 } from "ethers";
 var PermitPayment = class {
   chain;
   chainConfig;
@@ -1225,13 +1501,13 @@ var PermitPayment = class {
     this.chainConfig = getChain(this.chain);
     this.spenderAddress = config.spenderAddress || process.env.PAYMENT_AGENT_WALLET || "";
     const rpcUrl = config.rpcUrl || this.chainConfig.rpc;
-    this.provider = new ethers6.JsonRpcProvider(rpcUrl);
+    this.provider = new ethers7.JsonRpcProvider(rpcUrl);
     const privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
     if (privateKey) {
-      this.wallet = new ethers6.Wallet(privateKey, this.provider);
+      this.wallet = new ethers7.Wallet(privateKey, this.provider);
       this.spenderAddress = this.wallet.address;
     }
-    this.usdcContract = new ethers6.Contract(
+    this.usdcContract = new ethers7.Contract(
       this.chainConfig.usdc,
       ERC20_ABI,
       this.wallet || this.provider
@@ -1514,8 +1790,8 @@ var OrderManager = class {
 };
 
 // src/verify/index.ts
-import { ethers as ethers7 } from "ethers";
-var TRANSFER_EVENT_TOPIC = ethers7.id("Transfer(address,address,uint256)");
+import { ethers as ethers8 } from "ethers";
+var TRANSFER_EVENT_TOPIC = ethers8.id("Transfer(address,address,uint256)");
 async function verifyPayment(params) {
   const { txHash, expectedAmount, expectedTo } = params;
   let chain;
@@ -1532,7 +1808,7 @@ async function verifyPayment(params) {
     return { verified: false, error: `Unsupported chain: ${params.chain}` };
   }
   try {
-    const provider = new ethers7.JsonRpcProvider(chain.rpc);
+    const provider = new ethers8.JsonRpcProvider(chain.rpc);
     const receipt = await provider.getTransactionReceipt(txHash);
     if (!receipt) {
       return { verified: false, error: "Transaction not found or not confirmed" };
@@ -1592,7 +1868,7 @@ async function getTransactionStatus(txHash, chain = "base") {
     return { status: "not_found" };
   }
   try {
-    const provider = new ethers7.JsonRpcProvider(chainConfig.rpc);
+    const provider = new ethers8.JsonRpcProvider(chainConfig.rpc);
     const receipt = await provider.getTransactionReceipt(txHash);
     if (!receipt) {
       const tx = await provider.getTransaction(txHash);
@@ -1629,7 +1905,7 @@ async function waitForTransaction(txHash, chain = "base", confirmations = 1, tim
   } catch (e) {
     return { verified: false, confirmed: false, error: `Unsupported chain: ${chain}` };
   }
-  const provider = new ethers7.JsonRpcProvider(chainConfig.rpc);
+  const provider = new ethers8.JsonRpcProvider(chainConfig.rpc);
   try {
     const receipt = await provider.waitForTransaction(txHash, confirmations, timeoutMs);
     if (!receipt) {
@@ -2316,6 +2592,7 @@ function parseStatusMarker(message) {
   return { type: "unknown", data: { raw: content } };
 }
 export {
+  AllowanceWallet,
   AuditLog,
   BuyerTemplates,
   CHAINS,
@@ -2338,6 +2615,7 @@ export {
   formatReceiptText,
   generatePaymentGuide,
   generatePaymentReminder,
+  generatePermitInstructions,
   generateReceipt,
   generateReceiptFromInvoice,
   generateWalletGuide,