moltspay 1.2.1 → 1.4.0

package/dist/facilitators/index.d.mts

@@ -1,67 +1,248 @@
-import { B as BaseFacilitator, a as FacilitatorConfig, H as HealthCheckResult, X as X402PaymentPayload, f as X402PaymentRequirements, V as VerifyResult, e as SettleResult, b as FacilitatorFee } from '../registry-OsEO2dOu.mjs';
-export { F as Facilitator, c as FacilitatorRegistry, d as FacilitatorSelection, S as SelectionStrategy, g as createRegistry, h as getDefaultRegistry } from '../registry-OsEO2dOu.mjs';
+import { B as BaseFacilitator, H as HealthCheckResult, X as X402PaymentPayload, f as X402PaymentRequirements, V as VerifyResult, e as SettleResult } from '../registry-OsEO2dOu.mjs';
+export { F as Facilitator, a as FacilitatorConfig, b as FacilitatorFee, c as FacilitatorRegistry, d as FacilitatorSelection, S as SelectionStrategy, g as createRegistry, h as getDefaultRegistry } from '../registry-OsEO2dOu.mjs';
+export { C as CDPFacilitator, a as CDPFacilitatorConfig } from '../cdp-p_eHuQpb.mjs';
+import { Keypair, PublicKey, Transaction } from '@solana/web3.js';
 
 /**
- * CDP Facilitator
+ * Tempo Testnet Facilitator
  *
- * Coinbase Developer Platform x402 facilitator implementation.
- * Auto-detects mainnet vs testnet from chain ID in request.
+ * Verifies payments on Tempo Moderato testnet by checking transaction receipts.
+ * Unlike CDP facilitator, this directly verifies on-chain without a third-party service.
+ */
+
+/**
+ * Tempo Testnet Facilitator
  *
- * Supported networks:
- * - Base mainnet (eip155:8453)
- * - Polygon mainnet (eip155:137)
- * - Base Sepolia testnet (eip155:84532)
+ * Verifies TIP-20 token transfers on Tempo Moderato (chainId 42431).
+ */
+declare class TempoFacilitator extends BaseFacilitator {
+    readonly name = "tempo";
+    readonly displayName = "Tempo Testnet";
+    readonly supportedNetworks: string[];
+    private rpcUrl;
+    constructor();
+    healthCheck(): Promise<HealthCheckResult>;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    private getTransactionReceipt;
+}
+
+/**
+ * BNB Chain Facilitator
+ *
+ * Handles pay-for-success payments on BNB Smart Chain.
  *
- * @see https://docs.cdp.coinbase.com/x402/core-concepts/facilitator
+ * Flow:
+ * 1. Client pre-approves server wallet (one-time, via `moltspay init`)
+ * 2. Client signs EIP-712 intent (no gas, just signature)
+ * 3. Server verifies intent signature
+ * 4. Server executes service
+ * 5. Success → Server calls transferFrom (server pays gas)
+ * 6. Failure → No transfer, client keeps money
+ *
+ * Key difference from Tempo:
+ * - Tempo: Client pays first → service might fail → money lost
+ * - BNB: Service runs first → success = payment (pay-for-success)
  */
 
