@antseed/node 0.2.94 → 0.2.95

package/dist/payments/evm/signatures.js

@@ -22,6 +22,20 @@ export const SET_OPERATOR_TYPES = {
         { name: 'nonce', type: 'uint256' },
     ],
 };
+export const FREE_USAGE_OPEN_TYPES = {
+    FreeUsageOpen: [
+        { name: 'channelId', type: 'bytes32' },
+        { name: 'deadline', type: 'uint256' },
+    ],
+};
+export const FREE_USAGE_AUTH_TYPES = {
+    FreeUsageAuth: [
+        { name: 'channelId', type: 'bytes32' },
+        { name: 'sequence', type: 'uint256' },
+        { name: 'metadataHash', type: 'bytes32' },
+        { name: 'deadline', type: 'uint256' },
+    ],
+};
 export const METADATA_VERSION = 2n;
 const SERVICE_METADATA_ABI_TYPE = 'tuple(bytes32 serviceId,uint256 cumulativeAmount,uint256 cumulativeInputTokens,uint256 cumulativeCachedInputTokens,uint256 cumulativeOutputTokens,uint256 cumulativeRequestCount)[]';
 export function encodeMetadata(metadata) {
@@ -38,6 +52,35 @@ export function encodeMetadata(metadata) {
 export function getServiceMetadataId(service) {
     return id(service.trim());
 }
+export function withServiceMetadata(metadata, service, delta) {
+    if (!service || service.trim().length === 0)
+        return metadata;
+    const serviceId = getServiceMetadataId(service);
+    const byServiceId = new Map();
+    for (const entry of metadata.services ?? []) {
+        byServiceId.set(entry.serviceId, { ...entry });
+    }
+    const existing = byServiceId.get(serviceId) ?? {
+        serviceId,
+        cumulativeAmount: 0n,
+        cumulativeInputTokens: 0n,
+        cumulativeCachedInputTokens: 0n,
+        cumulativeOutputTokens: 0n,
+        cumulativeRequestCount: 0n,
+    };
+    byServiceId.set(serviceId, {
+        serviceId,
+        cumulativeAmount: existing.cumulativeAmount + delta.amount,
+        cumulativeInputTokens: existing.cumulativeInputTokens + delta.inputTokens,
+        cumulativeCachedInputTokens: existing.cumulativeCachedInputTokens + delta.cachedInputTokens,
+        cumulativeOutputTokens: existing.cumulativeOutputTokens + delta.outputTokens,
+        cumulativeRequestCount: existing.cumulativeRequestCount + delta.requests,
+    });
+    return {
+        ...metadata,
+        services: [...byServiceId.values()].sort((a, b) => a.serviceId < b.serviceId ? -1 : a.serviceId > b.serviceId ? 1 : 0),
+    };
+}
 export function computeMetadataHash(metadata) {
     return keccak256(encodeMetadata(metadata));
 }
@@ -48,6 +91,28 @@ export const ZERO_METADATA = {
     services: [],
 };
 export const ZERO_METADATA_HASH = computeMetadataHash(ZERO_METADATA);
+export const FREE_USAGE_METADATA_VERSION = 1n;
+export function encodeFreeUsageMetadata(metadata) {
+    const coder = AbiCoder.defaultAbiCoder();
+    const services = [...(metadata.services ?? [])].sort((a, b) => a.serviceId < b.serviceId ? -1 : a.serviceId > b.serviceId ? 1 : 0);
+    return coder.encode(['uint256', 'uint256', 'uint256', 'uint256', SERVICE_METADATA_ABI_TYPE], [
+        FREE_USAGE_METADATA_VERSION,
+        metadata.cumulativeInputTokens,
+        metadata.cumulativeOutputTokens,
+        metadata.cumulativeRequestCount,
+        services,
+    ]);
+}
+export function computeFreeUsageMetadataHash(metadata) {
+    return keccak256(encodeFreeUsageMetadata(metadata));
+}
+export const ZERO_FREE_USAGE_METADATA = {
+    cumulativeInputTokens: 0n,
+    cumulativeOutputTokens: 0n,
+    cumulativeRequestCount: 0n,
+    services: [],
+};
+export const ZERO_FREE_USAGE_METADATA_HASH = computeFreeUsageMetadataHash(ZERO_FREE_USAGE_METADATA);
 // =========================================================================
 // Channel ID computation (must match AntseedChannels.computeChannelId)
 // =========================================================================
@@ -59,6 +124,16 @@ export function computeChannelId(buyer, seller, salt) {
     const coder = AbiCoder.defaultAbiCoder();
     return keccak256(coder.encode(['address', 'address', 'bytes32'], [buyer, seller, salt]));
 }
+export const FREE_USAGE_CHANNEL_DOMAIN = id('ANTSEED_FREE_USAGE_CHANNEL');
+/**
+ * Compute the deterministic free usage channelId.
+ * Domain-separated from AntseedChannels.computeChannelId so a paid and free
+ * channel cannot share an ID even if buyer, seller, and salt are identical.
+ */
+export function computeFreeUsageChannelId(buyer, seller, salt) {
+    const coder = AbiCoder.defaultAbiCoder();
+    return keccak256(coder.encode(['bytes32', 'address', 'address', 'bytes32'], [FREE_USAGE_CHANNEL_DOMAIN, buyer, seller, salt]));
+}
 // =========================================================================
 // EIP-712 Domain helpers
 // =========================================================================
@@ -78,6 +153,14 @@ export function makeDepositsDomain(chainId, contractAddress) {
         verifyingContract: contractAddress,
     };
 }
+export function makeFreeUsageDomain(chainId, contractAddress) {
+    return {
+        name: 'AntseedFreeUsage',
+        version: '1',
+        chainId,
+        verifyingContract: contractAddress,
+    };
+}
 // =========================================================================
 // Signing functions — EIP-712 (on-chain)
 // =========================================================================
@@ -90,4 +173,10 @@ export async function signReserveAuth(signer, domain, msg) {
 export async function signSetOperator(signer, domain, msg) {
     return signer.signTypedData(domain, SET_OPERATOR_TYPES, msg);
 }
+export async function signFreeUsageOpen(signer, domain, msg) {
+    return signer.signTypedData(domain, FREE_USAGE_OPEN_TYPES, msg);
+}
+export async function signFreeUsageAuth(signer, domain, msg) {
+    return signer.signTypedData(domain, FREE_USAGE_AUTH_TYPES, msg);
+}
 //# sourceMappingURL=signatures.js.map

package/dist/payments/evm/signatures.js.map

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

package/dist/payments/index.d.ts

@@ -6,22 +6,26 @@ export { DepositsClient } from './evm/deposits-client.js';
 export type { DepositsClientConfig, BuyerBalanceInfo } from './evm/deposits-client.js';
 export { ChannelsClient } from './evm/channels-client.js';
 export type { ChannelsClientConfig, ChannelInfo, AgentStats, CloseRequestedEvent } from './evm/channels-client.js';
+export { FreeUsageClient } from './evm/free-usage-client.js';
+export type { FreeUsageClientConfig, FreeUsageChannelInfo, FreeUsageAgentStats } from './evm/free-usage-client.js';
 export { IdentityClient } from './evm/identity-client.js';
 export type { IdentityClientConfig } from './evm/identity-client.js';
 export { StakingClient } from './evm/staking-client.js';
 export type { StakingClientConfig } from './evm/staking-client.js';
-export { signSpendingAuth, signReserveAuth, signSetOperator, makeChannelsDomain, makeDepositsDomain, SPENDING_AUTH_TYPES, RESERVE_AUTH_TYPES, SET_OPERATOR_TYPES, computeMetadataHash, encodeMetadata, getServiceMetadataId, METADATA_VERSION, computeChannelId, ZERO_METADATA, ZERO_METADATA_HASH, } from './evm/signatures.js';
-export type { SpendingAuthMessage, ReserveAuthMessage, SetOperatorMessage, SpendingAuthMetadata, SpendingAuthServiceMetadata } from './evm/signatures.js';
+export { signSpendingAuth, signReserveAuth, signFreeUsageOpen, signFreeUsageAuth, signSetOperator, makeChannelsDomain, makeDepositsDomain, makeFreeUsageDomain, SPENDING_AUTH_TYPES, RESERVE_AUTH_TYPES, FREE_USAGE_OPEN_TYPES, FREE_USAGE_AUTH_TYPES, SET_OPERATOR_TYPES, computeMetadataHash, encodeMetadata, computeFreeUsageMetadataHash, encodeFreeUsageMetadata, getServiceMetadataId, METADATA_VERSION, FREE_USAGE_METADATA_VERSION, computeChannelId, computeFreeUsageChannelId, FREE_USAGE_CHANNEL_DOMAIN, ZERO_METADATA, ZERO_METADATA_HASH, ZERO_FREE_USAGE_METADATA, ZERO_FREE_USAGE_METADATA_HASH, } from './evm/signatures.js';
+export type { SpendingAuthMessage, ReserveAuthMessage, SetOperatorMessage, FreeUsageOpenMessage, FreeUsageAuthMessage, SpendingAuthMetadata, SpendingAuthServiceMetadata, FreeUsageMetadata, FreeUsageServiceMetadata, } from './evm/signatures.js';
 export { ANTSTokenClient } from './evm/ants-token-client.js';
 export type { ANTSTokenClientConfig } from './evm/ants-token-client.js';
 export { EmissionsClient } from './evm/emissions-client.js';
 export type { EmissionsClientConfig, EmissionsEpochParams } from './evm/emissions-client.js';
-export { SubPoolClient } from './evm/subpool-client.js';
-export type { SubPoolClientConfig } from './evm/subpool-client.js';
-export { ChannelStore, CHANNEL_STATUS } from './channel-store.js';
-export type { StoredChannel, StoredReceipt } from './channel-store.js';
+export { ChannelStore, CHANNEL_KIND, CHANNEL_ROLE, CHANNEL_STATUS } from './channel-store.js';
+export type { ChannelKind, ChannelRole, ChannelStatus, StoredChannel, StoredReceipt } from './channel-store.js';
 export { BuyerPaymentManager } from './buyer-payment-manager.js';
 export type { BuyerPaymentConfig, PerRequestAuthResult } from './buyer-payment-manager.js';
+export { BuyerFreeUsageManager } from './buyer-free-usage-manager.js';
+export type { BuyerFreeUsageConfig } from './buyer-free-usage-manager.js';
+export { SellerFreeUsageManager } from './seller-free-usage-manager.js';
+export type { SellerFreeUsageConfig } from './seller-free-usage-manager.js';
 export { BuyerPaymentNegotiator } from './buyer-payment-negotiator.js';
 export type { BuyerNegotiatorConfig, Handle402Result, NegotiationEmitter } from './buyer-payment-negotiator.js';
 export { SellerPaymentManager, DEFAULT_MIN_SETTLE_DELTA_STR } from './seller-payment-manager.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,OAAO,EACP,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGvF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAG1J,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGhH,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,OAAO,EACP,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGvF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGnH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAG3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAG5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGhH,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/payments/index.js

@@ -6,21 +6,24 @@ export { BaseEvmClient } from './evm/base-evm-client.js';
 export { DepositsClient } from './evm/deposits-client.js';
 // Channels client (reserve, settle, timeout)
 export { ChannelsClient } from './evm/channels-client.js';
+// Free usage client (zero-price signed usage)
+export { FreeUsageClient } from './evm/free-usage-client.js';
 // Identity client (ERC-8004 IdentityRegistry)
 export { IdentityClient } from './evm/identity-client.js';
 // Staking client (seller staking, token rate, slashing)
 export { StakingClient } from './evm/staking-client.js';
-export { signSpendingAuth, signReserveAuth, signSetOperator, makeChannelsDomain, makeDepositsDomain, SPENDING_AUTH_TYPES, RESERVE_AUTH_TYPES, SET_OPERATOR_TYPES, computeMetadataHash, encodeMetadata, getServiceMetadataId, METADATA_VERSION, computeChannelId, ZERO_METADATA, ZERO_METADATA_HASH, } from './evm/signatures.js';
+export { signSpendingAuth, signReserveAuth, signFreeUsageOpen, signFreeUsageAuth, signSetOperator, makeChannelsDomain, makeDepositsDomain, makeFreeUsageDomain, SPENDING_AUTH_TYPES, RESERVE_AUTH_TYPES, FREE_USAGE_OPEN_TYPES, FREE_USAGE_AUTH_TYPES, SET_OPERATOR_TYPES, computeMetadataHash, encodeMetadata, computeFreeUsageMetadataHash, encodeFreeUsageMetadata, getServiceMetadataId, METADATA_VERSION, FREE_USAGE_METADATA_VERSION, computeChannelId, computeFreeUsageChannelId, FREE_USAGE_CHANNEL_DOMAIN, ZERO_METADATA, ZERO_METADATA_HASH, ZERO_FREE_USAGE_METADATA, ZERO_FREE_USAGE_METADATA_HASH, } from './evm/signatures.js';
 // ANTS token
 export { ANTSTokenClient } from './evm/ants-token-client.js';
 // Emissions
 export { EmissionsClient } from './evm/emissions-client.js';
-// Subscription Pool
-export { SubPoolClient } from './evm/subpool-client.js';
 // Channel persistence
-export { ChannelStore, CHANNEL_STATUS } from './channel-store.js';
+export { ChannelStore, CHANNEL_KIND, CHANNEL_ROLE, CHANNEL_STATUS } from './channel-store.js';
 // Buyer payment manager
 export { BuyerPaymentManager } from './buyer-payment-manager.js';
+// Free usage managers
+export { BuyerFreeUsageManager } from './buyer-free-usage-manager.js';
+export { SellerFreeUsageManager } from './seller-free-usage-manager.js';
 // Buyer payment negotiator (402 handling, SpendingAuth flow, cost tracking)
 export { BuyerPaymentNegotiator } from './buyer-payment-negotiator.js';
 // Seller payment manager

package/dist/payments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AAWA,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,oDAAoD;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,6CAA6C;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGlE,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAGjG,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG/F,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AAWA,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,oDAAoD;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,6CAA6C;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,8CAA8C;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAa7B,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9F,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,sBAAsB;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAGjG,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG/F,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/payments/seller-free-usage-manager.d.ts

@@ -0,0 +1,44 @@
+import type { Identity } from '../p2p/identity.js';
+import type { PaymentMux } from '../p2p/payment-mux.js';
+import type { FreeUsageAuthPayload, FreeUsageOpenPayload } from '../types/protocol.js';
+import { FreeUsageClient } from './evm/free-usage-client.js';
+export interface SellerFreeUsageConfig {
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+    freeUsageContractAddress: string;
+    chainId: number;
+    recordBatchSize?: number;
+    recordFlushIntervalMs?: number;
+}
+export declare class SellerFreeUsageManager {
+    private readonly _signer;
+    private readonly _client;
+    private readonly _domain;
+    private readonly _sellerEvmAddr;
+    private readonly _recordBatchSize;
+    private readonly _recordFlushIntervalMs;
+    private readonly _sessions;
+    private readonly _buyerLocks;
+    constructor(identity: Identity, config: SellerFreeUsageConfig);
+    get client(): FreeUsageClient;
+    handleOpen(buyerPeerId: string, payload: FreeUsageOpenPayload, paymentMux: PaymentMux): void;
+    handleAuth(buyerPeerId: string, payload: FreeUsageAuthPayload, paymentMux: PaymentMux): void;
+    onPeerDisconnect(buyerPeerId: string): void;
+    flushAllPendingRecords(): Promise<void>;
+    reportUsageRequest(buyerPeerId: string, paymentMux: PaymentMux, usage: {
+        requestId?: string;
+        inputTokens: number;
+        outputTokens: number;
+        service?: string;
+    }): void;
+    private _handleOpenInner;
+    private _openOnChain;
+    private _handleAuthInner;
+    private _scheduleRecordFlush;
+    private _clearFlushTimer;
+    private _flushPendingRecord;
+    private _doFlushPendingRecord;
+    private _tryGetExistingSession;
+    private _decodeFreeUsageMetadata;
+}
+//# sourceMappingURL=seller-free-usage-manager.d.ts.map

package/dist/payments/seller-free-usage-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-free-usage-manager.d.ts","sourceRoot":"","sources":["../../src/payments/seller-free-usage-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAS7D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAkDD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;gBAEpD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB;IAc7D,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAU5F,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAU5F,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAoBrC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7C,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACzF,IAAI;YA0CO,gBAAgB;YAyDhB,YAAY;YAiBZ,gBAAgB;IAmF9B,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,mBAAmB;YAkBb,qBAAqB;YA+DrB,sBAAsB;IAQpC,OAAO,CAAC,wBAAwB;CAcjC"}

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