@antseed/node 0.2.93 → 0.2.95

package/dist/node.d.ts

@@ -9,7 +9,7 @@ import { type SellerContractConfig } from "./discovery/announcer.js";
 import type { PeerVerifications } from "./discovery/peer-metadata.js";
 import type { Provider, ProviderStreamCallbacks } from "./interfaces/seller-provider.js";
 import type { Router } from "./interfaces/buyer-router.js";
-import { type PaymentConfig, type PaymentMethod } from "./payments/index.js";
+import { type PaymentConfig, type PaymentMethod, FreeUsageClient, BuyerFreeUsageManager, SellerFreeUsageManager } from "./payments/index.js";
 import { BuyerPaymentManager, type BuyerPaymentConfig } from "./payments/buyer-payment-manager.js";
 import { BuyerPaymentNegotiator } from "./payments/buyer-payment-negotiator.js";
 import { IdentityClient } from "./payments/evm/identity-client.js";
@@ -44,6 +44,8 @@ export interface NodePaymentsConfig {
     depositsAddress?: string;
     /** Deployed AntseedChannels contract address */
     channelsAddress?: string;
+    /** Optional deployed AntseedFreeUsage contract address */
+    freeUsageAddress?: string;
     /** USDC token contract address */
     usdcAddress?: string;
     /** ERC-8004 IdentityRegistry contract address */
@@ -68,7 +70,7 @@ export interface NodePaymentsConfig {
     maxReserveAmountUsdc?: string;
 }
 export interface NodeVerificationConfig {
-    /** Random sample rate for storing full buyer request/response evidence. Default: 0.01. */
+    /** Random sample rate for storing full buyer request/response evidence. Default: 0.005. */
     sampleRate?: number;
     /** Maximum combined encoded request + response bytes per sample. Default: 16 MiB. */
     maxSampleBytes?: number;
@@ -155,6 +157,9 @@ export declare class AntseedNode extends EventEmitter {
     private _balanceManager;
     private _depositsClient;
     private _channelsClient;
+    private _freeUsageClient;
+    private _buyerFreeUsageManager;
+    private _sellerFreeUsageManager;
     private _stakingClient;
     private _sellerAddressResolver;
     private _identityClient;
@@ -186,6 +191,10 @@ export declare class AntseedNode extends EventEmitter {
     private _backgroundPeerDiscoveryPromise;
     /** Serializes non-blocking on-chain enrichment for incrementally discovered peers. */
     private _partialPeerEnrichmentChain;
+    /** Serializes non-blocking external claim verification for discovered peers. */
+    private _externalVerificationChain;
+    private _externalVerificationCache;
+    private _externalVerificationInFlight;
     constructor(config: NodeConfig);
     get peerId(): string | null;
     get identity(): Identity | null;
@@ -202,6 +211,12 @@ export declare class AntseedNode extends EventEmitter {
     get signalingPort(): number;
     /** ERC-8004 IdentityRegistry client (null if not configured). */
     get identityClient(): IdentityClient | null;
+    /** AntseedFreeUsage client (null if not configured). */
+    get freeUsageClient(): FreeUsageClient | null;
+    /** Buyer-side free usage manager (null if free usage is not configured). */
+    get buyerFreeUsageManager(): BuyerFreeUsageManager | null;
+    /** Seller-side free usage manager (null if free usage is not configured). */
+    get sellerFreeUsageManager(): SellerFreeUsageManager | null;
     /** Current connection state for a peer if a connection exists, otherwise null. */
     getPeerConnectionState(peerId: PeerId): ConnectionState | null;
     /**
@@ -218,6 +233,11 @@ export declare class AntseedNode extends EventEmitter {
     startBackgroundPeerDiscoverySweep(): void;
     private _startBackgroundPeerDiscoverySweep;
     private _queuePartialPeerEnrichment;
+    private _attachCachedExternalVerificationResults;
+    private _queueExternalVerification;
+    private _verifyExternalClaimsForPeers;
+    private _verifyExternalClaimsForPeer;
+    private _externalVerificationClaimsKey;
     /**
      * Look up a single peer by its peerId via the per-peer DHT topic.
      * Much cheaper and more deterministic than walking the wildcard topic:
@@ -334,5 +354,8 @@ export declare class AntseedNode extends EventEmitter {
     private _getOrCreateVerificationMux;
     private _resolvePublicAddress;
     private _lookupResultToPeerInfo;
+    private _warnIfFreeUsageMeteringUnavailable;
+    private _hasFreePricedService;
+    private _isZeroPricing;
 }
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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

package/dist/node.js

@@ -11,6 +11,8 @@ import { DHTNode, DEFAULT_DHT_CONFIG, SUBNET_COUNT, } from "./discovery/dht-node
 import { toBootstrapConfig, OFFICIAL_BOOTSTRAP_NODES, mergeBootstrapNodes } from "./discovery/bootstrap.js";
 import { ConnectionManager, } from "./p2p/connection-manager.js";
 import { PeerAnnouncer, } from "./discovery/announcer.js";
+import { verifyPeerMetadataDomains } from "./discovery/domain-verification.js";
+import { verifyPeerMetadataGithub } from "./discovery/github-verification.js";
 import { PeerLookup, DEFAULT_LOOKUP_CONFIG, } from "./discovery/peer-lookup.js";
 import { HttpMetadataResolver } from "./discovery/http-metadata-resolver.js";
 import { ProxyMux } from "./proxy/proxy-mux.js";
@@ -23,7 +25,7 @@ import { KeepaliveManager, buildPongPayload } from "./p2p/keepalive.js";
 import { MessageType } from "./types/protocol.js";
 import { NatTraversal } from "./p2p/nat-traversal.js";
 import { signUtf8 } from "./p2p/identity.js";
-import { BalanceManager, DepositsClient, ChannelsClient, StakingClient, ChannelStore, CHANNEL_STATUS, } from "./payments/index.js";
+import { BalanceManager, DepositsClient, ChannelsClient, FreeUsageClient, BuyerFreeUsageManager, SellerFreeUsageManager, StakingClient, ChannelStore, CHANNEL_ROLE, CHANNEL_STATUS, } from "./payments/index.js";
 import { debugLog, debugWarn } from "./utils/debug.js";
 import { parsePublicAddress } from "./discovery/public-address.js";
 import { BuyerPaymentManager } from "./payments/buyer-payment-manager.js";
@@ -34,7 +36,7 @@ import { SellerPaymentManager } from "./payments/seller-payment-manager.js";
 import { IdentityClient } from "./payments/evm/identity-client.js";
 import { SellerRequestHandler } from "./seller-request-handler.js";
 import { BuyerRequestHandler, } from "./buyer-request-handler.js";
-import { buildSybilContext, computeOnChainScore, computeOnChainSybilRisk, computeOnChainTrust, } from "./reputation/on-chain-reputation.js";
+import { buildSybilContext, computeOnChainScore, computeOnChainScoreWithRisk, computeOnChainSybilRisk, computeOnChainTrust, } from "./reputation/on-chain-reputation.js";
 const EMPTY_BUYER_USAGE = {
     totalRequests: 0,
     totalInputTokens: '0',
@@ -44,6 +46,7 @@ const EMPTY_BUYER_USAGE = {
     activeChannels: 0,
     channels: [],
 };
+const EXTERNAL_VERIFICATION_RESULT_TTL_MS = 15 * 60_000;
 export class AntseedNode extends EventEmitter {
     _config;
     _identity = null;
@@ -63,6 +66,9 @@ export class AntseedNode extends EventEmitter {
     _balanceManager = null;
     _depositsClient = null;
     _channelsClient = null;
+    _freeUsageClient = null;
+    _buyerFreeUsageManager = null;
+    _sellerFreeUsageManager = null;
     _stakingClient = null;
     _sellerAddressResolver = null;
     _identityClient = null;
@@ -94,6 +100,10 @@ export class AntseedNode extends EventEmitter {
     _backgroundPeerDiscoveryPromise = null;
     /** Serializes non-blocking on-chain enrichment for incrementally discovered peers. */
     _partialPeerEnrichmentChain = Promise.resolve();
+    /** Serializes non-blocking external claim verification for discovered peers. */
+    _externalVerificationChain = Promise.resolve();
+    _externalVerificationCache = new Map();
+    _externalVerificationInFlight = new Set();
     constructor(config) {
         super();
         this._config = config;
@@ -133,6 +143,18 @@ export class AntseedNode extends EventEmitter {
     get identityClient() {
         return this._identityClient;
     }
+    /** AntseedFreeUsage client (null if not configured). */
+    get freeUsageClient() {
+        return this._freeUsageClient;
+    }
+    /** Buyer-side free usage manager (null if free usage is not configured). */
+    get buyerFreeUsageManager() {
+        return this._buyerFreeUsageManager;
+    }
+    /** Seller-side free usage manager (null if free usage is not configured). */
+    get sellerFreeUsageManager() {
+        return this._sellerFreeUsageManager;
+    }
     /** Current connection state for a peer if a connection exists, otherwise null. */
     getPeerConnectionState(peerId) {
         return this._connectionManager?.getConnection(peerId)?.state ?? null;
@@ -187,6 +209,9 @@ export class AntseedNode extends EventEmitter {
         if (this._buyerNegotiator) {
             this._buyerNegotiator.cleanup();
         }
+        if (this._sellerFreeUsageManager) {
+            await this._sellerFreeUsageManager.flushAllPendingRecords();
+        }
         if (this._sessionTracker) {
             await this._sessionTracker.finalizeAllSessions("node-stop");
             this._sessionTracker.clearTimers();
@@ -274,6 +299,9 @@ export class AntseedNode extends EventEmitter {
         this._balanceManager = null;
         this._depositsClient = null;
         this._channelsClient = null;
+        this._freeUsageClient = null;
+        this._buyerFreeUsageManager = null;
+        this._sellerFreeUsageManager = null;
         this._stakingClient = null;
         this._identityClient = null;
         this._sellerAddressResolver = null;
@@ -316,6 +344,8 @@ export class AntseedNode extends EventEmitter {
             }
         }
         const filtered = service ? peers.filter((p) => peerOffersService(p, service)) : peers;
+        this._attachCachedExternalVerificationResults(filtered);
+        this._queueExternalVerification(filtered);
         // On-chain enrichment runs after the metadata filter so we don't waste
         // RPC calls on peers we'll discard.
         await this._enrichPeersWithOnChainStats(filtered);
@@ -351,7 +381,9 @@ export class AntseedNode extends EventEmitter {
                 debugLog(`[Node] Background DHT partial ${context.phase}`
                     + `${context.subnet !== undefined ? ` ${context.subnet}/${SUBNET_COUNT - 1}` : ""}`
                     + ` emitted ${peers.length} peer(s) from ${context.endpointCount} endpoint(s)`);
+                this._attachCachedExternalVerificationResults(peers);
                 this.emit("peers:discovered", peers);
+                this._queueExternalVerification(peers);
                 this._queuePartialPeerEnrichment(peers);
             });
             debugLog(`[Node] Background DHT sweep returned ${results.length} result(s)`);
@@ -388,6 +420,124 @@ export class AntseedNode extends EventEmitter {
             debugWarn(`[Node] Background DHT partial on-chain enrichment failed: ${err instanceof Error ? err.message : err}`);
         });
     }
+    _attachCachedExternalVerificationResults(peers) {
+        const nowMs = Date.now();
+        for (const peer of peers) {
+            const claimsKey = this._externalVerificationClaimsKey(peer);
+            if (!claimsKey)
+                continue;
+            const cached = this._externalVerificationCache.get(peer.peerId);
+            if (cached
+                && cached.claimsKey === claimsKey
+                && nowMs - cached.checkedAtMs < EXTERNAL_VERIFICATION_RESULT_TTL_MS) {
+                peer.verificationResults = cached.results;
+            }
+        }
+    }
+    _queueExternalVerification(peers) {
+        const queued = [];
+        const nowMs = Date.now();
+        for (const peer of peers) {
+            const claimsKey = this._externalVerificationClaimsKey(peer);
+            if (!claimsKey)
+                continue;
+            const cacheKey = `${peer.peerId}:${claimsKey}`;
+            if (this._externalVerificationInFlight.has(cacheKey))
+                continue;
+            const cached = this._externalVerificationCache.get(peer.peerId);
+            if (cached
+                && cached.claimsKey === claimsKey
+                && nowMs - cached.checkedAtMs < EXTERNAL_VERIFICATION_RESULT_TTL_MS) {
+                continue;
+            }
+            this._externalVerificationInFlight.add(cacheKey);
+            queued.push({ ...peer });
+        }
+        if (queued.length === 0)
+            return;
+        this._externalVerificationChain = this._externalVerificationChain.then(async () => {
+            if (!this._started)
+                return;
+            const verifiedPeers = await this._verifyExternalClaimsForPeers(queued);
+            if (!this._started || verifiedPeers.length === 0)
+                return;
+            debugLog(`[Node] External verification emitted ${verifiedPeers.length} peer update(s)`);
+            this.emit("peers:discovered", verifiedPeers);
+        }).catch((err) => {
+            debugWarn(`[Node] External verification failed: ${err instanceof Error ? err.message : err}`);
+        }).finally(() => {
+            for (const peer of queued) {
+                const claimsKey = this._externalVerificationClaimsKey(peer);
+                if (claimsKey) {
+                    this._externalVerificationInFlight.delete(`${peer.peerId}:${claimsKey}`);
+                }
+            }
+        });
+    }
+    async _verifyExternalClaimsForPeers(peers) {
+        const queue = peers.slice();
+        const verifiedPeers = [];
+        const EXTERNAL_VERIFICATION_CONCURRENCY = 2;
+        const workers = Array.from({ length: Math.min(EXTERNAL_VERIFICATION_CONCURRENCY, queue.length) }, async () => {
+            for (;;) {
+                const peer = queue.shift();
+                if (!peer)
+                    return;
+                const verified = await this._verifyExternalClaimsForPeer(peer);
+                if (verified) {
+                    verifiedPeers.push(verified);
+                }
+            }
+        });
+        await Promise.all(workers);
+        return verifiedPeers;
+    }
+    async _verifyExternalClaimsForPeer(peer) {
+        const metadata = peer.metadata;
+        const claimsKey = this._externalVerificationClaimsKey(peer);
+        if (!metadata || !claimsKey)
+            return null;
+        try {
+            const [domains, github] = await Promise.all([
+                verifyPeerMetadataDomains(metadata),
+                verifyPeerMetadataGithub(metadata),
+            ]);
+            const checkedAtMs = Date.now();
+            const allResults = [...domains, ...github];
+            const results = {
+                verified: allResults.length > 0 && allResults.every((result) => result.verified),
+                checkedAtMs,
+                domains,
+                github,
+            };
+            this._externalVerificationCache.set(peer.peerId, {
+                claimsKey,
+                checkedAtMs,
+                results,
+            });
+            const verifiedPeer = { ...peer, verificationResults: results };
+            const risk = typeof verifiedPeer.onChainSybilRisk === 'number'
+                ? verifiedPeer.onChainSybilRisk
+                : 0;
+            verifiedPeer.onChainReputationScore = computeOnChainScoreWithRisk(verifiedPeer, risk) ?? verifiedPeer.onChainReputationScore;
+            return verifiedPeer;
+        }
+        catch (err) {
+            debugWarn(`[Node] External verification failed for ${peer.peerId.slice(0, 12)}...: ${err instanceof Error ? err.message : err}`);
+            return null;
+        }
+    }
+    _externalVerificationClaimsKey(peer) {
+        const verifications = peer.metadata?.verifications;
+        const domainCount = verifications?.domains?.length ?? 0;
+        const githubCount = verifications?.github?.length ?? 0;
+        if (domainCount + githubCount === 0)
+            return null;
+        return JSON.stringify({
+            domains: verifications?.domains ?? [],
+            github: verifications?.github ?? [],
+        });
+    }
     /**
      * Look up a single peer by its peerId via the per-peer DHT topic.
      * Much cheaper and more deterministic than walking the wildcard topic:
@@ -424,6 +574,8 @@ export class AntseedNode extends EventEmitter {
         // served metadata matches the id; pick the freshest by timestamp.
         const best = results.reduce((acc, r) => r.metadata.timestamp > acc.metadata.timestamp ? r : acc);
         const peer = this._lookupResultToPeerInfo(best);
+        this._attachCachedExternalVerificationResults([peer]);
+        this._queueExternalVerification([peer]);
         await this._enrichPeersWithOnChainStats([peer]);
         return peer;
     }
@@ -542,14 +694,14 @@ export class AntseedNode extends EventEmitter {
     getMeteringStatsByPeer(sellerPeerId) {
         const buyerAddress = this._identity?.wallet.address ?? null;
         const channel = (buyerAddress != null)
-            ? (this._channelStore?.getActiveChannelByPeerAndBuyer(sellerPeerId, 'buyer', buyerAddress)
-                ?? this._channelStore?.getLatestChannelByPeerAndBuyer(sellerPeerId, 'buyer', buyerAddress))
-            : (this._channelStore?.getActiveChannelByPeer(sellerPeerId, 'buyer')
-                ?? this._channelStore?.getLatestChannel(sellerPeerId, 'buyer'))
+            ? (this._channelStore?.getActiveChannelByPeerAndBuyer(sellerPeerId, CHANNEL_ROLE.BUYER, buyerAddress)
+                ?? this._channelStore?.getLatestChannelByPeerAndBuyer(sellerPeerId, CHANNEL_ROLE.BUYER, buyerAddress))
+            : (this._channelStore?.getActiveChannelByPeer(sellerPeerId, CHANNEL_ROLE.BUYER)
+                ?? this._channelStore?.getLatestChannel(sellerPeerId, CHANNEL_ROLE.BUYER))
                 ?? null;
         const lifetime = (buyerAddress != null)
-            ? this._channelStore?.getTotalsByPeerAndBuyer(sellerPeerId, 'buyer', buyerAddress)
-            : this._channelStore?.getTotalsByPeer(sellerPeerId, 'buyer')
+            ? this._channelStore?.getTotalsByPeerAndBuyer(sellerPeerId, CHANNEL_ROLE.BUYER, buyerAddress)
+            : this._channelStore?.getTotalsByPeer(sellerPeerId, CHANNEL_ROLE.BUYER)
                 ?? null;
         const liveTotals = this._buyerPaymentManager?.getResponseTokenTotals(sellerPeerId);
         const inputTokens = (liveTotals != null) ? liveTotals.input
@@ -593,7 +745,7 @@ export class AntseedNode extends EventEmitter {
         const buyerAddress = this._identity?.wallet.address ?? null;
         if (!buyerAddress || !this._channelStore)
             return [];
-        const stored = this._channelStore.getActiveChannelsByBuyer('buyer', buyerAddress);
+        const stored = this._channelStore.getActiveChannelsByBuyer(CHANNEL_ROLE.BUYER, buyerAddress);
         return stored.map((c) => {
             const liveReserve = this._buyerPaymentManager?.getReserveCeiling(c.peerId);
             const reserveMax = (liveReserve != null && liveReserve > 0n)
@@ -779,6 +931,8 @@ export class AntseedNode extends EventEmitter {
                 this._decoders.delete(peerId);
                 // Clean up buyer-side payment state on disconnect
                 this._buyerNegotiator?.onPeerDisconnect(peerId);
+                this._buyerFreeUsageManager?.onPeerDisconnect(peerId);
+                this._sellerFreeUsageManager?.onPeerDisconnect(peerId);
                 // Handle buyer disconnect (seller side)
                 if (this._sellerPaymentManager) {
                     this._sellerPaymentManager.onBuyerDisconnect(peerId);
@@ -838,6 +992,7 @@ export class AntseedNode extends EventEmitter {
             onSessionFinalized: (info) => this.emit("session:finalized", info),
         });
         await this._initializePayments(dataDir);
+        this._warnIfFreeUsageMeteringUnavailable();
         // Wire idle session events to on-chain settlement
         if (this._sellerPaymentManager) {
             const spm = this._sellerPaymentManager;
@@ -932,6 +1087,7 @@ export class AntseedNode extends EventEmitter {
             identity,
             providers: this._providers,
             sellerPaymentManager: this._sellerPaymentManager,
+            sellerFreeUsageManager: this._sellerFreeUsageManager,
             sessionTracker: this._sessionTracker,
             channelsClient: this._channelsClient,
             announcer: this._announcer,
@@ -1010,7 +1166,7 @@ export class AntseedNode extends EventEmitter {
                 this._buyerPaymentManager = new BuyerPaymentManager(identity, buyerPaymentConfig, this._channelStore, this._sellerAddressResolver ?? undefined);
                 debugLog(`[Node] Buyer payment manager initialized (wallet=${identity.wallet.address.slice(0, 10)}... chainId=${buyerPaymentConfig.chainId} deposits=${buyerPaymentConfig.depositsContractAddress.slice(0, 10)}...)`);
                 // Create negotiator that wraps the BPM with 402 handling and per-request auth
-                this._buyerNegotiator = new BuyerPaymentNegotiator(identity, this._buyerPaymentManager, this._depositsClient, this._channelsClient, this._channelStore, {}, this, this._sellerAddressResolver ?? undefined);
+                this._buyerNegotiator = new BuyerPaymentNegotiator(identity, this._buyerPaymentManager, this._depositsClient, this._channelsClient, this._channelStore, {}, this, this._sellerAddressResolver ?? undefined, this._buyerFreeUsageManager);
                 debugLog(`[Node] Buyer payment negotiator initialized`);
             }
         }
@@ -1022,6 +1178,7 @@ export class AntseedNode extends EventEmitter {
         }, {
             localPeerId: identity.peerId,
             negotiator: this._buyerNegotiator,
+            freeUsageManager: this._buyerFreeUsageManager,
             verificationStorage: this._verificationStorage,
             verificationSampler: this._verificationSampler,
             getConnection: (peer) => this._getOrCreateConnection(peer),
@@ -1057,6 +1214,23 @@ export class AntseedNode extends EventEmitter {
                 debugWarn(`[Node] SpendingAuth rejected — SellerPaymentManager not configured`);
             });
         }
+        if (this._sellerFreeUsageManager) {
+            const freeUsage = this._sellerFreeUsageManager;
+            paymentMux.onFreeUsageOpen((payload) => {
+                freeUsage.handleOpen(buyerPeerId, payload, paymentMux);
+            });
+            paymentMux.onFreeUsageAuth((payload) => {
+                freeUsage.handleAuth(buyerPeerId, payload, paymentMux);
+            });
+        }
+        else {
+            paymentMux.onFreeUsageOpen(() => {
+                debugWarn(`[Node] FreeUsageOpen ignored — SellerFreeUsageManager not configured`);
+            });
+            paymentMux.onFreeUsageAuth(() => {
+                debugWarn(`[Node] FreeUsageAuth ignored — SellerFreeUsageManager not configured`);
+            });
+        }
         this._paymentMuxes.set(buyerPeerId, paymentMux);
         this._verificationMuxes.set(buyerPeerId, verificationMux);
         const { mux } = this._sellerHandler.handleConnection(conn, buyerPeerId, paymentMux, verificationMux);
@@ -1070,6 +1244,17 @@ export class AntseedNode extends EventEmitter {
             return;
         }
         const fallbackRpcUrls = payments.fallbackRpcUrls;
+        const paymentsDir = join(dataDir, "payments");
+        // Shared store for paid and free channel accounting.
+        if (!this._channelStore) {
+            try {
+                this._channelStore = new ChannelStore(paymentsDir);
+                debugLog("[Node] ChannelStore initialized");
+            }
+            catch (err) {
+                debugWarn(`[Node] ChannelStore unavailable: ${err instanceof Error ? err.message : err}`);
+            }
+        }
         // Initialize DepositsClient
         if (payments.rpcUrl && payments.depositsAddress && payments.usdcAddress) {
             this._depositsClient = new DepositsClient({
@@ -1115,6 +1300,32 @@ export class AntseedNode extends EventEmitter {
             });
             debugLog(`[Node] SellerAddressResolver initialized`);
         }
+        // Initialize FreeUsageClient
+        if (payments.rpcUrl && payments.freeUsageAddress) {
+            this._freeUsageClient = new FreeUsageClient({
+                rpcUrl: payments.rpcUrl,
+                ...(fallbackRpcUrls ? { fallbackRpcUrls } : {}),
+                contractAddress: payments.freeUsageAddress,
+                ...(payments.chainId ? { evmChainId: payments.chainId } : {}),
+            });
+            debugLog(`[Node] FreeUsageClient initialized (contract=${payments.freeUsageAddress.slice(0, 10)}...)`);
+            if (this._identity) {
+                const freeUsageConfig = {
+                    rpcUrl: payments.rpcUrl,
+                    ...(fallbackRpcUrls ? { fallbackRpcUrls } : {}),
+                    freeUsageContractAddress: payments.freeUsageAddress,
+                    chainId: payments.chainId ?? 8453,
+                };
+                this._buyerFreeUsageManager = new BuyerFreeUsageManager(this._identity, {
+                    chainId: freeUsageConfig.chainId,
+                    freeUsageContractAddress: freeUsageConfig.freeUsageContractAddress,
+                    defaultAuthDurationSecs: payments.defaultAuthDurationSecs ?? 900,
+                }, this._sellerAddressResolver ?? undefined, this._channelStore ?? undefined);
+                if (this._config.role === 'seller') {
+                    this._sellerFreeUsageManager = new SellerFreeUsageManager(this._identity, freeUsageConfig);
+                }
+            }
+        }
         // Initialize StakingClient
         if (payments.rpcUrl && payments.stakingAddress && payments.usdcAddress) {
             this._stakingClient = new StakingClient({
@@ -1136,17 +1347,6 @@ export class AntseedNode extends EventEmitter {
             });
             debugLog(`[Node] IdentityClient initialized (contract=${payments.identityRegistryAddress.slice(0, 10)}...)`);
         }
-        // Initialize ChannelStore for persistent payment channels (shared instance)
-        const paymentsDir = join(dataDir, "payments");
-        if (!this._channelStore) {
-            try {
-                this._channelStore = new ChannelStore(paymentsDir);
-                debugLog("[Node] ChannelStore initialized");
-            }
-            catch (err) {
-                debugWarn(`[Node] ChannelStore unavailable: ${err instanceof Error ? err.message : err}`);
-            }
-        }
         // Initialize SellerPaymentManager for seller role
         if (this._config.role === 'seller' && this._identity && this._channelStore &&
             payments.rpcUrl && payments.channelsAddress) {
@@ -1404,6 +1604,32 @@ export class AntseedNode extends EventEmitter {
             onChainGhostCount: result.metadata.onChainGhostCount,
         };
     }
+    _warnIfFreeUsageMeteringUnavailable() {
+        if (this._sellerFreeUsageManager || !this._hasFreePricedService())
+            return;
+        const missingAddress = !this._config.payments?.freeUsageAddress;
+        debugWarn(`[Node] Zero-priced service advertised but AntseedFreeUsage is not configured` +
+            `${missingAddress ? ' (payments.freeUsageAddress missing)' : ''}. ` +
+            `Free requests will be served without on-chain usage proofs.`);
+    }
+    _hasFreePricedService() {
+        for (const provider of this._providers) {
+            if (provider.services.length === 0 && this._isZeroPricing(provider.pricing.defaults))
+                return true;
+            for (const service of provider.services) {
+                const servicePricing = provider.pricing.services?.[service] ?? provider.pricing.defaults;
+                if (this._isZeroPricing(servicePricing))
+                    return true;
+            }
+        }
+        return false;
+    }
+    _isZeroPricing(pricing) {
+        const cachedPrice = pricing.cachedInputUsdPerMillion ?? pricing.inputUsdPerMillion;
+        return pricing.inputUsdPerMillion === 0
+            && pricing.outputUsdPerMillion === 0
+            && cachedPrice === 0;
+    }
 }
 function parsePeerAddress(address) {
     const parts = address.split(":");