moltspay 1.3.0 → 1.4.1

package/dist/facilitators/index.d.ts

@@ -1,6 +1,7 @@
 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';
 
 /**
  * Tempo Testnet Facilitator
@@ -26,4 +27,222 @@ declare class TempoFacilitator extends BaseFacilitator {
     private getTransactionReceipt;
 }
 
-export { BaseFacilitator, HealthCheckResult, SettleResult, TempoFacilitator, VerifyResult, X402PaymentPayload, X402PaymentRequirements };
+/**
+ * BNB Chain Facilitator
+ *
+ * Handles pay-for-success payments on BNB Smart Chain.
+ *
+ * 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)
+ */
+
+/**
+ * BNB Payment Intent (signed by client)
+ */
+interface BNBPaymentIntent {
+    from: string;
+    to: string;
+    amount: string;
+    token: string;
+    service: string;
+    nonce: number;
+    deadline: number;
+    signature: string;
+}
+/**
+ * BNB Chain 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 BNBFacilitator extends BaseFacilitator {
+    readonly name = "bnb";
+    readonly displayName = "BNB Smart Chain";
+    readonly supportedNetworks: string[];
+    private serverPrivateKey;
+    private spenderAddress;
+    private chainConfigs;
+    constructor(serverPrivateKey?: string);
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * 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
+     */
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    /**
+     * 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.
+     */
+    settle(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<SettleResult>;
+    /**
+     * Check if client has approved the server wallet
+     */
+    checkApproval(clientAddress: string, token: string, chainId: number): Promise<{
+        approved: boolean;
+        allowance: string;
+    }>;
+    /**
+     * Verify a completed transaction (for checking past payments)
+     */
+    verifyTransaction(txHash: string, expected: {
+        to: string;
+        amount: string;
+        token: string;
+    }, chainId: number): Promise<VerifyResult>;
+    /**
+     * Get the server's spender address (public, for 402 responses)
+     * Returns cached value computed at construction time.
+     */
+    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>;
+    /**
+     * Verify a Solana payment
+     *
+     * Checks:
+     * 1. Transaction is valid and properly signed
+     * 2. Transfer instruction matches expected amount and recipient
+     */
+    verify(paymentPayload: X402PaymentPayload, requirements: X402PaymentRequirements): Promise<VerifyResult>;
+    /**
+     * Settle a Solana payment
+     *
+     * Submits the signed transaction to the network.
+     * In gasless mode, adds fee payer signature before submitting.
+     */
+    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 { BNBFacilitator, type BNBPaymentIntent, BaseFacilitator, HealthCheckResult, SettleResult, SolanaFacilitator, type SolanaPaymentPayload, TempoFacilitator, VerifyResult, X402PaymentPayload, X402PaymentRequirements, createIntentTypedData, createSolanaPaymentTransaction };