@antseed/node 0.2.27 → 0.2.29

package/dist/payments/seller-payment-manager.d.ts

@@ -1,86 +1,111 @@
 import type { Identity } from '../p2p/identity.js';
 import type { PaymentMux } from '../p2p/payment-mux.js';
-import type { SpendingAuthPayload, BuyerAckPayload } from '../types/protocol.js';
-import { BaseEscrowClient } from './evm/escrow-client.js';
-import { SessionStore } from './session-store.js';
+import type { SpendingAuthPayload, PaymentRequiredPayload } from '../types/protocol.js';
+import { ChannelsClient } from './evm/channels-client.js';
+import { ChannelStore, type StoredChannel } from './channel-store.js';
 export interface SellerPaymentConfig {
     rpcUrl: string;
-    contractAddress: string;
-    usdcAddress: string;
+    channelsContractAddress: string;
     chainId: number;
     dataDir: string;
-    /** Timeout in seconds before a disconnected session is considered ghost. Default: 86400 (24h). */
-    settleTimeoutSecs?: number;
-    /** Suggested USDC amount (base units) for first-sign sessions. Default: 100000 ($0.10). */
-    firstSignAmountUsdc?: string;
-    /** Suggested USDC amount (base units) for proven-sign sessions. Default: 100000 ($0.10). */
-    provenSignAmountUsdc?: string;
+    /** Minimum USDC per request (base units). Default: "10000" ($0.01). */
+    minBudgetPerRequest?: string;
+    /** Whether to immediately settle when buyer disconnects. Default: true. */
+    settleOnDisconnect?: boolean;
 }
 /**
- * Manages seller-side payment sessions using the settle-then-reserve
- * atomic flow with persistent session storage.
+ * Manages seller-side payment sessions.
+ * The buyer sends a single SpendingAuth signature with a monotonically
+ * increasing cumulativeAmount on every request.
+ * The seller tracks spending locally and settles/closes via the contract at session end.
  */
 export declare class SellerPaymentManager {
     private readonly _identity;
     private readonly _signer;
-    private readonly _escrowClient;
+    private readonly _channelsClient;
     private readonly _config;
-    private readonly _sessionStore;
+    private readonly _channelStore;
     /** In-memory cache of active buyer peerIds for fast has-session checks. */
     private readonly _activeBuyers;
-    /** Debounce: track sessions that already sent a top-up request. */
-    private readonly _topUpRequested;
-    /** Cached seller tokenRate (fetched once from escrow, used for top-up threshold). */
-    private _tokenRate;
-    /** Cached FIRST_SIGN_CAP from escrow contract. */
-    private _firstSignCap;
     /** Per-buyer mutex to prevent concurrent handleSpendingAuth for the same buyer. */
     private readonly _buyerLocks;
-    constructor(identity: Identity, config: SellerPaymentConfig, sessionStore: SessionStore);
-    get escrowClient(): BaseEscrowClient;
+    /** channelId -> highest accepted cumulativeAmount from buyer's SpendingAuth */
+    private readonly _acceptedCumulative;
+    /** channelId -> total USDC spent so far (sum of recordSpend calls) */
+    private readonly _spent;
+    /** channelId -> on-chain reserveMaxAmount (budget ceiling from ReserveAuth) */
+    private readonly _reserveMax;
+    /** channelId -> latest buyer-signed auth (both sigs + cumulative values + metadata) for settle/close */
+    private readonly _latestAuth;
+    /** channelId -> number of failed close() attempts. In-memory only; resets on node restart. */
+    private readonly _closeRetryCount;
+    /** Max close() retries before giving up (buyer must requestClose on-chain) */
+    private static readonly MAX_CLOSE_RETRIES;
+    constructor(identity: Identity, config: SellerPaymentConfig, channelStore: ChannelStore);
+    get channelsClient(): ChannelsClient;
     /**
      * Handle incoming SpendingAuth from a buyer.
-     * 1. Verify EIP-712 signature
-     * 2. Settle prior session if one exists
-     * 3. Reserve new session on-chain
-     * 4. Store and send AuthAck
+     * First auth: verify SpendingAuth, reserve on-chain, send AuthAck.
+     * Subsequent: verify SpendingAuth signature, validate monotonic increase, persist.
      */
-    handleSpendingAuth(buyerPeerId: string, buyerEvmAddr: string, payload: SpendingAuthPayload, paymentMux: PaymentMux): Promise<void>;
+    handleSpendingAuth(buyerPeerId: string, payload: SpendingAuthPayload, paymentMux: PaymentMux): Promise<'accepted' | 'reserved' | 'rejected'>;
     private _handleSpendingAuthInner;
+    private _recoverOnChainSession;
+    private _activateSession;
     /**
-     * Send a bilateral receipt to the buyer after processing a request.
-     * Also triggers TopUpRequest if consumption exceeds 80% of authMax.
+     * Validate and accept a SpendingAuth attached to an incoming request.
+     * Returns true if the buyer has sufficient budget to serve this request.
      */
-    sendReceipt(buyerPeerId: string, paymentMux: PaymentMux, responseBody: Uint8Array, tokensDelivered: bigint): Promise<void>;
-    handleBuyerAck(buyerPeerId: string, payload: BuyerAckPayload): Promise<void>;
+    validateAndAcceptAuth(buyerPeerId: string, auth: SpendingAuthPayload): Promise<boolean>;
+    /**
+     * Record USDC consumption after serving a request.
+     */
+    recordSpend(sessionId: string, costUsdc: bigint): void;
+    /**
+     * Close a completed session on-chain using the latest buyer-signed dual signatures.
+     * Uses close() for final settlement (releases remaining deposit to buyer).
+     */
+    settleSession(buyerPeerId: string, { cleanupOnFailure }?: {
+        cleanupOnFailure?: boolean | undefined;
+    }): Promise<void>;
     onBuyerDisconnect(buyerPeerId: string): void;
     /**
-     * Check for and settle timed-out sessions.
+     * Check for stale sessions and attempt to close them.
+     * The seller can only close() with a valid SpendingAuth — it cannot
+     * requestClose or withdraw (those are buyer-only on-chain).
+     * If the seller has no auths, the session remains open until the buyer
+     * calls requestClose → withdraw on-chain.
      * Called periodically and on startup for recovery.
      */
     checkTimeouts(): Promise<void>;
     hasSession(buyerPeerId: string): boolean;
-    /** Minimum interval between init retry attempts. */
-    private _lastInitAttemptMs;
-    private static readonly INIT_RETRY_INTERVAL_MS;
-    /**
-     * Pre-fetch on-chain data (tokenRate, FIRST_SIGN_CAP) so PaymentRequired
-     * messages can be sent without blocking on RPC calls.
-     */
-    init(): Promise<void>;
-    /** Retry init if on-chain data is missing and enough time has passed. */
-    ensureInitialized(): Promise<void>;
+    /** Get the active session for a buyer peer, or null. */
+    getChannelByPeer(buyerPeerId: string): StoredChannel | null;
+    /** Get total USDC spent for a session (sum of recordSpend calls). */
+    getCumulativeSpend(sessionId: string): bigint;
+    /** Get the highest accepted cumulative amount for a session. */
+    getAcceptedCumulative(sessionId: string): bigint;
+    /** Get the on-chain reserve budget ceiling for a session. */
+    getReserveMax(sessionId: string): bigint;
     private static readonly DEFAULT_SUGGESTED_AMOUNT;
     /**
      * Build the PaymentRequired payload for a buyer that doesn't have a session.
-     * Returns null if on-chain data isn't available yet.
-     * For returning buyers (proven-sign eligible), uses the configured proven-sign
-     * amount instead of the first-sign amount (both default to $0.10).
      */
     getPaymentRequirements(requestId: string, buyerPeerId?: string, pricing?: {
         inputUsdPerMillion?: number;
         outputUsdPerMillion?: number;
-    }): import('../types/protocol.js').PaymentRequiredPayload | null;
+    }): PaymentRequiredPayload;
+    /**
+     * Handle a CloseRequested event for a channel this seller manages.
+     * If the seller has a stored SpendingAuth, immediately close the channel
+     * on-chain to claim earnings before the grace period expires.
+     */
+    handleCloseRequested(channelId: string): Promise<void>;
+    /**
+     * Poll for CloseRequested events and handle any that match active channels.
+     * Returns the block number to use as the next fromBlock cursor.
+     */
+    pollCloseRequested(fromBlock: number): Promise<number>;
     close(): void;
 }
 //# sourceMappingURL=seller-payment-manager.d.ts.map

package/dist/payments/seller-payment-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seller-payment-manager.d.ts","sourceRoot":"","sources":["../../src/payments/seller-payment-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seller-payment-manager.d.ts","sourceRoot":"","sources":["../../src/payments/seller-payment-manager.ts"],"names":[],"mappings":"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"}