moltspay 0.1.3 → 0.2.1

package/dist/wallet/index.d.mts

@@ -102,4 +102,191 @@ declare class SecureWallet {
     private updateDailyTotal;
 }
 
-export { SecureWallet, Wallet, type WalletConfig };
+/**
+ * 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;
+
+export { type CreateWalletOptions, type CreateWalletResult, type PermitData, PermitWallet, type PermitWalletConfig, SecureWallet, type TransferWithPermitParams, type TransferWithPermitResult, Wallet, type WalletConfig, type WalletData, createWallet, formatPermitRequest, getWalletAddress, loadWallet, walletExists };

package/dist/wallet/index.d.ts

@@ -102,4 +102,191 @@ declare class SecureWallet {
     private updateDailyTotal;
 }
 
-export { SecureWallet, Wallet, type WalletConfig };
+/**
+ * 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;
+
+export { type CreateWalletOptions, type CreateWalletResult, type PermitData, PermitWallet, type PermitWalletConfig, SecureWallet, type TransferWithPermitParams, type TransferWithPermitResult, Wallet, type WalletConfig, type WalletData, createWallet, formatPermitRequest, getWalletAddress, loadWallet, walletExists };