@antseed/node 0.2.93 → 0.2.95

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

@@ -0,0 +1,350 @@
+import { AbiCoder, keccak256, verifyTypedData } from 'ethers';
+import { peerIdToAddress } from '../types/peer.js';
+import { debugLog, debugWarn } from '../utils/debug.js';
+import { FreeUsageClient } from './evm/free-usage-client.js';
+import { computeFreeUsageChannelId, FREE_USAGE_AUTH_TYPES, FREE_USAGE_METADATA_VERSION, FREE_USAGE_OPEN_TYPES, makeFreeUsageDomain, } from './evm/signatures.js';
+const FREE_USAGE_METADATA_ABI = [
+    'uint256',
+    'uint256',
+    'uint256',
+    'uint256',
+    'tuple(bytes32 serviceId,uint256 cumulativeAmount,uint256 cumulativeInputTokens,uint256 cumulativeCachedInputTokens,uint256 cumulativeOutputTokens,uint256 cumulativeRequestCount)[]',
+];
+const DEFAULT_RECORD_BATCH_SIZE = 16;
+const DEFAULT_RECORD_FLUSH_INTERVAL_MS = 10_000;
+function normalizeTokenCount(value) {
+    if (!Number.isFinite(value) || value <= 0)
+        return 0n;
+    return BigInt(Math.trunc(value));
+}
+export class SellerFreeUsageManager {
+    _signer;
+    _client;
+    _domain;
+    _sellerEvmAddr;
+    _recordBatchSize;
+    _recordFlushIntervalMs;
+    _sessions = new Map();
+    _buyerLocks = new Map();
+    constructor(identity, config) {
+        this._signer = identity.wallet;
+        this._sellerEvmAddr = identity.wallet.address;
+        this._domain = makeFreeUsageDomain(config.chainId, config.freeUsageContractAddress);
+        this._recordBatchSize = Math.max(1, Math.trunc(config.recordBatchSize ?? DEFAULT_RECORD_BATCH_SIZE));
+        this._recordFlushIntervalMs = Math.max(1, Math.trunc(config.recordFlushIntervalMs ?? DEFAULT_RECORD_FLUSH_INTERVAL_MS));
+        this._client = new FreeUsageClient({
+            rpcUrl: config.rpcUrl,
+            ...(config.fallbackRpcUrls ? { fallbackRpcUrls: config.fallbackRpcUrls } : {}),
+            contractAddress: config.freeUsageContractAddress,
+            evmChainId: config.chainId,
+        });
+    }
+    get client() {
+        return this._client;
+    }
+    handleOpen(buyerPeerId, payload, paymentMux) {
+        const lock = (this._buyerLocks.get(buyerPeerId) ?? Promise.resolve()).then(async () => {
+            await this._handleOpenInner(buyerPeerId, payload, paymentMux);
+        });
+        this._buyerLocks.set(buyerPeerId, lock.catch(() => { }));
+        void lock.catch((err) => {
+            debugWarn(`[SellerFreeUsage] Open failed for ${buyerPeerId.slice(0, 12)}...: ${err instanceof Error ? err.message : err}`);
+        });
+    }
+    handleAuth(buyerPeerId, payload, paymentMux) {
+        const lock = (this._buyerLocks.get(buyerPeerId) ?? Promise.resolve()).then(async () => {
+            await this._handleAuthInner(buyerPeerId, payload, paymentMux);
+        });
+        this._buyerLocks.set(buyerPeerId, lock.catch(() => { }));
+        void lock.catch((err) => {
+            debugWarn(`[SellerFreeUsage] UsageAuth failed for ${buyerPeerId.slice(0, 12)}...: ${err instanceof Error ? err.message : err}`);
+        });
+    }
+    onPeerDisconnect(buyerPeerId) {
+        const session = this._sessions.get(buyerPeerId);
+        if (session) {
+            this._clearFlushTimer(session);
+            session.closeRequested = true;
+            if (session.pendingRecord || session.flushPromise) {
+                void this._flushPendingRecord(buyerPeerId, session).finally(() => {
+                    if (this._sessions.get(buyerPeerId) === session) {
+                        this._sessions.delete(buyerPeerId);
+                    }
+                });
+            }
+            else {
+                this._sessions.delete(buyerPeerId);
+            }
+        }
+        else {
+            this._sessions.delete(buyerPeerId);
+        }
+        this._buyerLocks.delete(buyerPeerId);
+    }
+    async flushAllPendingRecords() {
+        await Promise.all([...this._sessions.entries()].map(([buyerPeerId, session]) => {
+            this._clearFlushTimer(session);
+            return this._flushPendingRecord(buyerPeerId, session);
+        }));
+    }
+    reportUsageRequest(buyerPeerId, paymentMux, usage) {
+        const session = this._sessions.get(buyerPeerId);
+        if (!session) {
+            debugWarn(`[SellerFreeUsage] Cannot request usage auth for ${buyerPeerId.slice(0, 12)}...: no free usage channel`);
+            return;
+        }
+        const nextSequence = (session.requestedSequence > session.acceptedSequence
+            ? session.requestedSequence
+            : session.acceptedSequence) + 1n;
+        const payload = {
+            channelId: session.channelId,
+            requiredSequence: nextSequence.toString(),
+            currentAcceptedSequence: session.acceptedSequence.toString(),
+            ...(usage.requestId ? { requestId: usage.requestId } : {}),
+            inputTokens: normalizeTokenCount(usage.inputTokens).toString(),
+            outputTokens: normalizeTokenCount(usage.outputTokens).toString(),
+            ...(usage.service ? { service: usage.service } : {}),
+        };
+        try {
+            paymentMux.sendNeedFreeUsageAuth(payload);
+            const inputTokens = normalizeTokenCount(usage.inputTokens);
+            const outputTokens = normalizeTokenCount(usage.outputTokens);
+            session.requestedSequence = nextSequence;
+            session.requestedInputTokens += inputTokens;
+            session.requestedOutputTokens += outputTokens;
+            session.requestedRequestCount += 1n;
+            session.expectedUsageBySequence.set(nextSequence.toString(), {
+                cumulativeInputTokens: session.requestedInputTokens,
+                cumulativeOutputTokens: session.requestedOutputTokens,
+                cumulativeRequestCount: session.requestedRequestCount,
+            });
+            debugLog(`[SellerFreeUsage] NeedFreeUsageAuth sent to ${buyerPeerId.slice(0, 12)}... ` +
+                `channel=${session.channelId.slice(0, 18)}... sequence=${nextSequence}`);
+        }
+        catch (err) {
+            debugWarn(`[SellerFreeUsage] NeedFreeUsageAuth send failed: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    async _handleOpenInner(buyerPeerId, payload, paymentMux) {
+        const buyerEvmAddr = peerIdToAddress(buyerPeerId);
+        const expectedChannelId = computeFreeUsageChannelId(buyerEvmAddr, this._sellerEvmAddr, payload.salt);
+        if (expectedChannelId.toLowerCase() !== payload.channelId.toLowerCase()) {
+            throw new Error(`channelId mismatch expected=${expectedChannelId} got=${payload.channelId}`);
+        }
+        if (payload.deadline <= Math.floor(Date.now() / 1000)) {
+            throw new Error('free usage open expired');
+        }
+        const recovered = verifyTypedData(this._domain, FREE_USAGE_OPEN_TYPES, { channelId: payload.channelId, deadline: BigInt(payload.deadline) }, payload.openSig);
+        if (recovered.toLowerCase() !== buyerEvmAddr.toLowerCase()) {
+            throw new Error(`invalid FreeUsageOpen signer recovered=${recovered} expected=${buyerEvmAddr}`);
+        }
+        const openPromise = this._openOnChain(buyerEvmAddr, payload);
+        const session = {
+            channelId: payload.channelId,
+            buyerEvmAddr,
+            salt: payload.salt,
+            deadline: payload.deadline,
+            acceptedSequence: 0n,
+            requestedSequence: 0n,
+            requestedInputTokens: 0n,
+            requestedOutputTokens: 0n,
+            requestedRequestCount: 0n,
+            expectedUsageBySequence: new Map(),
+            openPromise,
+            pendingRecord: null,
+            recordsSinceFlush: 0,
+            flushTimer: null,
+            flushPromise: null,
+            closeRequested: false,
+        };
+        this._sessions.set(buyerPeerId, session);
+        try {
+            await openPromise;
+        }
+        catch (err) {
+            if (this._sessions.get(buyerPeerId) === session) {
+                this._sessions.delete(buyerPeerId);
+            }
+            throw err;
+        }
+        paymentMux.sendFreeUsageAck({ channelId: payload.channelId, acceptedSequence: '0' });
+        debugLog(`[SellerFreeUsage] Open reported on-chain channel=${payload.channelId.slice(0, 18)}...`);
+    }
+    async _openOnChain(buyerEvmAddr, payload) {
+        try {
+            await this._client.open(this._signer, buyerEvmAddr, payload.salt, BigInt(payload.deadline), payload.openSig);
+        }
+        catch (err) {
+            const existing = await this._tryGetExistingSession(payload.channelId);
+            if (existing
+                && existing.status === 1
+                && existing.buyer.toLowerCase() === buyerEvmAddr.toLowerCase()
+                && existing.seller.toLowerCase() === this._sellerEvmAddr.toLowerCase()) {
+                return;
+            }
+            throw err;
+        }
+    }
+    async _handleAuthInner(buyerPeerId, payload, paymentMux) {
+        const session = this._sessions.get(buyerPeerId);
+        if (!session || session.channelId.toLowerCase() !== payload.channelId.toLowerCase()) {
+            throw new Error(`unknown free usage channel ${payload.channelId}`);
+        }
+        const sequence = BigInt(payload.sequence);
+        if (sequence <= session.acceptedSequence) {
+            paymentMux.sendFreeUsageAck({
+                channelId: payload.channelId,
+                acceptedSequence: session.acceptedSequence.toString(),
+            });
+            return;
+        }
+        const metadataHash = keccak256(payload.metadata);
+        if (metadataHash.toLowerCase() !== payload.metadataHash.toLowerCase()) {
+            throw new Error('metadataHash mismatch');
+        }
+        const sequenceKey = sequence.toString();
+        const expectedUsage = session.expectedUsageBySequence.get(sequenceKey);
+        if (!expectedUsage) {
+            throw new Error(`unexpected free usage sequence ${sequence}`);
+        }
+        // The seller enforces aggregate counters it measured; per-service tuples
+        // remain buyer-attributed audit metadata.
+        const signedUsage = this._decodeFreeUsageMetadata(payload.metadata);
+        const payloadInputTokens = BigInt(payload.cumulativeInputTokens);
+        const payloadOutputTokens = BigInt(payload.cumulativeOutputTokens);
+        if (payloadInputTokens !== signedUsage.cumulativeInputTokens
+            || payloadOutputTokens !== signedUsage.cumulativeOutputTokens
+            || signedUsage.cumulativeInputTokens !== expectedUsage.cumulativeInputTokens
+            || signedUsage.cumulativeOutputTokens !== expectedUsage.cumulativeOutputTokens
+            || signedUsage.cumulativeRequestCount !== expectedUsage.cumulativeRequestCount) {
+            throw new Error(`free usage totals mismatch sequence=${sequence} ` +
+                `expected(in=${expectedUsage.cumulativeInputTokens},out=${expectedUsage.cumulativeOutputTokens},requests=${expectedUsage.cumulativeRequestCount}) ` +
+                `got(in=${signedUsage.cumulativeInputTokens},out=${signedUsage.cumulativeOutputTokens},requests=${signedUsage.cumulativeRequestCount})`);
+        }
+        const recovered = verifyTypedData(this._domain, FREE_USAGE_AUTH_TYPES, {
+            channelId: payload.channelId,
+            sequence,
+            metadataHash: payload.metadataHash,
+            deadline: BigInt(payload.deadline),
+        }, payload.usageSig);
+        if (recovered.toLowerCase() !== session.buyerEvmAddr.toLowerCase()) {
+            throw new Error(`invalid FreeUsageAuth signer recovered=${recovered} expected=${session.buyerEvmAddr}`);
+        }
+        session.pendingRecord = {
+            sequence,
+            metadata: payload.metadata,
+            deadline: BigInt(payload.deadline),
+            usageSig: payload.usageSig,
+        };
+        session.recordsSinceFlush += 1;
+        session.acceptedSequence = sequence;
+        for (const key of session.expectedUsageBySequence.keys()) {
+            if (BigInt(key) <= sequence)
+                session.expectedUsageBySequence.delete(key);
+        }
+        paymentMux.sendFreeUsageAck({
+            channelId: payload.channelId,
+            acceptedSequence: sequence.toString(),
+        });
+        this._scheduleRecordFlush(buyerPeerId, session);
+        debugLog(`[SellerFreeUsage] Usage auth accepted channel=${payload.channelId.slice(0, 18)}... ` +
+            `sequence=${sequence}`);
+    }
+    _scheduleRecordFlush(buyerPeerId, session, opts = {}) {
+        if (!session.pendingRecord || session.flushPromise)
+            return;
+        if (!opts.retry && session.recordsSinceFlush >= this._recordBatchSize) {
+            this._clearFlushTimer(session);
+            void this._flushPendingRecord(buyerPeerId, session);
+            return;
+        }
+        if (session.flushTimer)
+            return;
+        session.flushTimer = setTimeout(() => {
+            session.flushTimer = null;
+            void this._flushPendingRecord(buyerPeerId, session);
+        }, this._recordFlushIntervalMs);
+        session.flushTimer.unref?.();
+    }
+    _clearFlushTimer(session) {
+        if (!session.flushTimer)
+            return;
+        clearTimeout(session.flushTimer);
+        session.flushTimer = null;
+    }
+    _flushPendingRecord(buyerPeerId, session) {
+        if (!session.pendingRecord)
+            return Promise.resolve();
+        if (session.flushPromise)
+            return session.flushPromise;
+        let promise;
+        promise = (async () => {
+            const flushed = await this._doFlushPendingRecord(buyerPeerId, session);
+            if (session.flushPromise === promise) {
+                session.flushPromise = null;
+            }
+            if (session.pendingRecord && !session.closeRequested) {
+                this._scheduleRecordFlush(buyerPeerId, session, flushed ? {} : { retry: true });
+            }
+        })();
+        session.flushPromise = promise;
+        return promise;
+    }
+    async _doFlushPendingRecord(buyerPeerId, session) {
+        const record = session.pendingRecord;
+        if (!record)
+            return true;
+        this._clearFlushTimer(session);
+        try {
+            await session.openPromise;
+            const closeRequested = session.closeRequested;
+            if (closeRequested) {
+                await this._client.close(this._signer, session.channelId, record.sequence, record.metadata, record.deadline, record.usageSig);
+            }
+            else {
+                await this._client.record(this._signer, session.channelId, record.sequence, record.metadata, record.deadline, record.usageSig);
+            }
+            if (!closeRequested && session.closeRequested) {
+                await this._client.close(this._signer, session.channelId, record.sequence, record.metadata, record.deadline, record.usageSig);
+            }
+            const pending = session.pendingRecord;
+            if (!pending || pending.sequence <= record.sequence) {
+                session.pendingRecord = null;
+                session.recordsSinceFlush = 0;
+            }
+            else {
+                const delta = pending.sequence - record.sequence;
+                session.recordsSinceFlush = Number(delta > BigInt(Number.MAX_SAFE_INTEGER) ? BigInt(Number.MAX_SAFE_INTEGER) : delta);
+            }
+            debugLog(`[SellerFreeUsage] Usage ${session.closeRequested ? 'closed' : 'reported'} on-chain channel=${session.channelId.slice(0, 18)}... ` +
+                `sequence=${record.sequence}`);
+            return true;
+        }
+        catch (err) {
+            debugWarn(`[SellerFreeUsage] Deferred record failed for ${buyerPeerId.slice(0, 12)}... ` +
+                `channel=${session.channelId.slice(0, 18)}... sequence=${record.sequence}: ` +
+                `${err instanceof Error ? err.message : err}`);
+            return false;
+        }
+    }
+    async _tryGetExistingSession(channelId) {
+        try {
+            return await this._client.getSession(channelId);
+        }
+        catch {
+            return null;
+        }
+    }
+    _decodeFreeUsageMetadata(metadata) {
+        const [version, inputTokens, outputTokens, requestCount] = AbiCoder.defaultAbiCoder().decode(FREE_USAGE_METADATA_ABI, metadata);
+        if (BigInt(version) !== FREE_USAGE_METADATA_VERSION) {
+            throw new Error(`unsupported free usage metadata version ${version}`);
+        }
+        return {
+            cumulativeInputTokens: BigInt(inputTokens),
+            cumulativeOutputTokens: BigInt(outputTokens),
+            cumulativeRequestCount: BigInt(requestCount),
+        };
+    }
+}
+//# sourceMappingURL=seller-free-usage-manager.js.map

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

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

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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"}

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

@@ -3,6 +3,7 @@ import { ChannelsClient } from './evm/channels-client.js';
 import { SPENDING_AUTH_TYPES, RESERVE_AUTH_TYPES, makeChannelsDomain, encodeMetadata, ZERO_METADATA, } from './evm/signatures.js';
 import { debugLog, debugWarn } from '../utils/debug.js';
 import { peerIdToAddress } from '../types/peer.js';
+import { CHANNEL_ROLE, CHANNEL_STATUS } from './channel-store.js';
 import { classifyOnChainChannel, matchesChannelParties } from './channel-session-state.js';
 /** Default minimum budget per request: $0.50 USDC (base units). */
 const DEFAULT_MIN_BUDGET_PER_REQUEST = '500000';
@@ -101,7 +102,7 @@ export class SellerPaymentManager {
             ? BigInt(config.minSettleDelta)
             : DEFAULT_MIN_SETTLE_DELTA;
         // Hydrate from persisted channels
-        const activeChannels = this._channelStore.getActiveChannels('seller');
+        const activeChannels = this._channelStore.getActiveChannels(CHANNEL_ROLE.SELLER);
         for (const channel of activeChannels) {
             this._activeBuyers.add(channel.peerId);
             this._hydratedChannelIds.add(channel.sessionId);
@@ -129,7 +130,7 @@ export class SellerPaymentManager {
      * Must be called after construction (async, cannot run in constructor).
      */
     async validateHydratedChannels() {
-        const activeChannels = this._channelStore.getActiveChannels('seller');
+        const activeChannels = this._channelStore.getActiveChannels(CHANNEL_ROLE.SELLER);
         if (activeChannels.length === 0)
             return;
         const { seller: sellerEvmAddr } = await this._resolvedAddresses;
@@ -174,7 +175,7 @@ export class SellerPaymentManager {
             debugLog(`[SellerPayment] Startup validation: evicted ${evicted}/${activeChannels.length} stale channel(s)`);
         }
     }
-    _evictStaleChannel(channelId, peerId, reason, status = 'settled') {
+    _evictStaleChannel(channelId, peerId, reason, status = CHANNEL_STATUS.SETTLED) {
         this._channelStore.updateChannelStatus(channelId, status);
         this._acceptedCumulative.delete(channelId);
         this._spent.delete(channelId);
@@ -361,7 +362,7 @@ export class SellerPaymentManager {
                 const session = {
                     sessionId: channelId,
                     peerId: buyerPeerId,
-                    role: 'seller',
+                    role: CHANNEL_ROLE.SELLER,
                     sellerEvmAddr,
                     buyerEvmAddr,
                     nonce: 0,
@@ -374,7 +375,7 @@ export class SellerPaymentManager {
                     reservedAt: now,
                     settledAt: null,
                     settledAmount: null,
-                    status: 'active',
+                    status: CHANNEL_STATUS.ACTIVE,
                     latestBuyerSig: payload.spendingAuthSig,
                     latestSpendingAuthSig: payload.spendingAuthSig,
                     latestMetadata: payload.metadata,
@@ -697,7 +698,7 @@ export class SellerPaymentManager {
         const session = {
             sessionId: channelId,
             peerId: buyerPeerId,
-            role: 'seller',
+            role: CHANNEL_ROLE.SELLER,
             sellerEvmAddr,
             buyerEvmAddr,
             nonce: 0,
@@ -710,7 +711,7 @@ export class SellerPaymentManager {
             reservedAt: now,
             settledAt: null,
             settledAmount: onChain.settled > 0n ? onChain.settled.toString() : null,
-            status: 'active',
+            status: CHANNEL_STATUS.ACTIVE,
             latestBuyerSig: payload.spendingAuthSig,
             latestSpendingAuthSig: payload.spendingAuthSig,
             latestMetadata: payload.metadata,
@@ -743,7 +744,7 @@ export class SellerPaymentManager {
      */
     async validateAndAcceptAuth(buyerPeerId, auth) {
         // Look up active session for this buyer
-        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, 'seller');
+        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, CHANNEL_ROLE.SELLER);
         if (!session) {
             debugWarn(`[SellerPayment] validateAndAcceptAuth: no active session for buyer ${buyerPeerId.slice(0, 12)}...`);
             return false;
@@ -853,7 +854,7 @@ export class SellerPaymentManager {
      *   for future requests. No cleanup is performed so the session can resume.
      */
     async settleSession(buyerPeerId, { cleanupOnFailure = false, settleOnly = false } = {}) {
-        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, 'seller');
+        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, CHANNEL_ROLE.SELLER);
         if (!session) {
             debugWarn(`[SellerPayment] settleSession: no active session for buyer ${buyerPeerId.slice(0, 12)}...`);
             return;
@@ -884,7 +885,7 @@ export class SellerPaymentManager {
                 this._closingChannels.add(channelId);
                 try {
                     await this._channelsClient.close(this._signer, channelId, amount, metadata, sig);
-                    this._channelStore.updateChannelStatus(channelId, 'settled', amount.toString());
+                    this._channelStore.updateChannelStatus(channelId, CHANNEL_STATUS.SETTLED, amount.toString());
                     this._closeRetryCount.delete(channelId);
                 }
                 catch (err) {
@@ -914,7 +915,7 @@ export class SellerPaymentManager {
     }
     // ── Disconnect handling ───────────────────────────────────────
     onBuyerDisconnect(buyerPeerId) {
-        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, 'seller');
+        const session = this._channelStore.getActiveChannelByPeer(buyerPeerId, CHANNEL_ROLE.SELLER);
         if (!session)
             return;
         const settleOnDisconnect = this._config.settleOnDisconnect ?? true;
@@ -946,7 +947,7 @@ export class SellerPaymentManager {
      */
     async checkTimeouts() {
         const nowSecs = Math.floor(Date.now() / 1000);
-        const activeChannels = this._channelStore.getActiveChannels('seller');
+        const activeChannels = this._channelStore.getActiveChannels(CHANNEL_ROLE.SELLER);
         for (const channel of activeChannels) {
             let accepted = this._acceptedCumulative.get(channel.sessionId) ?? 0n;
             if (accepted === 0n) {
@@ -977,7 +978,7 @@ export class SellerPaymentManager {
                     if (onChainState.status !== 'active') {
                         // 'unknown' means the RPC returned partial data. Evict locally
                         // rather than risking a close() against an ambiguous channel.
-                        this._evictStaleChannel(channel.sessionId, channel.peerId, 'no auths, past deadline, on-chain status unknown', 'timeout');
+                        this._evictStaleChannel(channel.sessionId, channel.peerId, 'no auths, past deadline, on-chain status unknown', CHANNEL_STATUS.TIMEOUT);
                         continue;
                     }
                     await this._closeWithoutAuth(channel.sessionId, channel.peerId, onChainState.channel.settled);
@@ -1002,7 +1003,7 @@ export class SellerPaymentManager {
         const retries = this._closeRetryCount.get(channelId) ?? 0;
         if (retries >= SellerPaymentManager.MAX_CLOSE_RETRIES) {
             debugWarn(`[SellerPayment] Zombie close failed ${retries} times for ${channelId.slice(0, 18)}... — falling back to local eviction`);
-            this._evictStaleChannel(channelId, peerId, 'no auths, past deadline, close retries exhausted', 'timeout');
+            this._evictStaleChannel(channelId, peerId, 'no auths, past deadline, close retries exhausted', CHANNEL_STATUS.TIMEOUT);
             return;
         }
         this._closingChannels.add(channelId);
@@ -1010,7 +1011,7 @@ export class SellerPaymentManager {
         try {
             await this._channelsClient.close(this._signer, channelId, onChainSettled, '0x', '0x');
             this._closeRetryCount.delete(channelId);
-            this._evictStaleChannel(channelId, peerId, 'zombie closed on-chain', 'settled');
+            this._evictStaleChannel(channelId, peerId, 'zombie closed on-chain', CHANNEL_STATUS.SETTLED);
         }
         catch (err) {
             this._closeRetryCount.set(channelId, retries + 1);
@@ -1026,7 +1027,7 @@ export class SellerPaymentManager {
     }
     /** Get the active session for a buyer peer, or null. */
     getChannelByPeer(buyerPeerId) {
-        return this._channelStore.getActiveChannelByPeer(buyerPeerId, 'seller');
+        return this._channelStore.getActiveChannelByPeer(buyerPeerId, CHANNEL_ROLE.SELLER);
     }
     /** Get total USDC spent for a session (sum of recordSpend calls). */
     getCumulativeSpend(sessionId) {
@@ -1061,7 +1062,7 @@ export class SellerPaymentManager {
         let suggestedAmount = SellerPaymentManager.DEFAULT_SUGGESTED_AMOUNT;
         if (buyerPeerId) {
             const priorSession = this._channelStore.getLatestChannel(buyerPeerId, 'seller');
-            if (priorSession && priorSession.status === 'settled') {
+            if (priorSession && priorSession.status === CHANNEL_STATUS.SETTLED) {
                 // Returning buyer with proven history — could use a different amount
                 // For now, use the same default; config can override later
                 suggestedAmount = SellerPaymentManager.DEFAULT_SUGGESTED_AMOUNT;
@@ -1089,7 +1090,7 @@ export class SellerPaymentManager {
             debugLog(`[SellerPayment] CloseRequested for channel ${channelId.slice(0, 18)}... — closing with cumulative=${amount}`);
             try {
                 await this._channelsClient.close(this._signer, channelId, amount, metadata, sig);
-                this._channelStore.updateChannelStatus(channelId, 'settled', amount.toString());
+                this._channelStore.updateChannelStatus(channelId, CHANNEL_STATUS.SETTLED, amount.toString());
                 debugLog(`[SellerPayment] Channel ${channelId.slice(0, 18)}... closed successfully after CloseRequested`);
             }
             catch (err) {
@@ -1101,7 +1102,7 @@ export class SellerPaymentManager {
             // No voucher — seller can't claim anything. Clean up locally;
             // buyer will withdraw after grace period.
             debugLog(`[SellerPayment] CloseRequested for channel ${channelId.slice(0, 18)}... — no SpendingAuth, cleaning up locally`);
-            this._channelStore.updateChannelStatus(channelId, 'timeout');
+            this._channelStore.updateChannelStatus(channelId, CHANNEL_STATUS.TIMEOUT);
         }
         // Clean up in-memory state
         this._acceptedCumulative.delete(channelId);
@@ -1133,7 +1134,7 @@ export class SellerPaymentManager {
             const events = await this._channelsClient.getCloseRequestedEvents(fromBlock, latestBlock);
             for (const event of events) {
                 // Only handle channels this seller is actively tracking
-                if (this._acceptedCumulative.has(event.channelId) || this._channelStore.getChannel(event.channelId)?.status === 'active') {
+                if (this._acceptedCumulative.has(event.channelId) || this._channelStore.getChannel(event.channelId)?.status === CHANNEL_STATUS.ACTIVE) {
                     await this.handleCloseRequested(event.channelId);
                 }
             }