@antseed/node 0.2.106 → 0.2.108

package/dist/payments/buyer-free-usage-manager.js

@@ -1,299 +1,3 @@
-import { randomBytes } from 'node:crypto';
-import { peerIdToAddress } from '../types/peer.js';
-import { debugLog, debugWarn } from '../utils/debug.js';
-import { computeFreeUsageChannelId, computeFreeUsageMetadataHash, encodeFreeUsageMetadata, makeFreeUsageDomain, signFreeUsageAuth, signFreeUsageOpen, } from './evm/signatures.js';
-import { CHANNEL_KIND, CHANNEL_ROLE, CHANNEL_STATUS } from './channel-store.js';
-import { advanceUsageMetadata, RequestServiceTracker } from './channel-usage-accounting.js';
-const DEFAULT_OPEN_ACK_TIMEOUT_MS = 30_000;
-export class BuyerFreeUsageManager {
-    _identity;
-    _config;
-    _sellerAddressResolver;
-    _channelStore;
-    _domain;
-    _sessions = new Map();
-    _sellerLocks = new Map();
-    _openAckWaiters = new Map();
-    _requestService = new RequestServiceTracker();
-    constructor(identity, config, sellerAddressResolver, channelStore) {
-        this._identity = identity;
-        this._config = config;
-        this._sellerAddressResolver = sellerAddressResolver;
-        this._channelStore = channelStore;
-        this._domain = makeFreeUsageDomain(config.chainId, config.freeUsageContractAddress);
-        this._hydrateFromStore();
-    }
-    get _disableMetadataV2Services() {
-        return this._config.disableMetadataV2Services === true;
-    }
-    _sanitizeMetadata(metadata) {
-        if (!this._disableMetadataV2Services)
-            return metadata;
-        return {
-            cumulativeInputTokens: metadata.cumulativeInputTokens,
-            cumulativeOutputTokens: metadata.cumulativeOutputTokens,
-            cumulativeRequestCount: metadata.cumulativeRequestCount,
-            services: [],
-        };
-    }
-    _advanceUsageMetadata(previous, service, delta) {
-        return advanceUsageMetadata(this._sanitizeMetadata(previous), this._disableMetadataV2Services ? undefined : service, delta);
-    }
-    _hydrateFromStore() {
-        if (!this._channelStore)
-            return;
-        const activeChannels = this._channelStore.getActiveChannelsByBuyer(CHANNEL_ROLE.BUYER, this._identity.wallet.address, CHANNEL_KIND.FREE);
-        for (const channel of activeChannels) {
-            if (this._sessions.has(channel.peerId))
-                continue;
-            const metadata = this._sanitizeMetadata(this._channelStore.getChannelMetadata(channel));
-            if (!this._disableMetadataV2Services) {
-                this._channelStore.replaceMetadataServiceTotals(channel.sessionId, metadata.services);
-            }
-            this._sessions.set(channel.peerId, {
-                channelId: channel.sessionId,
-                // Salt is only needed to create a fresh open signature; hydrated
-                // sessions are already opened and only sign usage auths.
-                salt: '0x' + '00'.repeat(32),
-                deadline: channel.deadline,
-                sellerEvmAddr: channel.sellerEvmAddr,
-                cumulativeInputTokens: metadata.cumulativeInputTokens,
-                cumulativeOutputTokens: metadata.cumulativeOutputTokens,
-                cumulativeRequestCount: metadata.cumulativeRequestCount,
-                latestSequence: BigInt(channel.requestCount),
-                services: metadata.services,
-                openedAck: true,
-                latestMetadata: metadata,
-                openSig: channel.latestBuyerSig,
-            });
-        }
-    }
-    trackRequestService(requestId, service) {
-        this._requestService.track(requestId, service);
-    }
-    async prepareOpen(peer, paymentMux) {
-        const existing = this._sessions.get(peer.peerId);
-        const nowSec = Math.floor(Date.now() / 1000);
-        if (existing && existing.deadline > nowSec + 30)
-            return;
-        const sellerEvmAddr = await this._resolveSellerAddr(peer);
-        const salt = '0x' + randomBytes(32).toString('hex');
-        const channelId = computeFreeUsageChannelId(this._identity.wallet.address, sellerEvmAddr, salt);
-        const deadline = nowSec + this._config.defaultAuthDurationSecs;
-        const openSig = await signFreeUsageOpen(this._identity.wallet, this._domain, {
-            channelId,
-            deadline: BigInt(deadline),
-        });
-        const metadata = {
-            cumulativeInputTokens: 0n,
-            cumulativeOutputTokens: 0n,
-            cumulativeRequestCount: 0n,
-            services: [],
-        };
-        const session = {
-            channelId,
-            salt,
-            deadline,
-            sellerEvmAddr,
-            cumulativeInputTokens: 0n,
-            cumulativeOutputTokens: 0n,
-            cumulativeRequestCount: 0n,
-            latestSequence: 0n,
-            services: [],
-            openedAck: false,
-            latestMetadata: metadata,
-            openSig,
-        };
-        this._sessions.set(peer.peerId, session);
-        try {
-            paymentMux.sendFreeUsageOpen({ channelId, salt, deadline, openSig });
-        }
-        catch (err) {
-            if (existing) {
-                this._sessions.set(peer.peerId, existing);
-            }
-            else {
-                this._sessions.delete(peer.peerId);
-            }
-            throw err;
-        }
-        debugLog(`[BuyerFreeUsage] Open sent to ${peer.peerId.slice(0, 12)}... channel=${channelId.slice(0, 18)}...`);
-    }
-    async waitForOpenAck(sellerPeerId, timeoutMs = this._config.openAckTimeoutMs ?? DEFAULT_OPEN_ACK_TIMEOUT_MS) {
-        const session = this._sessions.get(sellerPeerId);
-        if (!session) {
-            throw new Error(`free usage channel for ${sellerPeerId.slice(0, 12)}... was not prepared`);
-        }
-        if (session.openedAck)
-            return;
-        await new Promise((resolve, reject) => {
-            const waiter = {
-                session,
-                resolve,
-                reject,
-                timer: setTimeout(() => {
-                    this._removeOpenAckWaiter(sellerPeerId, waiter);
-                    if (this._sessions.get(sellerPeerId) === session && !session.openedAck) {
-                        this._sessions.delete(sellerPeerId);
-                        this._channelStore?.updateChannelStatus(session.channelId, CHANNEL_STATUS.TIMEOUT);
-                    }
-                    reject(new Error(`timed out waiting for free usage open ack from ${sellerPeerId.slice(0, 12)}...`));
-                }, timeoutMs),
-            };
-            let waiters = this._openAckWaiters.get(sellerPeerId);
-            if (!waiters) {
-                waiters = new Set();
-                this._openAckWaiters.set(sellerPeerId, waiters);
-            }
-            waiters.add(waiter);
-        });
-    }
-    handleAck(sellerPeerId, payload) {
-        const session = this._sessions.get(sellerPeerId);
-        if (!session || session.channelId !== payload.channelId)
-            return;
-        session.openedAck = true;
-        this._persistSession(sellerPeerId, session, session.openSig, null, null);
-        this._retireOtherActiveSessions(sellerPeerId, session.channelId);
-        this._resolveOpenAckWaiters(sellerPeerId, session);
-        debugLog(`[BuyerFreeUsage] Ack from ${sellerPeerId.slice(0, 12)}... channel=${payload.channelId.slice(0, 18)}...` +
-            `${payload.acceptedSequence ? ` sequence=${payload.acceptedSequence}` : ''}`);
-    }
-    onPeerDisconnect(sellerPeerId) {
-        this._sessions.delete(sellerPeerId);
-        this._sellerLocks.delete(sellerPeerId);
-        this._rejectOpenAckWaiters(sellerPeerId, new Error(`peer ${sellerPeerId.slice(0, 12)}... disconnected before free usage open ack`));
-    }
-    async handleNeedAuth(sellerPeerId, payload, paymentMux) {
-        const lock = (this._sellerLocks.get(sellerPeerId) ?? Promise.resolve()).then(async () => {
-            await this._handleNeedAuthInner(sellerPeerId, payload, paymentMux);
-        });
-        this._sellerLocks.set(sellerPeerId, lock.catch(() => { }));
-        return lock;
-    }
-    async _handleNeedAuthInner(sellerPeerId, payload, paymentMux) {
-        const session = this._sessions.get(sellerPeerId);
-        if (!session || session.channelId !== payload.channelId) {
-            debugWarn(`[BuyerFreeUsage] NeedFreeUsageAuth for unknown channel ${payload.channelId.slice(0, 18)}...`);
-            return;
-        }
-        const requiredSequence = BigInt(payload.requiredSequence);
-        if (requiredSequence <= session.latestSequence) {
-            return;
-        }
-        const inputTokens = BigInt(payload.inputTokens ?? '0');
-        const outputTokens = BigInt(payload.outputTokens ?? '0');
-        const attributedService = this._requestService.get(payload.requestId) ?? payload.service;
-        const metadata = this._advanceUsageMetadata(session.latestMetadata, attributedService, {
-            amount: 0n,
-            inputTokens,
-            cachedInputTokens: 0n,
-            outputTokens,
-            requests: 1n,
-        });
-        const metadataHash = computeFreeUsageMetadataHash(metadata);
-        const encodedMetadata = encodeFreeUsageMetadata(metadata);
-        const usageSig = await signFreeUsageAuth(this._identity.wallet, this._domain, {
-            channelId: session.channelId,
-            sequence: requiredSequence,
-            metadataHash,
-            deadline: BigInt(session.deadline),
-        });
-        paymentMux.sendFreeUsageAuth({
-            channelId: session.channelId,
-            cumulativeInputTokens: metadata.cumulativeInputTokens.toString(),
-            cumulativeOutputTokens: metadata.cumulativeOutputTokens.toString(),
-            sequence: requiredSequence.toString(),
-            metadataHash,
-            metadata: encodedMetadata,
-            deadline: session.deadline,
-            usageSig,
-        });
-        session.latestSequence = requiredSequence;
-        session.cumulativeInputTokens = metadata.cumulativeInputTokens;
-        session.cumulativeOutputTokens = metadata.cumulativeOutputTokens;
-        session.cumulativeRequestCount = metadata.cumulativeRequestCount;
-        session.services = metadata.services;
-        session.latestMetadata = metadata;
-        this._requestService.take(payload.requestId);
-        this._persistSession(sellerPeerId, session, null, usageSig, encodedMetadata);
-        debugLog(`[BuyerFreeUsage] UsageAuth sent to ${sellerPeerId.slice(0, 12)}... ` +
-            `channel=${session.channelId.slice(0, 18)}... sequence=${session.latestSequence}`);
-    }
-    async _resolveSellerAddr(peer) {
-        if (!this._sellerAddressResolver)
-            return peerIdToAddress(peer.peerId);
-        return this._sellerAddressResolver.resolveSellerAddress(peer.peerId, peer.metadata);
-    }
-    _resolveOpenAckWaiters(sellerPeerId, session) {
-        const waiters = this._openAckWaiters.get(sellerPeerId);
-        if (!waiters)
-            return;
-        for (const waiter of [...waiters]) {
-            if (waiter.session !== session)
-                continue;
-            this._removeOpenAckWaiter(sellerPeerId, waiter);
-            waiter.resolve();
-        }
-    }
-    _rejectOpenAckWaiters(sellerPeerId, err) {
-        const waiters = this._openAckWaiters.get(sellerPeerId);
-        if (!waiters)
-            return;
-        for (const waiter of [...waiters]) {
-            this._removeOpenAckWaiter(sellerPeerId, waiter);
-            waiter.reject(err);
-        }
-    }
-    _removeOpenAckWaiter(sellerPeerId, waiter) {
-        clearTimeout(waiter.timer);
-        const waiters = this._openAckWaiters.get(sellerPeerId);
-        if (!waiters)
-            return;
-        waiters.delete(waiter);
-        if (waiters.size === 0)
-            this._openAckWaiters.delete(sellerPeerId);
-    }
-    _retireOtherActiveSessions(sellerPeerId, keepSessionId) {
-        if (!this._channelStore)
-            return;
-        const activeChannels = this._channelStore.getActiveChannelsByBuyer(CHANNEL_ROLE.BUYER, this._identity.wallet.address, CHANNEL_KIND.FREE);
-        for (const channel of activeChannels) {
-            if (channel.peerId !== sellerPeerId || channel.sessionId === keepSessionId)
-                continue;
-            this._channelStore.updateChannelStatus(channel.sessionId, CHANNEL_STATUS.GHOST);
-        }
-    }
-    _persistSession(sellerPeerId, session, openSig, usageSig, encodedMetadata) {
-        if (!this._channelStore)
-            return;
-        const now = Date.now();
-        const existing = this._channelStore.getChannel(session.channelId);
-        this._channelStore.upsertChannel({
-            sessionId: session.channelId,
-            peerId: sellerPeerId,
-            role: CHANNEL_ROLE.BUYER,
-            channelKind: CHANNEL_KIND.FREE,
-            sellerEvmAddr: session.sellerEvmAddr,
-            buyerEvmAddr: this._identity.wallet.address,
-            nonce: 0,
-            authMax: '0',
-            deadline: session.deadline,
-            previousSessionId: '0x' + '00'.repeat(32),
-            previousConsumption: session.cumulativeOutputTokens.toString(),
-            tokensDelivered: session.cumulativeInputTokens.toString(),
-            requestCount: Number(session.cumulativeRequestCount),
-            reservedAt: existing?.reservedAt ?? now,
-            settledAt: null,
-            settledAmount: null,
-            status: CHANNEL_STATUS.ACTIVE,
-            latestBuyerSig: openSig ?? existing?.latestBuyerSig ?? null,
-            latestSpendingAuthSig: usageSig ?? existing?.latestSpendingAuthSig ?? null,
-            latestMetadata: encodedMetadata ?? existing?.latestMetadata ?? null,
-            createdAt: existing?.createdAt ?? now,
-            updatedAt: now,
-        });
-        this._channelStore.replaceMetadataServiceTotals(session.channelId, this._sanitizeMetadata(session.latestMetadata).services);
-    }
-}
+// Moved to @antseed/buyer-core; re-exported for compatibility.
+export * from '@antseed/buyer-core/buyer-free-usage-manager';
 //# sourceMappingURL=buyer-free-usage-manager.js.map

