moltspay 0.2.4 → 0.2.6

package/dist/index.d.mts

@@ -50,6 +50,116 @@ declare class PaymentAgent {
     formatInvoiceMessage(invoice: Invoice, includeJson?: boolean): string;
 }
 
+/**
+ * AgentWallet - Zero-config wallet for AI Agents
+ *
+ * Design principles:
+ * - Auto-initialize on first use (no manual setup)
+ * - Generate address locally (no gas needed)
+ * - Owner authorizes via Permit (can be CLI or UI)
+ * - Agent only needs gas when actually spending
+ */
+
+interface OwnerPermit {
+    owner: string;
+    value: string;
+    deadline: number;
+    nonce: number;
+    v: number;
+    r: string;
+    s: string;
+}
+interface AgentWalletConfig {
+    /** Storage directory for wallet data (default: ~/.moltspay) */
+    storageDir?: string;
+    /** Chain to use */
+    chain?: ChainName;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+}
+interface SpendResult {
+    success: boolean;
+    txHash?: string;
+    error?: string;
+    from: string;
+    to: string;
+    amount: number;
+    remainingAllowance?: string;
+    explorerUrl?: string;
+}
+declare class AgentWallet {
+    readonly chain: ChainName;
+    readonly chainConfig: ChainConfig;
+    readonly storageDir: string;
+    private _address;
+    private _privateKey;
+    private _wallet;
+    private _provider;
+    private _permits;
+    constructor(config?: AgentWalletConfig);
+    private getDefaultStorageDir;
+    private getWalletPath;
+    private getPermitsPath;
+    /**
+     * Auto-initialize: create wallet if not exists
+     * This is called automatically in constructor
+     */
+    private ensureInitialized;
+    /** Agent's address (auto-generated on first use) */
+    get address(): string;
+    private get wallet();
+    private get provider();
+    /**
+     * Store a Permit from Owner
+     */
+    storePermit(permit: OwnerPermit): void;
+    /**
+     * Get stored permit for an owner
+     */
+    getPermit(owner: string): OwnerPermit | undefined;
+    /**
+     * Check allowance from an owner
+     */
+    checkAllowance(owner: string): Promise<{
+        allowance: string;
+        ownerBalance: string;
+        canSpend: boolean;
+    }>;
+    /**
+     * Spend USDC from Owner's wallet
+     *
+     * @param to - Recipient (service provider)
+     * @param amount - Amount in USDC
+     * @param permit - Optional, uses stored permit if not provided
+     */
+    spend(to: string, amount: number, permit?: OwnerPermit): Promise<SpendResult>;
+    /**
+     * Get gas balance (ETH needed for transactions)
+     */
+    getGasBalance(): Promise<string>;
+    /**
+     * Check if agent has enough gas
+     */
+    hasGas(minEth?: number): Promise<boolean>;
+    /**
+     * Generate authorization request for Owner
+     * Owner can sign this with CLI (ethers) or MetaMask
+     */
+    generateAuthRequest(params: {
+        ownerAddress: string;
+        amount: number;
+        expiresInHours?: number;
+    }): Promise<{
+        message: string;
+        typedData: object;
+        cliCommand: string;
+    }>;
+}
+/**
+ * Quick helper to get agent address (auto-initializes if needed)
+ */
+declare function getAgentAddress(config?: AgentWalletConfig): string;
+
 /**
  * AuditLog - Immutable Audit Log
  *
@@ -429,4 +539,4 @@ declare function parseStatusMarker(message: string): {
     data: Record<string, string>;
 } | null;
 
-export { AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, parseStatusMarker };
+export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, getAgentAddress, parseStatusMarker };

package/dist/index.d.ts

@@ -50,6 +50,116 @@ declare class PaymentAgent {
     formatInvoiceMessage(invoice: Invoice, includeJson?: boolean): string;
 }
 
+/**
+ * AgentWallet - Zero-config wallet for AI Agents
+ *
+ * Design principles:
+ * - Auto-initialize on first use (no manual setup)
+ * - Generate address locally (no gas needed)
+ * - Owner authorizes via Permit (can be CLI or UI)
+ * - Agent only needs gas when actually spending
+ */
+
+interface OwnerPermit {
+    owner: string;
+    value: string;
+    deadline: number;
+    nonce: number;
+    v: number;
+    r: string;
+    s: string;
+}
+interface AgentWalletConfig {
+    /** Storage directory for wallet data (default: ~/.moltspay) */
+    storageDir?: string;
+    /** Chain to use */
+    chain?: ChainName;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+}
+interface SpendResult {
+    success: boolean;
+    txHash?: string;
+    error?: string;
+    from: string;
+    to: string;
+    amount: number;
+    remainingAllowance?: string;
+    explorerUrl?: string;
+}
+declare class AgentWallet {
+    readonly chain: ChainName;
+    readonly chainConfig: ChainConfig;
+    readonly storageDir: string;
+    private _address;
+    private _privateKey;
+    private _wallet;
+    private _provider;
+    private _permits;
+    constructor(config?: AgentWalletConfig);
+    private getDefaultStorageDir;
+    private getWalletPath;
+    private getPermitsPath;
+    /**
+     * Auto-initialize: create wallet if not exists
+     * This is called automatically in constructor
+     */
+    private ensureInitialized;
+    /** Agent's address (auto-generated on first use) */
+    get address(): string;
+    private get wallet();
+    private get provider();
+    /**
+     * Store a Permit from Owner
+     */
+    storePermit(permit: OwnerPermit): void;
+    /**
+     * Get stored permit for an owner
+     */
+    getPermit(owner: string): OwnerPermit | undefined;
+    /**
+     * Check allowance from an owner
+     */
+    checkAllowance(owner: string): Promise<{
+        allowance: string;
+        ownerBalance: string;
+        canSpend: boolean;
+    }>;
+    /**
+     * Spend USDC from Owner's wallet
+     *
+     * @param to - Recipient (service provider)
+     * @param amount - Amount in USDC
+     * @param permit - Optional, uses stored permit if not provided
+     */
+    spend(to: string, amount: number, permit?: OwnerPermit): Promise<SpendResult>;
+    /**
+     * Get gas balance (ETH needed for transactions)
+     */
+    getGasBalance(): Promise<string>;
+    /**
+     * Check if agent has enough gas
+     */
+    hasGas(minEth?: number): Promise<boolean>;
+    /**
+     * Generate authorization request for Owner
+     * Owner can sign this with CLI (ethers) or MetaMask
+     */
+    generateAuthRequest(params: {
+        ownerAddress: string;
+        amount: number;
+        expiresInHours?: number;
+    }): Promise<{
+        message: string;
+        typedData: object;
+        cliCommand: string;
+    }>;
+}
+/**
+ * Quick helper to get agent address (auto-initializes if needed)
+ */
+declare function getAgentAddress(config?: AgentWalletConfig): string;
+
 /**
  * AuditLog - Immutable Audit Log
  *
@@ -429,4 +539,4 @@ declare function parseStatusMarker(message: string): {
     data: Record<string, string>;
 } | null;
 
-export { AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, parseStatusMarker };
+export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, getAgentAddress, parseStatusMarker };