-interface CDPFacilitatorConfig extends FacilitatorConfig {
-    /** CDP API Key ID (required) */
-    apiKeyId?: string;
-    /** CDP API Key Secret (required) */
-    apiKeySecret?: string;
+/**
+ * BNB Payment Intent (signed by client)
+ */
+interface BNBPaymentIntent {
+    from: string;
+    to: string;
+    amount: string;
+    token: string;
+    service: string;
+    nonce: number;
+    deadline: number;
+    signature: string;
 }
 /**
- * CDP (Coinbase Developer Platform) Facilitator
+ * BNB Chain Facilitator
  *
- * Handles payment verification and settlement via Coinbase's x402 facilitator.
+ * Handles pay-for-success payments on BNB mainnet (chainId 56) and testnet (chainId 97).
+ * Server wallet executes transferFrom after successful service delivery.
  */
-declare class CDPFacilitator extends BaseFacilitator {
-    readonly name = "cdp";
-    readonly displayName = "Coinbase CDP";
+declare class BNBFacilitator extends BaseFacilitator {
+    readonly name = "bnb";
+    readonly displayName = "BNB Smart Chain";
     readonly supportedNetworks: string[];
-    private endpoint;
-    private apiKeyId?;
-    private apiKeySecret?;
-    constructor(config?: CDPFacilitatorConfig);
+    private serverPrivateKey;
+    private spenderAddress;
+    private chainConfigs;
+    constructor(serverPrivateKey?: string);
+    healthCheck(): Promise<HealthCheckResult>;
     /**
-     * Get auth headers for CDP API requests
+     * Verify a payment intent signature (before service execution)
+     *
+     * This verifies:
+     * 1. Signature is valid for the intent
+     * 2. Client has approved server wallet
+     * 3. Client has sufficient balance
+     * 4. Intent hasn't expired
      */
-    private getAuthHeaders;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
     /**
-     * Health check - verify facilitator is reachable
+     * Settle a payment by executing transferFrom
+     *
+     * This is called AFTER the service has been successfully delivered.
+     * Server pays gas, transfers tokens from client to provider.
      */
-    healthCheck(): Promise<HealthCheckResult>;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
     /**
-     * Verify payment signature with facilitator
+     * Check if client has approved the server wallet
      */
-    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    checkApproval(clientAddress: string, token: string, chainId: number): Promise<{
+        approved: boolean;
+        allowance: string;
+    }>;
     /**
-     * Settle payment on-chain via facilitator
+     * Verify a completed transaction (for checking past payments)
      */
-    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    verifyTransaction(txHash: string, expected: {
+        to: string;
+        amount: string;
+        token: string;
+    }, chainId: number): Promise<VerifyResult>;
     /**
-     * Get CDP fee information
+     * Get the server's spender address (public, for 402 responses)
+     * Returns cached value computed at construction time.
      */
-    getFee(): Promise<FacilitatorFee>;
+    getSpenderAddress(): string | null;
+    private getServerAddress;
+    private recoverIntentSigner;
+    private getAllowance;
+    private getBalance;
+    private executeTransferFrom;
+    private getTransactionReceipt;
+}
+/**
+ * Create EIP-712 typed data for signing a payment intent
+ *
+ * Used by clients to sign their payment intent.
+ */
+declare function createIntentTypedData(intent: Omit<BNBPaymentIntent, 'signature'>, chainId: number): {
+    domain: {
+        chainId: number;
+        name: string;
+        version: string;
+    };
+    types: {
+        PaymentIntent: {
+            name: string;
+            type: string;
+        }[];
+    };
+    primaryType: "PaymentIntent";
+    message: {
+        from: string;
+        to: string;
+        amount: string;
+        token: string;
+        service: string;
+        nonce: number;
+        deadline: number;
+    };
+};
+
+/**
+ * Solana Chain Configuration
+ *
+ * Solana is NOT an EVM chain - uses different:
+ * - Key format: ed25519 (EdDSA) vs secp256k1 (ECDSA)
+ * - Address format: Base58 vs 0x hex
+ * - Token standard: SPL vs ERC-20
+ */
+
+type SolanaChainName = 'solana' | 'solana_devnet';
+
+/**
+ * Solana Facilitator
+ *
+ * Pay-for-success payment settlement for Solana SPL token transfers.
+ * Unlike EVM chains, Solana doesn't have a third-party facilitator -
+ * we verify and settle directly on-chain.
+ *
+ * Flow:
+ * 1. Client signs a SPL token transfer authorization
+ * 2. Server receives the signed transaction
+ * 3. Server verifies the signature and amount
+ * 4. Server submits the transaction to settle payment
+ */
+
+/**
+ * Solana payment payload structure
+ */
+interface SolanaPaymentPayload {
+    /** Base58 encoded signed transaction */
+    signedTransaction: string;
+    /** Sender's public key (Base58) */
+    sender: string;
+    /** Chain: solana or solana_devnet */
+    chain: SolanaChainName;
+}
+/**
+ * Solana Facilitator configuration
+ */
+interface SolanaFacilitatorConfig {
+    /** Optional fee payer keypair for gasless transactions */
+    feePayerKeypair?: Keypair;
+}
+/**
+ * Solana Facilitator for pay-for-success payments
+ *
+ * Supports gasless mode: if feePayerKeypair is provided, server pays tx fees
+ */
+declare class SolanaFacilitator extends BaseFacilitator {
+    readonly name = "solana";
+    readonly displayName = "Solana Direct";
+    readonly supportedNetworks: string[];
+    private connections;
+    private feePayerKeypair?;
+    constructor(config?: SolanaFacilitatorConfig);
+    /**
+     * Get fee payer public key (for gasless transactions)
+     */
+    getFeePayerPubkey(): string | null;
+    private getConnection;
+    /**
+     * Convert our chain name to network identifier
+     */
+    static chainToNetwork(chain: SolanaChainName): string;
+    /**
+     * Convert network identifier to chain name
+     */
+    static networkToChain(network: string): SolanaChainName | null;
+    healthCheck(): Promise<HealthCheckResult>;
     /**
-     * Check if a chain ID is testnet
+     * Verify a Solana payment
+     *
+     * Checks:
+     * 1. Transaction is valid and properly signed
+     * 2. Transfer instruction matches expected amount and recipient
      */
-    static isTestnet(chainId: number): boolean;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
     /**
-     * Get configuration summary (for logging)
+     * Settle a Solana payment
+     *
+     * Submits the signed transaction to the network.
+     * In gasless mode, adds fee payer signature before submitting.
      */
-    getConfigSummary(): string;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    supportsNetwork(network: string): boolean;
 }
+/**
+ * Create a Solana payment transaction for signing
+ *
+ * This is called by the client to create the transaction to sign.
+ *
+ * @param senderPubkey - The sender's public key (token owner)
+ * @param recipientPubkey - The recipient's public key
+ * @param amount - Amount in token base units
+ * @param chain - Solana chain (solana or solana_devnet)
+ * @param feePayerPubkey - Optional fee payer public key for gasless transactions
+ */
+declare function createSolanaPaymentTransaction(senderPubkey: PublicKey, recipientPubkey: PublicKey, amount: bigint, chain: SolanaChainName, feePayerPubkey?: PublicKey): Promise<Transaction>;
 
-export { BaseFacilitator, CDPFacilitator, type CDPFacilitatorConfig, FacilitatorConfig, FacilitatorFee, HealthCheckResult, SettleResult, VerifyResult, X402PaymentPayload, X402PaymentRequirements };
+export { BNBFacilitator, type BNBPaymentIntent, BaseFacilitator, HealthCheckResult, SettleResult, SolanaFacilitator, type SolanaPaymentPayload, TempoFacilitator, VerifyResult, X402PaymentPayload, X402PaymentRequirements, createIntentTypedData, createSolanaPaymentTransaction };

package/dist/facilitators/index.d.ts

@@ -1,67 +1,248 @@
-import { B as BaseFacilitator, a as FacilitatorConfig, H as HealthCheckResult, X as X402PaymentPayload, f as X402PaymentRequirements, V as VerifyResult, e as SettleResult, b as FacilitatorFee } from '../registry-OsEO2dOu.js';
-export { F as Facilitator, c as FacilitatorRegistry, d as FacilitatorSelection, S as SelectionStrategy, g as createRegistry, h as getDefaultRegistry } from '../registry-OsEO2dOu.js';
+import { B as BaseFacilitator, H as HealthCheckResult, X as X402PaymentPayload, f as X402PaymentRequirements, V as VerifyResult, e as SettleResult } from '../registry-OsEO2dOu.js';
+export { F as Facilitator, a as FacilitatorConfig, b as FacilitatorFee, c as FacilitatorRegistry, d as FacilitatorSelection, S as SelectionStrategy, g as createRegistry, h as getDefaultRegistry } from '../registry-OsEO2dOu.js';
+export { C as CDPFacilitator, a as CDPFacilitatorConfig } from '../cdp-DeohBe1o.js';
+import { Keypair, PublicKey, Transaction } from '@solana/web3.js';
 
 /**
- * CDP Facilitator
+ * Tempo Testnet Facilitator
  *
- * Coinbase Developer Platform x402 facilitator implementation.
- * Auto-detects mainnet vs testnet from chain ID in request.
+ * Verifies payments on Tempo Moderato testnet by checking transaction receipts.
+ * Unlike CDP facilitator, this directly verifies on-chain without a third-party service.
+ */
+
+/**
+ * Tempo Testnet Facilitator
  *
- * Supported networks:
- * - Base mainnet (eip155:8453)
- * - Polygon mainnet (eip155:137)
- * - Base Sepolia testnet (eip155:84532)
+ * Verifies TIP-20 token transfers on Tempo Moderato (chainId 42431).
+ */
+declare class TempoFacilitator extends BaseFacilitator {
+    readonly name = "tempo";
+    readonly displayName = "Tempo Testnet";
+    readonly supportedNetworks: string[];
+    private rpcUrl;
+    constructor();
+    healthCheck(): Promise<HealthCheckResult>;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    private getTransactionReceipt;
+}
+
+/**
+ * BNB Chain Facilitator
+ *
+ * Handles pay-for-success payments on BNB Smart Chain.
  *
- * @see https://docs.cdp.coinbase.com/x402/core-concepts/facilitator
+ * Flow:
+ * 1. Client pre-approves server wallet (one-time, via `moltspay init`)
+ * 2. Client signs EIP-712 intent (no gas, just signature)
+ * 3. Server verifies intent signature
+ * 4. Server executes service
+ * 5. Success → Server calls transferFrom (server pays gas)
+ * 6. Failure → No transfer, client keeps money
+ *
+ * Key difference from Tempo:
+ * - Tempo: Client pays first → service might fail → money lost
+ * - BNB: Service runs first → success = payment (pay-for-success)
  */
 
-interface CDPFacilitatorConfig extends FacilitatorConfig {
-    /** CDP API Key ID (required) */
-    apiKeyId?: string;
-    /** CDP API Key Secret (required) */
-    apiKeySecret?: string;
+/**
+ * BNB Payment Intent (signed by client)
+ */
+interface BNBPaymentIntent {
+    from: string;
+    to: string;
+    amount: string;
+    token: string;
+    service: string;
+    nonce: number;
+    deadline: number;
+    signature: string;
 }
 /**
- * CDP (Coinbase Developer Platform) Facilitator
+ * BNB Chain Facilitator
  *
- * Handles payment verification and settlement via Coinbase's x402 facilitator.
+ * Handles pay-for-success payments on BNB mainnet (chainId 56) and testnet (chainId 97).
+ * Server wallet executes transferFrom after successful service delivery.
  */
-declare class CDPFacilitator extends BaseFacilitator {
-    readonly name = "cdp";
-    readonly displayName = "Coinbase CDP";
+declare class BNBFacilitator extends BaseFacilitator {
+    readonly name = "bnb";
+    readonly displayName = "BNB Smart Chain";
     readonly supportedNetworks: string[];
-    private endpoint;
-    private apiKeyId?;
-    private apiKeySecret?;
-    constructor(config?: CDPFacilitatorConfig);
+    private serverPrivateKey;
+    private spenderAddress;
+    private chainConfigs;
+    constructor(serverPrivateKey?: string);
+    healthCheck(): Promise<HealthCheckResult>;
     /**
-     * Get auth headers for CDP API requests
+     * Verify a payment intent signature (before service execution)
+     *
+     * This verifies:
+     * 1. Signature is valid for the intent
+     * 2. Client has approved server wallet
+     * 3. Client has sufficient balance
+     * 4. Intent hasn't expired
      */
-    private getAuthHeaders;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
     /**
-     * Health check - verify facilitator is reachable
+     * Settle a payment by executing transferFrom
+     *
+     * This is called AFTER the service has been successfully delivered.
+     * Server pays gas, transfers tokens from client to provider.
      */
-    healthCheck(): Promise<HealthCheckResult>;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
     /**
-     * Verify payment signature with facilitator
+     * Check if client has approved the server wallet
      */
-    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    checkApproval(clientAddress: string, token: string, chainId: number): Promise<{
+        approved: boolean;
+        allowance: string;
+    }>;
     /**
-     * Settle payment on-chain via facilitator
+     * Verify a completed transaction (for checking past payments)
      */
-    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    verifyTransaction(txHash: string, expected: {
+        to: string;
+        amount: string;
+        token: string;
+    }, chainId: number): Promise<VerifyResult>;
     /**
-     * Get CDP fee information
+     * Get the server's spender address (public, for 402 responses)
+     * Returns cached value computed at construction time.
      */
-    getFee(): Promise<FacilitatorFee>;
+    getSpenderAddress(): string | null;
+    private getServerAddress;
+    private recoverIntentSigner;
+    private getAllowance;
+    private getBalance;
+    private executeTransferFrom;
+    private getTransactionReceipt;
+}
+/**
+ * Create EIP-712 typed data for signing a payment intent
+ *
+ * Used by clients to sign their payment intent.
+ */
+declare function createIntentTypedData(intent: Omit<BNBPaymentIntent, 'signature'>, chainId: number): {
+    domain: {
+        chainId: number;
+        name: string;
+        version: string;
+    };
+    types: {
+        PaymentIntent: {
+            name: string;
+            type: string;
+        }[];
+    };
+    primaryType: "PaymentIntent";
+    message: {
+        from: string;
+        to: string;
+        amount: string;
+        token: string;
+        service: string;
+        nonce: number;
+        deadline: number;
+    };
+};
+
+/**
+ * Solana Chain Configuration
+ *
+ * Solana is NOT an EVM chain - uses different:
+ * - Key format: ed25519 (EdDSA) vs secp256k1 (ECDSA)
+ * - Address format: Base58 vs 0x hex
+ * - Token standard: SPL vs ERC-20
+ */
+
+type SolanaChainName = 'solana' | 'solana_devnet';
+
+/**
+ * Solana Facilitator
+ *
+ * Pay-for-success payment settlement for Solana SPL token transfers.
+ * Unlike EVM chains, Solana doesn't have a third-party facilitator -
+ * we verify and settle directly on-chain.
+ *
+ * Flow:
+ * 1. Client signs a SPL token transfer authorization
+ * 2. Server receives the signed transaction
+ * 3. Server verifies the signature and amount
+ * 4. Server submits the transaction to settle payment
+ */
+
+/**
+ * Solana payment payload structure
+ */
+interface SolanaPaymentPayload {
+    /** Base58 encoded signed transaction */
+    signedTransaction: string;
+    /** Sender's public key (Base58) */
+    sender: string;
+    /** Chain: solana or solana_devnet */
+    chain: SolanaChainName;
+}
+/**
+ * Solana Facilitator configuration
+ */
+interface SolanaFacilitatorConfig {
+    /** Optional fee payer keypair for gasless transactions */
+    feePayerKeypair?: Keypair;
+}
+/**
+ * Solana Facilitator for pay-for-success payments
+ *
+ * Supports gasless mode: if feePayerKeypair is provided, server pays tx fees
+ */
+declare class SolanaFacilitator extends BaseFacilitator {
+    readonly name = "solana";
+    readonly displayName = "Solana Direct";
+    readonly supportedNetworks: string[];
+    private connections;
+    private feePayerKeypair?;
+    constructor(config?: SolanaFacilitatorConfig);
+    /**
+     * Get fee payer public key (for gasless transactions)
+     */
+    getFeePayerPubkey(): string | null;
+    private getConnection;
+    /**
+     * Convert our chain name to network identifier
+     */
+    static chainToNetwork(chain: SolanaChainName): string;
+    /**
+     * Convert network identifier to chain name
+     */
+    static networkToChain(network: string): SolanaChainName | null;
+    healthCheck(): Promise<HealthCheckResult>;
     /**
-     * Check if a chain ID is testnet
+     * Verify a Solana payment
+     *
+     * Checks:
+     * 1. Transaction is valid and properly signed
+     * 2. Transfer instruction matches expected amount and recipient
      */
-    static isTestnet(chainId: number): boolean;
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
     /**
-     * Get configuration summary (for logging)
+     * Settle a Solana payment
+     *
+     * Submits the signed transaction to the network.
+     * In gasless mode, adds fee payer signature before submitting.
      */
-    getConfigSummary(): string;
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    supportsNetwork(network: string): boolean;
 }
+/**
+ * Create a Solana payment transaction for signing
+ *
+ * This is called by the client to create the transaction to sign.
+ *
+ * @param senderPubkey - The sender's public key (token owner)
+ * @param recipientPubkey - The recipient's public key
+ * @param amount - Amount in token base units
+ * @param chain - Solana chain (solana or solana_devnet)
+ * @param feePayerPubkey - Optional fee payer public key for gasless transactions
+ */
+declare function createSolanaPaymentTransaction(senderPubkey: PublicKey, recipientPubkey: PublicKey, amount: bigint, chain: SolanaChainName, feePayerPubkey?: PublicKey): Promise<Transaction>;
 
-export { BaseFacilitator, CDPFacilitator, type CDPFacilitatorConfig, FacilitatorConfig, FacilitatorFee, HealthCheckResult, SettleResult, VerifyResult, X402PaymentPayload, X402PaymentRequirements };
+export { BNBFacilitator, type BNBPaymentIntent, BaseFacilitator, HealthCheckResult, SettleResult, SolanaFacilitator, type SolanaPaymentPayload, TempoFacilitator, VerifyResult, X402PaymentPayload, X402PaymentRequirements, createIntentTypedData, createSolanaPaymentTransaction };