moltspay 0.2.7 → 0.2.9

package/README.md

@@ -224,25 +224,24 @@ Standard templates for natural A2A dialogue:
 import { SellerTemplates, BuyerTemplates, parseStatusMarker } from 'moltspay';
 
 // Seller templates
-SellerTemplates.askPaymentCapability()     // "你是否具备链上支付 USDC 的能力？"
-SellerTemplates.guideInstall()             // "请安装 moltspay..."
-SellerTemplates.guideFunding()             // "A) 直接转账 B) Permit授权"
-SellerTemplates.guidePermit(agentAddr, 10) // "请向 Boss 发送..."
+SellerTemplates.askPaymentCapability()       // "Do you have USDC payment capability?"
+SellerTemplates.guideInstall()               // "Install moltspay and init wallet..."
+SellerTemplates.guideFunding(agentAddr, 10)  // "Ask Owner to send USDC to your wallet"
 SellerTemplates.quote({ service, price, recipientAddress })
 SellerTemplates.verificationPassed(amount)
 SellerTemplates.deliver({ downloadUrl, fileHash })
 SellerTemplates.receipt(receipt)
 
 // Buyer templates
-BuyerTemplates.requestService('视频生成')
-BuyerTemplates.noCapability()              // "我没有钱包"
-BuyerTemplates.walletCreated(address)      // "[状态：已具备钱包地址]"
-BuyerTemplates.choosePermit()              // "我选择 B"
-BuyerTemplates.permitReceived(10)          // "[状态：已具备支付额度 USDC=10]"
-BuyerTemplates.paymentSent(txHash, amount) // "[状态：已发起支付 tx=...]"
+BuyerTemplates.requestService('video generation')
+BuyerTemplates.noCapability()                // "I don't have a wallet"
+BuyerTemplates.walletCreated(address)        // "[status:wallet_ready]"
+BuyerTemplates.fundingReceived(10)           // "[status:funded USDC=10]"
+BuyerTemplates.requestFunding(addr, 10)      // "Owner, please send USDC to my wallet"
+BuyerTemplates.paymentSent(txHash, amount)   // "[status:payment_sent tx=...]"
 
 // Parse status markers from messages
-const status = parseStatusMarker('[状态：已发起支付 tx=0xabc amount=3.99 USDC]');
+const status = parseStatusMarker('[status:payment_sent tx=0xabc amount=3.99 USDC]');
 // { type: 'payment_sent', data: { txHash: '0xabc', amount: '3.99' } }
 ```
 

package/dist/cli.js

@@ -348,6 +348,94 @@ var init_AgentWallet = __esm({
           };
         }
       }
+      /**
+       * Get USDC balance
+       */
+      async getBalance() {
+        const usdcContract = new import_ethers2.ethers.Contract(
+          this.chainConfig.usdc,
+          PERMIT_ABI,
+          this.provider
+        );
+        const [usdcBalance, ethBalance] = await Promise.all([
+          usdcContract.balanceOf(this.address),
+          this.provider.getBalance(this.address)
+        ]);
+        return {
+          usdc: (Number(usdcBalance) / 1e6).toFixed(2),
+          eth: import_ethers2.ethers.formatEther(ethBalance)
+        };
+      }
+      /**
+       * Transfer USDC to a recipient (direct payment)
+       * 
+       * This is the simplest payment method - Agent pays directly from its wallet.
+       * Requires Agent wallet to have USDC (funded by Owner).
+       * 
+       * @example
+       * ```typescript
+       * const wallet = new AgentWallet({ chain: 'base' });
+       * 
+       * // Check balance
+       * const balance = await wallet.getBalance();
+       * console.log('USDC:', balance.usdc);
+       * 
+       * // Pay for service
+       * const result = await wallet.transfer({
+       *   to: '0xServiceProvider...',
+       *   amount: 0.99
+       * });
+       * console.log('Tx:', result.txHash);
+       * ```
+       */
+      async transfer(params) {
+        const { to, amount } = params;
+        try {
+          const toAddress = import_ethers2.ethers.getAddress(to);
+          const amountWei = BigInt(Math.floor(amount * 1e6));
+          const usdcContract = new import_ethers2.ethers.Contract(
+            this.chainConfig.usdc,
+            PERMIT_ABI,
+            this.wallet
+          );
+          const balance = await usdcContract.balanceOf(this.address);
+          if (BigInt(balance) < amountWei) {
+            return {
+              success: false,
+              error: `Insufficient USDC: have ${(Number(balance) / 1e6).toFixed(2)}, need ${amount}`
+            };
+          }
+          if (!await this.hasGas()) {
+            return {
+              success: false,
+              error: "Insufficient ETH for gas. Need at least 0.0005 ETH."
+            };
+          }
+          const tx = await usdcContract.transfer(toAddress, amountWei);
+          const receipt = await tx.wait();
+          if (receipt.status === 1) {
+            return {
+              success: true,
+              txHash: tx.hash,
+              from: this.address,
+              to: toAddress,
+              amount,
+              explorerUrl: `${this.chainConfig.explorerTx}${tx.hash}`
+            };
+          } else {
+            return {
+              success: false,
+              txHash: tx.hash,
+              error: "Transaction reverted"
+            };
+          }
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      }
       /**
        * Get gas balance (ETH needed for transactions)
        */