package/dist/payments/buyer-free-usage-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"buyer-free-usage-manager.js","sourceRoot":"","sources":["../../src/payments/buyer-free-usage-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buyer-free-usage-manager.js","sourceRoot":"","sources":["../../src/payments/buyer-free-usage-manager.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,8CAA8C,CAAC"}

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

@@ -1,278 +1,2 @@
-import { type AbstractSigner } from 'ethers';
-import type { Identity } from '../p2p/identity.js';
-import type { PaymentMux } from '../p2p/payment-mux.js';
-import type { SpendingAuthPayload, AuthAckPayload, NeedAuthPayload, CloseChannelRequestPayload } from '../types/protocol.js';
-import { DepositsClient } from './evm/deposits-client.js';
-import type { SellerAddressResolver } from '../discovery/seller-address-resolver.js';
-import type { PeerMetadata } from '../discovery/peer-metadata.js';
-import { ChannelStore, CHANNEL_STATUS, type StoredChannel } from './channel-store.js';
-import { type ServicePricing } from './pricing.js';
-export interface BuyerPaymentConfig {
-    rpcUrl: string;
-    fallbackRpcUrls?: string[];
-    depositsContractAddress: string;
-    channelsContractAddress: string;
-    usdcAddress: string;
-    identityRegistryAddress: string;
-    chainId: number;
-    defaultAuthDurationSecs: number;
-    /**
-     * Max unverified exposure (overdraft limit) in USDC base units.
-     * The buyer will never sign more than verifiedCost + maxPerRequestUsdc.
-     * Default: 500000 ($0.50).
-     */
-    maxPerRequestUsdc: bigint;
-    /** Max USDC to reserve per ReserveAuth signature (base units). Default: 1000000 ($1.00). */
-    maxReserveAmountUsdc: bigint;
-    /** Max ratio of seller-claimed cost to buyer's bytes/4 estimate. Default: 1.4. */
-    costToleranceMultiplier?: number;
-    /** Disable per-service attribution in metadata v2. Default: false. */
-    disableMetadataV2Services?: boolean;
-    dataDir: string;
-}
-/** Result of signPerRequestAuth — includes the payload and whether a reserve top-up is needed. */
-export interface PerRequestAuthResult {
-    payload: SpendingAuthPayload;
-    topUpNeeded: boolean;
-}
-/**
- * One request's newly authorized spend, reported as it is signed.
- *
- * Both the buyer-initiated (signPerRequestAuth) and seller-initiated
- * (handleNeedAuth) paths can advance the cumulative for the same request, so
- * a single request may produce more than one event; the amounts are disjoint
- * deltas and sum to the request's total. Token counts follow the same
- * lower-bound rule as metadata attribution — whichever path counts the request
- * first reports the tokens, the other reports zero.
- */
-export interface BuyerSpendEvent {
-    sellerPeerId: string;
-    /** Proxy request id, when the caller threaded one through. */
-    requestId: string | null;
-    /** USDC base units newly authorized by this signature. */
-    amountUsdc: string;
-    inputTokens: string;
-    cachedInputTokens: string;
-    outputTokens: string;
-}
-export type BuyerSpendListener = (event: BuyerSpendEvent) => void;
-/**
- * Manages buyer-side payment sessions using EIP-712 SpendingAuth
- * with cumulative authorization, bytes/4 cost verification, and overdraft control.
- */
-export declare class BuyerPaymentManager {
-    private readonly _identity;
-    private _signer;
-    private readonly _depositsClient;
-    private readonly _config;
-    private readonly _channelStore;
-    /** In-memory map of active confirmed sessions by seller peerId for fast lookups. */
-    private readonly _confirmedPeers;
-    /** Peers that explicitly rejected our spending auth. */
-    private readonly _rejectedPeers;
-    private readonly _sellerAddressResolver?;
-    /** sellerPeerId -> cumulative USDC amount in the latest SpendingAuth */
-    private readonly _cumulativeAmount;
-    /** sellerPeerId -> cumulative metadata for SpendingAuth */
-    private readonly _metadata;
-    /** sellerPeerId -> buyer-verified cumulative cost from bytes/4 */
-    private readonly _verifiedCost;
-    /** requestId -> service/model the buyer requested (from its own request body).
-     *  Used in handleNeedAuth to validate cost with the correct pricing tier
-     *  without trusting the seller's claim of which service was used. */
-    private readonly _requestService;
-    /** sellerPeerId -> full pricing map (defaults + per-service overrides from peer metadata / 402) */
-    private readonly _sessionPricing;
-    /** Cumulative response token totals per seller, tracked independently of signing metadata. */
-    private readonly _responseTokenTotals;
-    /** sellerPeerId -> current on-chain reserve ceiling (can grow with top-ups) */
-    private readonly _currentReserveCeiling;
-    /** sellerPeerId -> original first-reserve amount for replaying reserve() safely. */
-    private readonly _initialReserveAmount;
-    /** sellerPeerId -> salt used in the current reserve */
-    private readonly _reserveSalt;
-    /** Cached EIP-712 domain — static for the lifetime of this manager. */
-    private readonly _channelsDomain;
-    constructor(identity: Identity, config: BuyerPaymentConfig, channelStore: ChannelStore, sellerAddressResolver?: SellerAddressResolver);
-    /** Hydrate cumulative tracking maps from persisted active buyer sessions. */
-    private _hydrateFromStore;
-    get signer(): AbstractSigner;
-    setSigner(signer: AbstractSigner): void;
-    get depositsClient(): DepositsClient;
-    private get _costTolerance();
-    private get _disableMetadataV2Services();
-    private _sanitizeMetadata;
-    private _advanceUsageMetadata;
-    private _getCeiling;
-    /** Clean up all in-memory state for a seller when the session ends. */
-    cleanupSession(sellerPeerId: string): void;
-    getActiveSession(sellerPeerId: string): StoredChannel | null;
-    retireSession(sellerPeerId: string, status: typeof CHANNEL_STATUS.SETTLED | typeof CHANNEL_STATUS.TIMEOUT | typeof CHANNEL_STATUS.GHOST, settledAmount?: bigint): void;
-    canReplayReserveAuth(sellerPeerId: string): boolean;
-    clearLockConfirmation(sellerPeerId: string): void;
-    resendCurrentSpendingAuth(sellerPeerId: string, paymentMux: PaymentMux): Promise<string>;
-    extendCurrentSpendingAuth(sellerPeerId: string, minBudgetPerRequest: bigint, paymentMux: PaymentMux, targetCumulative?: bigint): Promise<string>;
-    /**
-     * Build a CloseChannelRequest for an active session.
-     *
-     * With `includeAuth` (the default) the buyer signs its current cumulative so
-     * a seller that lost the last SpendingAuth can still close at the full
-     * amount owed. Signing costs nothing extra: the cumulative is unchanged, so
-     * this authorizes no more than the seller could already claim. Pass
-     * `includeAuth: false` to send a bare request and let the seller close using
-     * whatever auth it already holds.
-     */
-    buildCloseChannelRequest(sellerPeerId: string, { includeAuth }?: {
-        includeAuth?: boolean;
-    }): Promise<CloseChannelRequestPayload>;
-    resendReserveAuth(sellerPeerId: string, paymentMux: PaymentMux): Promise<string>;
-    private _reopenOverdraftWindowIfCollapsed;
-    private _needsCeilingAdvance;
-    /**
-     * Both signPerRequestAuth (buyer-initiated) and handleNeedAuth (seller-initiated)
-     * can fire for the same request when the proactive auth doesn't fully cover the
-     * seller's required cumulative. Whichever path counts a request's tokens first
-     * records its requestId here so the other path attributes only the amount delta.
-     */
-    private readonly _serviceTokensCounted;
-    private _spendListener;
-    /**
-     * Observe per-request spend as it is signed. Used to attribute cost to the
-     * caller's own unit of work (a tool conversation, say), which only the layer
-     * that issued the request can know.
-     */
-    setSpendListener(listener: BuyerSpendListener | null): void;
-    private _reportSpend;
-    private _persistServiceMetadata;
-    private _sendUpdatedSpendingAuth;
-    private _topUpAfterSpendAuthBestEffort;
-    /**
-     * Sign and send an initial EIP-712 SpendingAuth to a seller.
-     * The initial cumulativeAmount is set to the seller's minBudgetPerRequest.
-     *
-     * @param pricing Token pricing from the seller's 402 / peer metadata.
-     * @param pricingMap Full pricing map (defaults + per-service) from peer metadata. If provided,
-     *   merges with existing session pricing. The `pricing` arg is used as the service-specific
-     *   override for the service that triggered the 402.
-     */
-    authorizeSpending(sellerPeerId: string, paymentMux: PaymentMux, minBudgetPerRequest: bigint, reserveAmountOrPricing?: bigint | ServicePricing, pricingArg?: ServicePricing, pricingMap?: {
-        defaults: ServicePricing;
-        services: Record<string, ServicePricing>;
-    }, metadataArg?: PeerMetadata): Promise<string>;
-    handleAuthAck(sellerPeerId: string, payload: AuthAckPayload): void;
-    /**
-     * Estimate tokens and cost from response content without updating state.
-     */
-    private _estimateResponseCost;
-    /**
-     * Accumulate a cost estimate into verifiedCost.
-     */
-    private _accumulateVerifiedCost;
-    /**
-     * Record response content and update the buyer's verified cost.
-     * Call this after receiving each response from the seller.
-     *
-     * NOTE: Do not call this AND signPerRequestAuth for the same response —
-     * signPerRequestAuth already updates verifiedCost internally.
-     *
-     * @returns The updated verified cost and estimated tokens, or null if no pricing is available.
-     */
-    recordResponseBytes(sellerPeerId: string, inputBytes: Uint8Array, outputBytes: Uint8Array): {
-        verifiedCost: bigint;
-        inputTokens: number;
-        outputTokens: number;
-    } | null;
-    /**
-     * Compute the max signable cumulative amount based on the overdraft model:
-     * maxSignable = verifiedCost + maxPerRequestUsdc, capped at reserve ceiling.
-     */
-    private _maxSignable;
-    /**
-     * Check whether the current cumulative amount is approaching the reserve ceiling
-     * and a top-up should be triggered.
-     */
-    private _needsTopUp;
-    /**
-     * Sign an updated SpendingAuth after receiving a response.
-     *
-     * The buyer uses the seller's claimed cost to advance the cumulative amount,
-     * but validates it against the buyer's bytes/4 estimate. If the seller's claim
-     * exceeds the buyer's estimate by more than the configured tolerance, the buyer
-     * caps at tolerance * buyerEstimate. The cumulative is also capped at the
-     * overdraft limit (verifiedCost + maxPerRequestUsdc) and the reserve ceiling.
-     *
-     * @param sellerPeerId Seller peer ID.
-     * @param responseStats Byte counts from the last response and seller's claimed cost.
-     * @returns The signed payload and whether a reserve top-up is needed.
-     */
-    signPerRequestAuth(sellerPeerId: string, responseStats: {
-        inputBytes: Uint8Array;
-        outputBytes: Uint8Array;
-        sellerClaimedCost?: bigint;
-        reportedInputTokens?: bigint;
-        reportedOutputTokens?: bigint;
-        reportedCachedInputTokens?: bigint;
-        service?: string;
-        requestId?: string;
-    }): Promise<PerRequestAuthResult>;
-    /**
-     * Handle seller-initiated NeedAuth messages sent after every served request.
-     * The seller includes the cost of the last request; the buyer validates it
-     * against its own token count and signs a new SpendingAuth for the required
-     * cumulative amount, capped at the reserve ceiling.
-     */
-    handleNeedAuth(sellerPeerId: string, payload: NeedAuthPayload, paymentMux: PaymentMux): Promise<void>;
-    /**
-     * Sign a new ReserveAuth with a higher maxAmount to extend the session's reserve ceiling.
-     * The seller must call reserve() on-chain again with the new signature.
-     * Note: requires contract support for top-up (increaseDeposit on existing channelId).
-     */
-    topUpReserve(sellerPeerId: string, paymentMux: PaymentMux): Promise<void>;
-    /** Max USDC overdraft (unverified exposure) from buyer config. */
-    get maxPerRequestUsdc(): bigint;
-    /** Max USDC per ReserveAuth signature from buyer config. */
-    get maxReserveAmountUsdc(): bigint;
-    /** Current buyer-verified cost for a seller. */
-    getVerifiedCost(sellerPeerId: string): bigint;
-    /** Current reserve ceiling for a seller (may be higher than initial after top-ups). */
-    getReserveCeiling(sellerPeerId: string): bigint;
-    /** Current cumulative signed amount for a seller. */
-    getCumulativeAmount(sellerPeerId: string): bigint;
-    /** Live cumulative token counts for a seller (in-memory, always up-to-date). */
-    getCumulativeTokens(sellerPeerId: string): {
-        inputTokens: bigint;
-        outputTokens: bigint;
-    };
-    /**
-     * Accumulate response token counts and persist to the channel store.
-     * Tracks its own running totals independently of signPerRequestAuth metadata,
-     * so the persisted data is always up-to-date after each response.
-     */
-    recordAndPersistTokens(sellerPeerId: string, inputTokens: number, outputTokens: number): void;
-    /** Register which service the buyer requested for a given requestId. */
-    trackRequestService(requestId: string, service: string): void;
-    /** Get the live response token totals for a seller, or null if none recorded this session. */
-    getResponseTokenTotals(sellerPeerId: string): {
-        input: number;
-        output: number;
-        requests: number;
-    } | null;
-    /** Get the session pricing for a seller+service. Resolves service-specific pricing first, then defaults. */
-    getSessionPricing(sellerPeerId: string, service?: string): ServicePricing | null;
-    /** Check if a session has been confirmed via AuthAck. */
-    isAuthorized(sellerPeerId: string): boolean;
-    /** Alias for isAuthorized (used by polling loop). */
-    isLockConfirmed(sellerPeerId: string): boolean;
-    /** Check if the lock was explicitly rejected (not just never-contacted). */
-    isLockRejected(sellerPeerId: string): boolean;
-    /** Mark a peer as having rejected our spending auth. */
-    markRejected(sellerPeerId: string): void;
-    getSessionHistory(sellerPeerId: string): StoredChannel[];
-    deposit(amount: bigint): Promise<string>;
-    withdraw(amount: bigint): Promise<string>;
-    getBalance(): Promise<{
-        available: bigint;
-        reserved: bigint;
-    }>;
-}
+export * from '@antseed/buyer-core/buyer-payment-manager';
 //# sourceMappingURL=buyer-payment-manager.d.ts.map

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

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