@antseed/node 0.1.0

package/dist/payments/buyer-payment-manager.js

@@ -0,0 +1,280 @@
+import { randomBytes } from 'node:crypto';
+import { BaseEscrowClient } from './evm/escrow-client.js';
+import { identityToEvmWallet, identityToEvmAddress } from './evm/keypair.js';
+import { buildLockMessageHash, buildSettlementMessageHash, buildExtendLockMessageHash, signMessageEcdsa, buildAckMessage, signMessageEd25519, } from './evm/signatures.js';
+import { bytesToHex, hexToBytes } from '../utils/hex.js';
+import { debugLog, debugWarn } from '../utils/debug.js';
+/**
+ * Manages buyer-side bilateral payment sessions across seller connections.
+ *
+ * Handles the full lifecycle: lock initiation, receipt acknowledgement,
+ * top-up approval, and session settlement.
+ */
+export class BuyerPaymentManager {
+    _identity;
+    _signer;
+    _escrowClient;
+    _config;
+    _sessions = new Map();
+    constructor(identity, config) {
+        this._identity = identity;
+        this._config = config;
+        this._signer = identityToEvmWallet(identity);
+        this._escrowClient = new BaseEscrowClient({
+            rpcUrl: config.rpcUrl,
+            contractAddress: config.contractAddress,
+            usdcAddress: config.usdcAddress,
+        });
+    }
+    get signer() {
+        return this._signer;
+    }
+    /** @deprecated Use .signer instead */
+    get wallet() {
+        return this._signer;
+    }
+    /** Replace the signer at runtime (e.g. with a WalletConnect signer). */
+    setSigner(signer) {
+        this._signer = signer;
+    }
+    get escrowClient() {
+        return this._escrowClient;
+    }
+    /** Get a snapshot of all active sessions. */
+    getActiveSessions() {
+        return [...this._sessions.values()].filter((s) => s.status !== 'ended');
+    }
+    /** Get the session for a given seller peer, if it exists. */
+    getSession(sellerPeerId) {
+        return this._sessions.get(sellerPeerId);
+    }
+    // ── Lock initiation ─────────────────────────────────────────────
+    /**
+     * Generate a session ID, sign a lock authorization, and send it
+     * to the seller via PaymentMux.
+     */
+    async initiateLock(sellerPeerId, sellerEvmAddress, paymentMux, lockAmount) {
+        const amount = lockAmount ?? this._config.defaultLockAmountUSDC;
+        const amountBigInt = BigInt(amount);
+        // Generate a 32-byte session ID as 0x-prefixed hex (bytes32)
+        const sessionIdBytes = randomBytes(32);
+        const sessionId = '0x' + sessionIdBytes.toString('hex');
+        debugLog(`[BuyerPayment] Initiating lock: session=${sessionId.slice(0, 18)}... seller=${sellerPeerId.slice(0, 12)}... amount=${amount}`);
+        // Sign the lock message with ECDSA (for on-chain verification)
+        const messageHash = buildLockMessageHash(sessionId, sellerEvmAddress, amountBigInt);
+        const buyerSig = await signMessageEcdsa(this._signer, messageHash);
+        // Store session state
+        const now = Date.now();
+        const session = {
+            sessionId,
+            sellerPeerId,
+            sellerEvmAddress,
+            lockedAmount: amountBigInt,
+            status: 'pending',
+            txSignature: null,
+            lastRunningTotal: 0n,
+            lastRequestCount: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this._sessions.set(sellerPeerId, session);
+        // Send the lock auth message
+        paymentMux.sendSessionLockAuth({
+            sessionId,
+            lockedAmount: amount,
+            buyerSig,
+        });
+        return sessionId;
+    }
+    // ── Lock confirmation / rejection handlers ──────────────────────
+    /**
+     * Called when the seller confirms the lock was committed on-chain.
+     */
+    handleLockConfirm(sellerPeerId, payload) {
+        const session = this._sessions.get(sellerPeerId);
+        if (!session) {
+            debugWarn(`[BuyerPayment] Lock confirm for unknown seller: ${sellerPeerId.slice(0, 12)}...`);
+            return;
+        }
+        if (session.sessionId !== payload.sessionId) {
+            debugWarn(`[BuyerPayment] Lock confirm session mismatch: expected=${session.sessionId.slice(0, 18)}... got=${payload.sessionId.slice(0, 18)}...`);
+            return;
+        }
+        session.status = 'confirmed';
+        session.txSignature = payload.txSignature;
+        session.updatedAt = Date.now();
+        debugLog(`[BuyerPayment] Lock confirmed: session=${session.sessionId.slice(0, 18)}... tx=${payload.txSignature.slice(0, 12)}...`);
+    }
+    /**
+     * Called when the seller rejects the lock.
+     */
+    handleLockReject(sellerPeerId, payload) {
+        const session = this._sessions.get(sellerPeerId);
+        if (!session) {
+            debugWarn(`[BuyerPayment] Lock reject for unknown seller: ${sellerPeerId.slice(0, 12)}...`);
+            return;
+        }
+        debugWarn(`[BuyerPayment] Lock rejected: session=${session.sessionId.slice(0, 18)}... reason=${payload.reason}`);
+        this._sessions.delete(sellerPeerId);
+    }
+    // ── Receipt handling ────────────────────────────────────────────
+    /**
+     * Handle a running-total receipt from the seller.
+     * If autoAck is enabled, automatically counter-sign and send BuyerAck.
+     */
+    async handleSellerReceipt(sellerPeerId, receipt, paymentMux) {
+        const session = this._sessions.get(sellerPeerId);
+        if (!session) {
+            debugWarn(`[BuyerPayment] Receipt for unknown seller: ${sellerPeerId.slice(0, 12)}...`);
+            return;
+        }
+        if (session.status === 'confirmed') {
+            session.status = 'active';
+        }
+        // Update running total
+        session.lastRunningTotal = BigInt(receipt.runningTotal);
+        session.lastRequestCount = receipt.requestCount;
+        session.updatedAt = Date.now();
+        debugLog(`[BuyerPayment] Receipt: session=${session.sessionId.slice(0, 18)}... total=${receipt.runningTotal} count=${receipt.requestCount}`);
+        const autoAck = this._config.autoAck ?? true;
+        if (autoAck) {
+            // Build ack message and sign with Ed25519
+            const sessionIdBytes = hexToBytes(session.sessionId.startsWith('0x') ? session.sessionId.slice(2) : session.sessionId);
+            const ackMsg = buildAckMessage(sessionIdBytes, BigInt(receipt.runningTotal), receipt.requestCount);
+            const sigBytes = await signMessageEd25519(this._identity, ackMsg);
+            const buyerSig = bytesToHex(sigBytes);
+            paymentMux.sendBuyerAck({
+                sessionId: session.sessionId,
+                runningTotal: receipt.runningTotal,
+                requestCount: receipt.requestCount,
+                buyerSig,
+            });
+            debugLog(`[BuyerPayment] Auto-ack sent for session=${session.sessionId.slice(0, 18)}...`);
+        }
+    }
+    // ── Top-up handling ─────────────────────────────────────────────
+    /**
+     * Handle a top-up request from the seller.
+     * If autoTopUp is enabled and budget allows, sign and send TopUpAuth.
+     * Otherwise, end the session.
+     */
+    async handleTopUpRequest(sellerPeerId, request, paymentMux) {
+        const session = this._sessions.get(sellerPeerId);
+        if (!session) {
+            debugWarn(`[BuyerPayment] Top-up for unknown seller: ${sellerPeerId.slice(0, 12)}...`);
+            return;
+        }
+        const additionalAmount = BigInt(request.additionalAmount);
+        const maxBudget = BigInt(this._config.maxSessionBudgetUSDC ?? '10000000');
+        const newTotal = session.lockedAmount + additionalAmount;
+        const autoTopUp = this._config.autoTopUp ?? true;
+        debugLog(`[BuyerPayment] Top-up request: session=${session.sessionId.slice(0, 18)}... additional=${request.additionalAmount} newTotal=${newTotal}`);
+        if (autoTopUp && newTotal <= maxBudget) {
+            // Check on-chain balance
+            const buyerAddr = identityToEvmAddress(this._identity);
+            const account = await this._escrowClient.getBuyerAccount(buyerAddr);
+            if (account.available >= additionalAmount) {
+                // Sign extend-lock authorization
+                const messageHash = buildExtendLockMessageHash(session.sessionId, session.sellerEvmAddress, additionalAmount);
+                const buyerSig = await signMessageEcdsa(this._signer, messageHash);
+                session.lockedAmount = newTotal;
+                session.updatedAt = Date.now();
+                paymentMux.sendTopUpAuth({
+                    sessionId: session.sessionId,
+                    additionalAmount: request.additionalAmount,
+                    buyerSig,
+                });
+                debugLog(`[BuyerPayment] Top-up authorized: session=${session.sessionId.slice(0, 18)}...`);
+                return;
+            }
+            debugWarn(`[BuyerPayment] Insufficient balance for top-up. Available=${account.available}, requested=${additionalAmount}`);
+        }
+        // Cannot or will not top up — end the session
+        debugLog(`[BuyerPayment] Declining top-up, ending session=${session.sessionId.slice(0, 18)}...`);
+        await this.endSession(sellerPeerId, paymentMux, 80);
+    }
+    // ── Session end ─────────────────────────────────────────────────
+    /**
+     * End a session with the given seller. Signs a settlement message
+     * with ECDSA and sends SessionEnd.
+     */
+    async endSession(sellerPeerId, paymentMux, score = 80) {
+        const session = this._sessions.get(sellerPeerId);
+        if (!session) {
+            debugWarn(`[BuyerPayment] Cannot end session for unknown seller: ${sellerPeerId.slice(0, 12)}...`);
+            return;
+        }
+        if (session.status === 'ending' || session.status === 'ended') {
+            return;
+        }
+        session.status = 'ending';
+        session.updatedAt = Date.now();
+        debugLog(`[BuyerPayment] Ending session=${session.sessionId.slice(0, 18)}... total=${session.lastRunningTotal} score=${score}`);
+        // Sign settlement message with ECDSA
+        const messageHash = buildSettlementMessageHash(session.sessionId, session.lastRunningTotal, score);
+        const buyerSig = await signMessageEcdsa(this._signer, messageHash);
+        paymentMux.sendSessionEnd({
+            sessionId: session.sessionId,
+            runningTotal: session.lastRunningTotal.toString(),
+            requestCount: session.lastRequestCount,
+            score,
+            buyerSig,
+        });
+        session.status = 'ended';
+        session.updatedAt = Date.now();
+        debugLog(`[BuyerPayment] Session ended: ${session.sessionId.slice(0, 18)}...`);
+    }
+    // ── Escrow operations ───────────────────────────────────────────
+    /**
+     * Deposit USDC into the escrow contract.
+     * @param amount Amount in USDC base units (6 decimals).
+     */
+    async deposit(amount) {
+        debugLog(`[BuyerPayment] Depositing ${amount} to escrow`);
+        return this._escrowClient.deposit(this._signer, amount);
+    }
+    /**
+     * Withdraw USDC from the escrow contract.
+     * @param amount Amount in USDC base units (6 decimals).
+     */
+    async withdraw(amount) {
+        debugLog(`[BuyerPayment] Withdrawing ${amount} from escrow`);
+        return this._escrowClient.withdraw(this._signer, amount);
+    }
+    /**
+     * Get the buyer's on-chain escrow balance.
+     */
+    async getBalance() {
+        const buyerAddr = identityToEvmAddress(this._identity);
+        return this._escrowClient.getBuyerAccount(buyerAddr);
+    }
+    // ── Dispute helpers ─────────────────────────────────────────────
+    /**
+     * Release an expired lock (buyer reclaims funds).
+     */
+    async releaseExpiredLock(sessionId) {
+        debugLog(`[BuyerPayment] Releasing expired lock: session=${sessionId.slice(0, 18)}...`);
+        return this._escrowClient.releaseExpiredLock(this._signer, sessionId);
+    }
+    /**
+     * Respond to a dispute opened by the seller.
+     */
+    async respondToDispute(sessionId) {
+        debugLog(`[BuyerPayment] Responding to dispute: session=${sessionId.slice(0, 18)}...`);
+        return this._escrowClient.respondDispute(this._signer, sessionId);
+    }
+    /**
+     * Check if a session lock has been confirmed (for polling).
+     */
+    isLockConfirmed(sellerPeerId) {
+        const session = this._sessions.get(sellerPeerId);
+        return session?.status === 'confirmed' || session?.status === 'active';
+    }
+    /**
+     * Check if a session lock has been rejected (for polling).
+     */
+    isLockRejected(sellerPeerId) {
+        return !this._sessions.has(sellerPeerId);
+    }
+}
+//# sourceMappingURL=buyer-payment-manager.js.map

package/dist/payments/buyer-payment-manager.js.map

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

package/dist/payments/disputes.d.ts

@@ -0,0 +1,18 @@
+import type { PeerId } from '../types/peer.js';
+import type { UsageReceipt } from '../types/metering.js';
+import type { PaymentDispute } from './types.js';
+export declare const DISPUTE_TIMEOUT_MS: number;
+export declare function createDispute(channel: {
+    channelId: string;
+    sessionId: string;
+}, initiatorPeerId: PeerId, reason: string, buyerReceipts: UsageReceipt[], sellerReceipts: UsageReceipt[]): PaymentDispute;
+export declare function detectDiscrepancy(buyerReceipts: UsageReceipt[], sellerReceipts: UsageReceipt[], thresholdPercent: number): {
+    discrepancyDetected: boolean;
+    buyerTotal: number;
+    sellerTotal: number;
+    diffPercent: number;
+};
+export declare function resolveDispute(dispute: PaymentDispute, resolution: string): PaymentDispute;
+export declare function isDisputeExpired(dispute: PaymentDispute): boolean;
+export declare function calculateDisputedAmount(buyerReceipts: UsageReceipt[], sellerReceipts: UsageReceipt[]): number;
+//# sourceMappingURL=disputes.d.ts.map

package/dist/payments/disputes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.d.ts","sourceRoot":"","sources":["../../src/payments/disputes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAEtD,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACjD,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,YAAY,EAAE,EAC7B,cAAc,EAAE,YAAY,EAAE,GAC7B,cAAc,CAchB;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,YAAY,EAAE,EAC7B,cAAc,EAAE,YAAY,EAAE,EAC9B,gBAAgB,EAAE,MAAM,GACvB;IAAE,mBAAmB,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAahG;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GACjB,cAAc,CAOhB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAEjE;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,YAAY,EAAE,EAC7B,cAAc,EAAE,YAAY,EAAE,GAC7B,MAAM,CAIR"}

package/dist/payments/disputes.js

@@ -0,0 +1,47 @@
+import { randomUUID } from 'node:crypto';
+export const DISPUTE_TIMEOUT_MS = 72 * 60 * 60 * 1000;
+export function createDispute(channel, initiatorPeerId, reason, buyerReceipts, sellerReceipts) {
+    return {
+        disputeId: randomUUID(),
+        channelId: channel.channelId,
+        sessionId: channel.sessionId,
+        initiatorPeerId,
+        reason,
+        status: 'open',
+        buyerReceipts,
+        sellerReceipts,
+        createdAt: Date.now(),
+        resolvedAt: null,
+        resolution: null,
+    };
+}
+export function detectDiscrepancy(buyerReceipts, sellerReceipts, thresholdPercent) {
+    const buyerTotal = buyerReceipts.reduce((sum, r) => sum + r.tokens.totalTokens, 0);
+    const sellerTotal = sellerReceipts.reduce((sum, r) => sum + r.tokens.totalTokens, 0);
+    const max = Math.max(buyerTotal, sellerTotal);
+    const diffPercent = max === 0 ? 0 : (Math.abs(buyerTotal - sellerTotal) / max) * 100;
+    const discrepancyDetected = diffPercent > thresholdPercent;
+    return {
+        discrepancyDetected,
+        buyerTotal,
+        sellerTotal,
+        diffPercent,
+    };
+}
+export function resolveDispute(dispute, resolution) {
+    return {
+        ...dispute,
+        status: 'resolved',
+        resolvedAt: Date.now(),
+        resolution,
+    };
+}
+export function isDisputeExpired(dispute) {
+    return Date.now() - dispute.createdAt > DISPUTE_TIMEOUT_MS;
+}
+export function calculateDisputedAmount(buyerReceipts, sellerReceipts) {
+    const buyerTotalUsd = buyerReceipts.reduce((sum, r) => sum + r.costCents, 0) / 100;
+    const sellerTotalUsd = sellerReceipts.reduce((sum, r) => sum + r.costCents, 0) / 100;
+    return Math.abs(buyerTotalUsd - sellerTotalUsd);
+}
+//# sourceMappingURL=disputes.js.map

package/dist/payments/disputes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.js","sourceRoot":"","sources":["../../src/payments/disputes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,MAAM,UAAU,aAAa,CAC3B,OAAiD,EACjD,eAAuB,EACvB,MAAc,EACd,aAA6B,EAC7B,cAA8B;IAE9B,OAAO;QACL,SAAS,EAAE,UAAU,EAAE;QACvB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe;QACf,MAAM;QACN,MAAM,EAAE,MAAM;QACd,aAAa;QACb,cAAc;QACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAA6B,EAC7B,cAA8B,EAC9B,gBAAwB;IAExB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACrF,MAAM,mBAAmB,GAAG,WAAW,GAAG,gBAAgB,CAAC;IAE3D,OAAO;QACL,mBAAmB;QACnB,UAAU;QACV,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,UAAkB;IAElB,OAAO;QACL,GAAG,OAAO;QACV,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,aAA6B,EAC7B,cAA8B;IAE9B,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;IACnF,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;IACrF,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC;AAClD,CAAC"}

package/dist/payments/evm/escrow-client.d.ts

@@ -0,0 +1,61 @@
+import { JsonRpcProvider, type AbstractSigner } from 'ethers';
+export interface BaseEscrowConfig {
+    /** Base JSON-RPC endpoint (e.g. http://127.0.0.1:8545 for anvil) */
+    rpcUrl: string;
+    /** Deployed AntseedEscrow contract address */
+    contractAddress: string;
+    /** USDC token contract address */
+    usdcAddress: string;
+    /** Confirmation commitment level (not used on EVM, reserved for future) */
+    commitment?: 'latest' | 'finalized';
+}
+export interface SessionInfo {
+    buyer: string;
+    seller: string;
+    lockedAmount: bigint;
+    status: number;
+    expiresAt: number;
+    settledAmount: bigint;
+    score: number;
+    disputeClaimedAmount: bigint;
+    disputeOpenedAt: number;
+    disputeBuyerResponded: boolean;
+}
+export interface ReputationInfo {
+    totalWeightedScore: bigint;
+    totalWeight: bigint;
+    sessionCount: number;
+    disputeCount: number;
+    weightedAverage: number;
+}
+export declare class BaseEscrowClient {
+    private readonly _provider;
+    private readonly _contractAddress;
+    private readonly _usdcAddress;
+    private readonly _nonceCursor;
+    constructor(config: BaseEscrowConfig);
+    get provider(): JsonRpcProvider;
+    get contractAddress(): string;
+    get usdcAddress(): string;
+    private _ensureConnected;
+    private reserveNonce;
+    private _prepareEscrowWrite;
+    deposit(signer: AbstractSigner, amount: bigint): Promise<string>;
+    withdraw(signer: AbstractSigner, amount: bigint): Promise<string>;
+    commitLock(seller: AbstractSigner, buyerAddr: string, sessionId: string, amount: bigint, buyerSig: string): Promise<string>;
+    extendLock(seller: AbstractSigner, sessionId: string, additionalAmount: bigint, buyerSig: string): Promise<string>;
+    settle(seller: AbstractSigner, sessionId: string, runningTotal: bigint, score: number, buyerSig: string): Promise<string>;
+    openDispute(caller: AbstractSigner, sessionId: string, claimedAmount: bigint): Promise<string>;
+    respondDispute(buyer: AbstractSigner, sessionId: string): Promise<string>;
+    resolveDispute(caller: AbstractSigner, sessionId: string): Promise<string>;
+    releaseExpiredLock(buyer: AbstractSigner, sessionId: string): Promise<string>;
+    getBuyerAccount(buyerAddr: string): Promise<{
+        deposited: bigint;
+        committed: bigint;
+        available: bigint;
+    }>;
+    getSession(sessionId: string): Promise<SessionInfo>;
+    getReputation(sellerAddr: string): Promise<ReputationInfo>;
+    getUSDCBalance(ownerAddr: string): Promise<bigint>;
+}
+//# sourceMappingURL=escrow-client.d.ts.map

package/dist/payments/evm/escrow-client.d.ts.map

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

package/dist/payments/evm/escrow-client.js

@@ -0,0 +1,170 @@
+import { Contract, JsonRpcProvider } from 'ethers';
+const ESCROW_ABI = [
+    // Deposit & Withdraw
+    'function deposit(uint256 amount) external',
+    'function withdraw(uint256 amount) external',
+    // Session lifecycle
+    'function commitLock(bytes32 sessionId, address buyer, uint256 amount, bytes calldata buyerSig) external',
+    'function extendLock(bytes32 sessionId, uint256 additionalAmount, bytes calldata buyerSig) external',
+    'function settle(bytes32 sessionId, uint256 runningTotal, uint8 score, bytes calldata buyerSig) external',
+    // Disputes
+    'function openDispute(bytes32 sessionId, uint256 claimedAmount) external',
+    'function respondDispute(bytes32 sessionId) external',
+    'function resolveDispute(bytes32 sessionId) external',
+    // Expired lock
+    'function releaseExpiredLock(bytes32 sessionId) external',
+    // View functions
+    'function buyers(address) external view returns (uint256 deposited, uint256 committed)',
+    'function sessions(bytes32) external view returns (address buyer, address seller, uint256 lockedAmount, uint8 status, uint64 expiresAt, uint256 settledAmount, uint8 score, uint256 disputeClaimedAmount, uint64 disputeOpenedAt, bool disputeBuyerResponded, bool exists)',
+    'function reputations(address) external view returns (uint256 totalWeightedScore, uint256 totalWeight, uint256 sessionCount, uint256 disputeCount)',
+];
+const ERC20_ABI = [
+    'function approve(address spender, uint256 amount) external returns (bool)',
+    'function balanceOf(address owner) external view returns (uint256)',
+    'function allowance(address owner, address spender) external view returns (uint256)',
+];
+export class BaseEscrowClient {
+    _provider;
+    _contractAddress;
+    _usdcAddress;
+    _nonceCursor = new Map();
+    constructor(config) {
+        this._provider = new JsonRpcProvider(config.rpcUrl);
+        this._contractAddress = config.contractAddress;
+        this._usdcAddress = config.usdcAddress;
+    }
+    get provider() { return this._provider; }
+    get contractAddress() { return this._contractAddress; }
+    get usdcAddress() { return this._usdcAddress; }
+    _ensureConnected(signer) {
+        if (signer.provider) {
+            return signer;
+        }
+        return signer.connect(this._provider);
+    }
+    async reserveNonce(address) {
+        const networkNonce = await this._provider.getTransactionCount(address, 'pending');
+        const cachedNext = this._nonceCursor.get(address);
+        const nonce = cachedNext === undefined ? networkNonce : Math.max(networkNonce, cachedNext);
+        this._nonceCursor.set(address, nonce + 1);
+        return nonce;
+    }
+    async _prepareEscrowWrite(signer) {
+        const connected = this._ensureConnected(signer);
+        const signerAddress = await connected.getAddress();
+        const nonce = await this.reserveNonce(signerAddress);
+        const contract = new Contract(this._contractAddress, ESCROW_ABI, connected);
+        return { contract, nonce };
+    }
+    async deposit(signer, amount) {
+        const connected = this._ensureConnected(signer);
+        const signerAddress = await connected.getAddress();
+        const usdc = new Contract(this._usdcAddress, ERC20_ABI, connected);
+        const approveNonce = await this.reserveNonce(signerAddress);
+        const approveTx = await usdc.getFunction('approve')(this._contractAddress, amount, { nonce: approveNonce });
+        await approveTx.wait();
+        const contract = new Contract(this._contractAddress, ESCROW_ABI, connected);
+        const depositNonce = await this.reserveNonce(signerAddress);
+        const tx = await contract.getFunction('deposit')(amount, { nonce: depositNonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async withdraw(signer, amount) {
+        const { contract, nonce } = await this._prepareEscrowWrite(signer);
+        const tx = await contract.getFunction('withdraw')(amount, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async commitLock(seller, buyerAddr, sessionId, amount, buyerSig) {
+        const { contract, nonce } = await this._prepareEscrowWrite(seller);
+        const tx = await contract.getFunction('commitLock')(sessionId, buyerAddr, amount, buyerSig, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async extendLock(seller, sessionId, additionalAmount, buyerSig) {
+        const { contract, nonce } = await this._prepareEscrowWrite(seller);
+        const tx = await contract.getFunction('extendLock')(sessionId, additionalAmount, buyerSig, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async settle(seller, sessionId, runningTotal, score, buyerSig) {
+        const { contract, nonce } = await this._prepareEscrowWrite(seller);
+        const tx = await contract.getFunction('settle')(sessionId, runningTotal, score, buyerSig, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async openDispute(caller, sessionId, claimedAmount) {
+        const { contract, nonce } = await this._prepareEscrowWrite(caller);
+        const tx = await contract.getFunction('openDispute')(sessionId, claimedAmount, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async respondDispute(buyer, sessionId) {
+        const { contract, nonce } = await this._prepareEscrowWrite(buyer);
+        const tx = await contract.getFunction('respondDispute')(sessionId, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async resolveDispute(caller, sessionId) {
+        const { contract, nonce } = await this._prepareEscrowWrite(caller);
+        const tx = await contract.getFunction('resolveDispute')(sessionId, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async releaseExpiredLock(buyer, sessionId) {
+        const { contract, nonce } = await this._prepareEscrowWrite(buyer);
+        const tx = await contract.getFunction('releaseExpiredLock')(sessionId, { nonce });
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    async getBuyerAccount(buyerAddr) {
+        const contract = new Contract(this._contractAddress, ESCROW_ABI, this._provider);
+        const result = await contract.getFunction('buyers')(buyerAddr);
+        const deposited = result[0];
+        const committed = result[1];
+        return {
+            deposited,
+            committed,
+            available: deposited - committed,
+        };
+    }
+    async getSession(sessionId) {
+        const contract = new Contract(this._contractAddress, ESCROW_ABI, this._provider);
+        const result = await contract.getFunction('sessions')(sessionId);
+        return {
+            buyer: result[0],
+            seller: result[1],
+            lockedAmount: result[2],
+            status: Number(result[3]),
+            expiresAt: Number(result[4]),
+            settledAmount: result[5],
+            score: Number(result[6]),
+            disputeClaimedAmount: result[7],
+            disputeOpenedAt: Number(result[8]),
+            disputeBuyerResponded: result[9],
+        };
+    }
+    async getReputation(sellerAddr) {
+        const contract = new Contract(this._contractAddress, ESCROW_ABI, this._provider);
+        const result = await contract.getFunction('reputations')(sellerAddr);
+        const totalWeightedScore = result[0];
+        const totalWeight = result[1];
+        const sessionCount = Number(result[2]);
+        const disputeCount = Number(result[3]);
+        const weightedAverage = totalWeight > 0n
+            ? Number(totalWeightedScore / totalWeight)
+            : 50;
+        return {
+            totalWeightedScore,
+            totalWeight,
+            sessionCount,
+            disputeCount,
+            weightedAverage,
+        };
+    }
+    async getUSDCBalance(ownerAddr) {
+        const usdc = new Contract(this._usdcAddress, ERC20_ABI, this._provider);
+        return usdc.getFunction('balanceOf')(ownerAddr);
+    }
+}
+//# sourceMappingURL=escrow-client.js.map

package/dist/payments/evm/escrow-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow-client.js","sourceRoot":"","sources":["../../../src/payments/evm/escrow-client.ts"],"names":[],"mappings":"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"}

package/dist/payments/evm/keypair.d.ts

@@ -0,0 +1,21 @@
+import { Wallet } from 'ethers';
+import type { Identity } from '../../p2p/identity.js';
+/**
+ * Derive a secp256k1 private key from the Ed25519 identity seed.
+ * Domain-separated to ensure the derived key is independent from the Ed25519 key.
+ *
+ * Derivation: keccak256(ed25519_seed || "evm-payment-key") → secp256k1 private key
+ *
+ * The Ed25519 seed (identity.privateKey) is 32 bytes. We append a fixed
+ * domain separator string to prevent the derived key from colliding with
+ * any other use of the same seed. keccak256 produces a 32-byte output
+ * which is a valid secp256k1 private key (the probability of hitting an
+ * invalid key is astronomically low: ~1/2^128).
+ */
+export declare function identityToEvmWallet(identity: Identity): Wallet;
+/**
+ * Get the EVM address (0x-prefixed hex) for a Antseed Identity.
+ * This is the address that appears on-chain as the buyer or seller.
+ */
+export declare function identityToEvmAddress(identity: Identity): string;
+//# sourceMappingURL=keypair.d.ts.map