moltspay 0.5.4 → 0.7.1

package/dist/wallet/index.d.mts

@@ -1,4 +1,5 @@
-import { C as ChainName, a as ChainConfig, W as WalletBalance, j as TransferResult, S as SecureWalletConfig, T as TransferParams, e as PendingTransfer, i as SecurityLimits } from '../index-CyFg9s2m.mjs';
+import { C as ChainName, a as ChainConfig, W as WalletBalance, T as TransferResult } from '../index-Dg8n6wdW.mjs';
+export { C as CreateWalletOptions, a as CreateWalletResult, W as WalletData, c as createWallet, g as getWalletAddress, l as loadWallet, w as walletExists } from '../createWallet-D53qu7ie.mjs';
 
 /**
  * Wallet - Basic Custody Wallet
@@ -39,453 +40,4 @@ declare class Wallet {
     getUsdcBalance(): Promise<string>;
 }
 
-declare class SecureWallet {
-    private wallet;
-    private limits;
-    private whitelist;
-    private auditLog;
-    private dailyTotal;
-    private dailyDate;
-    private pendingTransfers;
-    constructor(config?: SecureWalletConfig);
-    /**
-     * Get wallet address
-     */
-    get address(): string;
-    /**
-     * Get balance
-     */
-    getBalance(): Promise<WalletBalance>;
-    /**
-     * Secure transfer (with limit and whitelist checks)
-     *
-     * Supports two calling methods:
-     * - transfer({ to, amount, reason?, requester? })
-     * - transfer(to, amount)
-     */
-    transfer(paramsOrTo: TransferParams | string, amountArg?: number | string): Promise<TransferResult>;
-    /**
-     * Approve pending transfer
-     */
-    approve(requestId: string, approver: string): Promise<TransferResult>;
-    /**
-     * Reject pending transfer
-     */
-    reject(requestId: string, rejecter: string, reason?: string): Promise<void>;
-    /**
-     * Add to whitelist
-     */
-    addToWhitelist(address: string, addedBy: string): Promise<void>;
-    /**
-     * Remove from whitelist
-     */
-    removeFromWhitelist(address: string, removedBy: string): Promise<void>;
-    /**
-     * Check if address is whitelisted
-     */
-    isWhitelisted(address: string): boolean;
-    /**
-     * Get pending transfers list
-     */
-    getPendingTransfers(): PendingTransfer[];
-    /**
-     * Get current limit config
-     */
-    getLimits(): SecurityLimits;
-    /**
-     * Get daily used amount
-     */
-    getDailyUsed(): number;
-    /**
-     * Update daily limit counter
-     */
-    private updateDailyTotal;
-}
-
-/**
- * createWallet - Create a new wallet for Agent
- *
- * Features:
- * - Generate new Ethereum wallet
- * - Securely store private key (encrypted or plaintext, depending on config)
- * - Return wallet address (never return private key)
- */
-interface CreateWalletOptions {
-    /** Storage path, default ~/.moltspay/wallet.json */
-    storagePath?: string;
-    /** Encryption password (optional, plaintext if not provided) */
-    password?: string;
-    /** Wallet label/name */
-    label?: string;
-    /** Overwrite if wallet exists */
-    overwrite?: boolean;
-}
-interface WalletData {
-    address: string;
-    label?: string;
-    createdAt: string;
-    encrypted: boolean;
-    /** Encrypted or plaintext private key */
-    privateKey: string;
-    /** Encryption IV */
-    iv?: string;
-    /** Encryption salt */
-    salt?: string;
-}
-interface CreateWalletResult {
-    success: boolean;
-    address?: string;
-    storagePath?: string;
-    error?: string;
-    /** Whether newly created (false means loaded existing) */
-    isNew?: boolean;
-}
-/**
- * Create new wallet
- *
- * @example
- * ```typescript
- * // Create unencrypted wallet
- * const result = await createWallet();
- * console.log('Wallet address:', result.address);
- *
- * // Create encrypted wallet
- * const result = await createWallet({ password: 'mySecurePassword' });
- *
- * // Specify storage path
- * const result = await createWallet({ storagePath: './my-wallet.json' });
- * ```
- */
-declare function createWallet(options?: CreateWalletOptions): CreateWalletResult;
-/**
- * Load existing wallet
- */
-declare function loadWallet(options?: {
-    storagePath?: string;
-    password?: string;
-}): {
-    success: boolean;
-    address?: string;
-    privateKey?: string;
-    error?: string;
-};
-/**
- * Get wallet address (no password required)
- */
-declare function getWalletAddress(storagePath?: string): string | null;
-/**
- * Check if wallet exists
- */
-declare function walletExists(storagePath?: string): boolean;
-
-/**
- * PermitWallet - Pay using Boss's Permit authorization
- *
- * Scenario:
- * - Agent doesn't have USDC, but Boss gave a Permit authorization
- * - Agent uses Permit signature + own wallet to execute transferFrom
- * - Agent only needs small amount of ETH for gas, USDC is deducted from Boss's wallet
- */
-
-interface PermitData {
-    /** Boss's wallet address (USDC holder) */
-    owner: string;
-    /** Agent's wallet address (authorized spender) */
-    spender: string;
-    /** Authorized amount (USDC, raw 6 decimal value) */
-    value: string;
-    /** Expiration timestamp */
-    deadline: number;
-    /** Signature v */
-    v: number;
-    /** Signature r */
-    r: string;
-    /** Signature s */
-    s: string;
-}
-interface PermitWalletConfig {
-    chain?: ChainName;
-    /** Agent's private key (for executing transactions) */
-    privateKey?: string;
-    /** Load private key from file */
-    walletPath?: string;
-    /** Decryption password */
-    walletPassword?: string;
-    rpcUrl?: string;
-}
-interface TransferWithPermitParams {
-    /** Recipient address */
-    to: string;
-    /** Amount (USDC) */
-    amount: number;
-    /** Boss-signed Permit data */
-    permit: PermitData;
-}
-interface TransferWithPermitResult extends TransferResult {
-    /** Permit transaction hash */
-    permitTxHash?: string;
-    /** Transfer transaction hash */
-    transferTxHash?: string;
-}
-declare class PermitWallet {
-    readonly chain: ChainName;
-    readonly chainConfig: ChainConfig;
-    readonly address: string;
-    private wallet;
-    private provider;
-    private usdcContract;
-    constructor(config?: PermitWalletConfig);
-    /**
-     * Check if Permit is valid (current allowance)
-     */
-    checkPermitAllowance(owner: string): Promise<string>;
-    /**
-     * Pay using Permit authorization
-     *
-     * Flow:
-     * 1. Call permit() to record Boss's authorization in the contract
-     * 2. Call transferFrom() to transfer from Boss's wallet to recipient
-     *
-     * @example
-     * ```typescript
-     * const wallet = new PermitWallet({ chain: 'base' });
-     *
-     * // Boss-signed permit data
-     * const permit = {
-     *   owner: '0xBOSS...',
-     *   spender: wallet.address,
-     *   value: '10000000', // 10 USDC
-     *   deadline: 1234567890,
-     *   v: 27,
-     *   r: '0x...',
-     *   s: '0x...'
-     * };
-     *
-     * const result = await wallet.transferWithPermit({
-     *   to: '0xSELLER...',
-     *   amount: 3.99,
-     *   permit
-     * });
-     * ```
-     */
-    transferWithPermit(params: TransferWithPermitParams): Promise<TransferWithPermitResult>;
-    /**
-     * Get ETH balance (for gas)
-     */
-    getGasBalance(): Promise<string>;
-    /**
-     * Check if there's enough gas
-     */
-    hasEnoughGas(minEth?: number): Promise<boolean>;
-}
-/**
- * Format Permit request message (to send to Boss)
- */
-declare function formatPermitRequest(params: {
-    agentAddress: string;
-    amount: number;
-    deadlineHours?: number;
-    chain?: ChainName;
-    reason?: string;
-}): string;
-
-/**
- * signPermit - Agent signs EIP-2612 Permit to authorize another address to spend USDC
- *
- * Used for Agent-to-Agent payments where the client agent authorizes
- * the service provider to pull payment.
- */
-
-interface SignPermitParams {
-    /** Spender address (service provider's wallet) */
-    spender: string;
-    /** Amount in USDC (e.g., 0.99) */
-    amount: number;
-    /** Deadline timestamp (Unix seconds) or minutes from now if < 1000000 */
-    deadline?: number;
-}
-interface SignPermitResult {
-    /** Permit owner (signer's address) */
-    owner: string;
-    /** Authorized spender */
-    spender: string;
-    /** Authorized amount (raw, 6 decimals) */
-    value: string;
-    /** Expiration timestamp */
-    deadline: number;
-    /** Nonce used */
-    nonce: number;
-    /** Signature v */
-    v: number;
-    /** Signature r */
-    r: string;
-    /** Signature s */
-    s: string;
-}
-interface SignPermitConfig {
-    chain?: ChainName;
-    privateKey?: string;
-    rpcUrl?: string;
-}
-/**
- * Sign an EIP-2612 Permit
- *
- * @example
- * ```typescript
- * import { signPermit } from 'moltspay';
- *
- * const permit = await signPermit(
- *   { chain: 'base', privateKey: process.env.WALLET_KEY },
- *   {
- *     spender: '0xZen7Wallet...',
- *     amount: 0.99,
- *     deadline: 30  // 30 minutes from now
- *   }
- * );
- *
- * // Send permit to service provider
- * await fetch('https://service/api/pay', {
- *   body: JSON.stringify({ permit })
- * });
- * ```
- */
-declare function signPermit(config: SignPermitConfig, params: SignPermitParams): Promise<SignPermitResult>;
-/**
- * Convenient class method version
- */
-declare class PermitSigner {
-    private config;
-    constructor(config: SignPermitConfig);
-    sign(params: SignPermitParams): Promise<SignPermitResult>;
-}
-
-/**
- * AllowanceWallet - Agent spends from Owner's wallet using Permit allowance
- *
- * This is the recommended pattern for AI Agents:
- * 1. Owner signs EIP-2612 Permit in MetaMask (off-chain, no gas)
- * 2. Owner sends Permit data to Agent
- * 3. Agent stores Permit and spends within the allowance
- * 4. Agent only needs minimal ETH for gas, USDC stays in Owner's wallet
- *
- * Benefits:
- * - Agent never holds significant funds
- * - Owner maintains custody of USDC
- * - Owner can revoke by spending/transferring USDC
- * - Clear audit trail of Agent spending
- */
-
-interface OwnerPermit {
-    /** Owner's wallet address (USDC holder, e.g., MetaMask) */
-    owner: string;
-    /** Authorized amount (raw, 6 decimals for USDC) */
-    value: string;
-    /** Expiration timestamp (Unix seconds) */
-    deadline: number;
-    /** Nonce used when signing */
-    nonce: number;
-    /** Signature components */
-    v: number;
-    r: string;
-    s: string;
-}
-interface AllowanceWalletConfig {
-    chain?: ChainName;
-    /** Agent's private key (only for gas, not for USDC) */
-    privateKey: string;
-    rpcUrl?: string;
-}
-interface SpendParams {
-    /** Recipient address (e.g., service provider) */
-    to: string;
-    /** Amount in USDC */
-    amount: number;
-    /** Owner's Permit (if not yet submitted on-chain) */
-    permit?: OwnerPermit;
-}
-interface SpendResult {
-    success: boolean;
-    txHash?: string;
-    error?: string;
-    from: string;
-    to: string;
-    amount: number;
-    remainingAllowance?: string;
-    explorerUrl?: string;
-}
-interface AllowanceStatus {
-    owner: string;
-    agent: string;
-    allowance: string;
-    ownerBalance: string;
-    agentGasBalance: string;
-    canSpend: boolean;
-    chain: string;
-}
-declare class AllowanceWallet {
-    readonly chain: ChainName;
-    readonly chainConfig: ChainConfig;
-    readonly address: string;
-    private wallet;
-    private provider;
-    private usdcContract;
-    /** Stored permits from owners */
-    private permits;
-    constructor(config: AllowanceWalletConfig);
-    /**
-     * Store a Permit received from Owner
-     * Call this when Owner sends you a signed Permit
-     */
-    storePermit(permit: OwnerPermit): void;
-    /**
-     * Get stored Permit for an owner
-     */
-    getPermit(owner: string): OwnerPermit | undefined;
-    /**
-     * Check allowance status with an owner
-     */
-    checkAllowance(owner: string): Promise<AllowanceStatus>;
-    /**
-     * 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,
-     * });
-     * ```
-     */
-    spend(params: SpendParams): Promise<SpendResult>;
-    /**
-     * Get Agent's gas balance (ETH)
-     */
-    getGasBalance(): Promise<string>;
-}
-/**
- * Generate instructions for Owner to sign a Permit in MetaMask
- *
- * Owner can use this with eth_signTypedData_v4 in any web3 wallet
- */
-declare function generatePermitInstructions(params: {
-    ownerAddress: string;
-    agentAddress: string;
-    amount: number;
-    deadlineHours?: number;
-    chain?: ChainName;
-}): {
-    instructions: string;
-    typedData: object;
-    eip712Domain: object;
-};
-
-export { type AllowanceStatus, AllowanceWallet, type AllowanceWalletConfig, type CreateWalletOptions, type CreateWalletResult, type OwnerPermit, type PermitData, PermitSigner, PermitWallet, type PermitWalletConfig, SecureWallet, type SignPermitConfig, type SignPermitParams, type SignPermitResult, type SpendParams, type SpendResult, type TransferWithPermitParams, type TransferWithPermitResult, Wallet, type WalletConfig, type WalletData, createWallet, formatPermitRequest, generatePermitInstructions, getWalletAddress, loadWallet, signPermit, walletExists };
+export { Wallet, type WalletConfig };