@antseed/node 0.1.0

package/dist/discovery/profile-search.js

@@ -0,0 +1,75 @@
+/**
+ * In-memory search index for cached peer profiles.
+ */
+export class ProfileSearchIndex {
+    profiles = new Map();
+    addProfile(profile) {
+        this.profiles.set(profile.peerId, profile);
+    }
+    removeProfile(peerId) {
+        this.profiles.delete(peerId);
+    }
+    getProfile(peerId) {
+        return this.profiles.get(peerId) ?? null;
+    }
+    getAllProfiles() {
+        return Array.from(this.profiles.values());
+    }
+    /**
+     * Search profiles with relevance scoring.
+     */
+    search(query) {
+        const results = [];
+        for (const profile of this.profiles.values()) {
+            let score = 0;
+            // Filter by capability (hard filter)
+            if (query.capability) {
+                if (!profile.capabilities.includes(query.capability))
+                    continue;
+                score += 10;
+            }
+            // Filter by region (boost score)
+            if (query.region) {
+                if (profile.region.toLowerCase() === query.region.toLowerCase()) {
+                    score += 5;
+                }
+            }
+            // Tag matching (boost score)
+            if (query.tags && query.tags.length > 0) {
+                const profileTags = new Set(profile.tags.map(t => t.toLowerCase()));
+                let tagMatches = 0;
+                for (const tag of query.tags) {
+                    if (profileTags.has(tag.toLowerCase())) {
+                        tagMatches++;
+                    }
+                }
+                if (tagMatches > 0) {
+                    score += tagMatches * 3;
+                }
+            }
+            // Text search in name and description
+            if (query.text) {
+                const text = query.text.toLowerCase();
+                if (profile.displayName.toLowerCase().includes(text)) {
+                    score += 8;
+                }
+                if (profile.description.toLowerCase().includes(text)) {
+                    score += 4;
+                }
+                if (profile.tags.some(t => t.toLowerCase().includes(text))) {
+                    score += 2;
+                }
+            }
+            if (score > 0) {
+                results.push({ profile, relevanceScore: score });
+            }
+        }
+        // Sort by relevance (descending)
+        results.sort((a, b) => b.relevanceScore - a.relevanceScore);
+        return results;
+    }
+    get size() {
+        return this.profiles.size;
+    }
+}
+//# sourceMappingURL=profile-search.js.map

package/dist/discovery/profile-search.js.map

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

package/dist/discovery/reputation-verifier.d.ts

@@ -0,0 +1,25 @@
+import type { BaseEscrowClient } from "../payments/evm/escrow-client.js";
+import type { PeerMetadata } from "./peer-metadata.js";
+export interface ReputationVerification {
+    /** Whether the claimed reputation matches on-chain data. */
+    valid: boolean;
+    /** The actual on-chain reputation score (weighted average). */
+    actualReputation: number;
+    /** The actual on-chain session count. */
+    actualSessionCount: number;
+    /** The actual on-chain dispute count. */
+    actualDisputeCount: number;
+    /** The claimed on-chain reputation score from metadata. */
+    claimedReputation?: number;
+    /** The claimed on-chain session count from metadata. */
+    claimedSessionCount?: number;
+    /** The claimed on-chain dispute count from metadata. */
+    claimedDisputeCount?: number;
+}
+/**
+ * Verify a peer's claimed on-chain reputation against the Base contract.
+ * Queries the escrow contract using the peer's evmAddress and compares
+ * claimed vs actual reputation values.
+ */
+export declare function verifyReputation(escrowClient: BaseEscrowClient, metadata: PeerMetadata): Promise<ReputationVerification>;
+//# sourceMappingURL=reputation-verifier.d.ts.map

package/dist/discovery/reputation-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-verifier.d.ts","sourceRoot":"","sources":["../../src/discovery/reputation-verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAyBjC"}

package/dist/discovery/reputation-verifier.js

@@ -0,0 +1,27 @@
+/**
+ * Verify a peer's claimed on-chain reputation against the Base contract.
+ * Queries the escrow contract using the peer's evmAddress and compares
+ * claimed vs actual reputation values.
+ */
+export async function verifyReputation(escrowClient, metadata) {
+    if (!metadata.evmAddress) {
+        throw new Error("Metadata does not contain an evmAddress");
+    }
+    const reputation = await escrowClient.getReputation(metadata.evmAddress);
+    const actualReputation = reputation.weightedAverage;
+    const actualSessionCount = reputation.sessionCount;
+    const actualDisputeCount = reputation.disputeCount;
+    const valid = metadata.onChainReputation === actualReputation &&
+        metadata.onChainSessionCount === actualSessionCount &&
+        metadata.onChainDisputeCount === actualDisputeCount;
+    return {
+        valid,
+        actualReputation,
+        actualSessionCount,
+        actualDisputeCount,
+        claimedReputation: metadata.onChainReputation,
+        claimedSessionCount: metadata.onChainSessionCount,
+        claimedDisputeCount: metadata.onChainDisputeCount,
+    };
+}
+//# sourceMappingURL=reputation-verifier.js.map

package/dist/discovery/reputation-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-verifier.js","sourceRoot":"","sources":["../../src/discovery/reputation-verifier.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA8B,EAC9B,QAAsB;IAEtB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEzE,MAAM,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC;IACpD,MAAM,kBAAkB,GAAG,UAAU,CAAC,YAAY,CAAC;IACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,YAAY,CAAC;IAEnD,MAAM,KAAK,GACT,QAAQ,CAAC,iBAAiB,KAAK,gBAAgB;QAC/C,QAAQ,CAAC,mBAAmB,KAAK,kBAAkB;QACnD,QAAQ,CAAC,mBAAmB,KAAK,kBAAkB,CAAC;IAEtD,OAAO;QACL,KAAK;QACL,gBAAgB;QAChB,kBAAkB;QAClB,kBAAkB;QAClB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;KAClD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export { AntseedNode, type NodeConfig, type BuyerPaymentConfig, type NodePaymentsConfig } from './node.js';
+export type { Provider, TaskRequest, TaskEvent, SkillRequest, SkillResponse } from './interfaces/seller-provider.js';
+export type { Router } from './interfaces/buyer-router.js';
+export * from './types/index.js';
+export { loadOrCreateIdentity, type Identity } from './p2p/identity.js';
+export { DHTNode, DEFAULT_DHT_CONFIG } from './discovery/dht-node.js';
+export { OFFICIAL_BOOTSTRAP_NODES, mergeBootstrapNodes, toBootstrapConfig } from './discovery/bootstrap.js';
+export { type PeerMetadata, type ProviderAnnouncement } from './discovery/peer-metadata.js';
+export { MetadataServer, type MetadataServerConfig } from './discovery/metadata-server.js';
+export { MeteringStorage } from './metering/storage.js';
+export { BalanceManager } from './payments/balance-manager.js';
+export { BaseEscrowClient, type BaseEscrowConfig } from './payments/evm/escrow-client.js';
+export { identityToEvmWallet, identityToEvmAddress } from './payments/evm/keypair.js';
+export { NatTraversal, type NatMapping, type NatTraversalResult } from './p2p/nat-traversal.js';
+export { BuyerPaymentManager } from './payments/buyer-payment-manager.js';
+export type { BuyerSessionState, BuyerSessionStatus } from './payments/buyer-payment-manager.js';
+export { ProxyMux } from './proxy/proxy-mux.js';
+export { resolveProvider } from './proxy/provider-detection.js';
+export { DefaultRouter, type DefaultRouterConfig } from './routing/default-router.js';
+export type { AntseedPlugin, AntseedProviderPlugin, AntseedRouterPlugin, PluginConfigKey, ConfigField } from './interfaces/plugin.js';
+export { ProfileManager } from './discovery/profile-manager.js';
+export type { PeerProfile, ProfileCapability } from './types/peer-profile.js';
+export { TrustScoreEngine } from './reputation/trust-engine.js';
+export { UptimeTracker } from './reputation/uptime-tracker.js';
+export { computeTrustScore, DEFAULT_TRUST_WEIGHTS } from './reputation/trust-score.js';
+export type { TrustScore, TrustComponents } from './reputation/trust-score.js';
+export type { UptimeWindow, PeerUptimeRecord } from './reputation/uptime-tracker.js';
+export { ReportManager } from './reputation/report-manager.js';
+export type { PeerReport, ReportReason, ReportEvidence, ReportStatus } from './types/report.js';
+export { RatingManager } from './reputation/rating-manager.js';
+export type { PeerRating, RatingDimension, AggregateRating } from './types/rating.js';
+export { ProfileSearchIndex } from './discovery/profile-search.js';
+export type { ProfileSearchQuery, ProfileSearchResult } from './discovery/profile-search.js';
+export { encryptValue, decryptValue, deriveMachineKey, generateSalt } from './config/encryption.js';
+export { loadPluginConfig, savePluginConfig, addInstance, removeInstance, getInstance, getInstances, updateInstanceConfig, } from './config/plugin-config-manager.js';
+export { loadPluginModule, loadAllPlugins, type LoadedProvider, type LoadedRouter, } from './config/plugin-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3G,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrH,YAAY,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC5G,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACrI,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACnG,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,32 @@
+// Main facade
+export { AntseedNode } from './node.js';
+// Types (re-export everything)
+export * from './types/index.js';
+// Submodule re-exports (commonly used)
+export { loadOrCreateIdentity } from './p2p/identity.js';
+export { DHTNode, DEFAULT_DHT_CONFIG } from './discovery/dht-node.js';
+export { OFFICIAL_BOOTSTRAP_NODES, mergeBootstrapNodes, toBootstrapConfig } from './discovery/bootstrap.js';
+export { MetadataServer } from './discovery/metadata-server.js';
+export { MeteringStorage } from './metering/storage.js';
+export { BalanceManager } from './payments/balance-manager.js';
+export { BaseEscrowClient } from './payments/evm/escrow-client.js';
+export { identityToEvmWallet, identityToEvmAddress } from './payments/evm/keypair.js';
+export { NatTraversal } from './p2p/nat-traversal.js';
+export { BuyerPaymentManager } from './payments/buyer-payment-manager.js';
+export { ProxyMux } from './proxy/proxy-mux.js';
+export { resolveProvider } from './proxy/provider-detection.js';
+export { DefaultRouter } from './routing/default-router.js';
+export { ProfileManager } from './discovery/profile-manager.js';
+// Reputation
+export { TrustScoreEngine } from './reputation/trust-engine.js';
+export { UptimeTracker } from './reputation/uptime-tracker.js';
+export { computeTrustScore, DEFAULT_TRUST_WEIGHTS } from './reputation/trust-score.js';
+export { ReportManager } from './reputation/report-manager.js';
+export { RatingManager } from './reputation/rating-manager.js';
+// Profile search
+export { ProfileSearchIndex } from './discovery/profile-search.js';
+// Plugin config & loading
+export { encryptValue, decryptValue, deriveMachineKey, generateSalt } from './config/encryption.js';
+export { loadPluginConfig, savePluginConfig, addInstance, removeInstance, getInstance, getInstances, updateInstanceConfig, } from './config/plugin-config-manager.js';
+export { loadPluginModule, loadAllPlugins, } from './config/plugin-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,WAAW,EAAqE,MAAM,WAAW,CAAC;AAI3G,+BAA+B;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAiB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE5G,OAAO,EAAE,cAAc,EAA6B,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAyB,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,YAAY,EAA4C,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAA4B,MAAM,6BAA6B,CAAC;AAGtF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,iBAAiB;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGnE,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACnG,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,gBAAgB,EAChB,cAAc,GAGf,MAAM,2BAA2B,CAAA"}

package/dist/interfaces/buyer-router.d.ts

@@ -0,0 +1,21 @@
+import type { PeerInfo } from '../types/peer.js';
+import type { SerializedHttpRequest } from '../types/http.js';
+/**
+ * Interface that buyer nodes implement for peer selection.
+ *
+ * The SDK discovers available sellers via DHT. Your router decides
+ * which seller to send each request to based on price, latency,
+ * reputation, capacity, or any custom logic.
+ *
+ * If you don't provide a router, the SDK uses a default that selects
+ * the cheapest peer with reputation above a minimum threshold.
+ */
+export interface Router {
+    selectPeer(req: SerializedHttpRequest, peers: PeerInfo[]): PeerInfo | null;
+    onResult(peer: PeerInfo, result: {
+        success: boolean;
+        latencyMs: number;
+        tokens: number;
+    }): void;
+}
+//# sourceMappingURL=buyer-router.d.ts.map

package/dist/interfaces/buyer-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer-router.d.ts","sourceRoot":"","sources":["../../src/interfaces/buyer-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,WAAW,MAAM;IACrB,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3E,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;CACV"}

package/dist/interfaces/buyer-router.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buyer-router.js.map

package/dist/interfaces/buyer-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer-router.js","sourceRoot":"","sources":["../../src/interfaces/buyer-router.ts"],"names":[],"mappings":""}

package/dist/interfaces/plugin.d.ts

@@ -0,0 +1,31 @@
+import type { Provider } from './seller-provider.js';
+import type { Router } from './buyer-router.js';
+export interface ConfigField {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'secret' | 'string[]';
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+}
+/** @deprecated Use ConfigField instead */
+export type PluginConfigKey = ConfigField;
+export interface AntseedPluginBase {
+    name: string;
+    displayName: string;
+    version: string;
+    description: string;
+    configSchema?: ConfigField[];
+    /** @deprecated Use configSchema instead */
+    configKeys?: ConfigField[];
+}
+export interface AntseedProviderPlugin extends AntseedPluginBase {
+    type: 'provider';
+    createProvider(config: Record<string, string>): Provider | Promise<Provider>;
+}
+export interface AntseedRouterPlugin extends AntseedPluginBase {
+    type: 'router';
+    createRouter(config: Record<string, string>): Router | Promise<Router>;
+}
+export type AntseedPlugin = AntseedProviderPlugin | AntseedRouterPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/interfaces/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/interfaces/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,WAAW,CAAA;AAEzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,WAAW,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,IAAI,EAAE,UAAU,CAAA;IAChB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,QAAQ,CAAA;IACd,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvE;AAED,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,mBAAmB,CAAA"}

package/dist/interfaces/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/interfaces/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/interfaces/plugin.ts"],"names":[],"mappings":""}

package/dist/interfaces/seller-provider.d.ts

@@ -0,0 +1,69 @@
+import type { SerializedHttpRequest, SerializedHttpResponse } from '../types/http.js';
+import type { ProviderCapability } from '../types/capability.js';
+export interface ProviderTokenPricingUsdPerMillion {
+    inputUsdPerMillion: number;
+    outputUsdPerMillion: number;
+}
+export interface ProviderPricing {
+    defaults: ProviderTokenPricingUsdPerMillion;
+    models?: Record<string, ProviderTokenPricingUsdPerMillion>;
+}
+/**
+ * Interface that seller nodes implement to provide inference.
+ *
+ * Each provider represents one upstream LLM service (e.g., Anthropic, OpenAI, local LLM).
+ * The SDK handles P2P connections, discovery, metering, and payments.
+ * You just handle the HTTP request → response conversion.
+ */
+export interface Provider {
+    /** Unique name for this provider (e.g., 'anthropic', 'openai', 'my-local-llm') */
+    name: string;
+    /** Model IDs this provider supports (e.g., ['claude-sonnet-4-5-20250929', 'claude-opus-4-0-20250514']) */
+    models: string[];
+    /** Seller pricing in USD per 1M tokens (defaults + optional per-model overrides). */
+    pricing: ProviderPricing;
+    /** Maximum concurrent requests this provider can handle */
+    maxConcurrency: number;
+    /**
+     * Handle an incoming inference request and return the response.
+     */
+    handleRequest(req: SerializedHttpRequest): Promise<SerializedHttpResponse>;
+    /** Optional startup hook — validate credentials, warm caches, etc. */
+    init?(): Promise<void>;
+    /** Return current and maximum concurrent request counts */
+    getCapacity(): {
+        current: number;
+        max: number;
+    };
+    /** Capabilities beyond inference (optional — defaults to ['inference']) */
+    capabilities?: ProviderCapability[];
+    /** Handle a long-running agent task. Returns an async iterable of events. */
+    handleTask?(task: TaskRequest): AsyncIterable<TaskEvent>;
+    /** Handle a one-shot skill request. */
+    handleSkill?(skill: SkillRequest): Promise<SkillResponse>;
+}
+export interface TaskRequest {
+    taskId: string;
+    capability: ProviderCapability;
+    input: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskEvent {
+    taskId: string;
+    type: 'status' | 'progress' | 'intermediate' | 'final';
+    data: unknown;
+    timestamp: number;
+}
+export interface SkillRequest {
+    skillId: string;
+    capability: ProviderCapability;
+    input: unknown;
+    inputSchema?: Record<string, unknown>;
+}
+export interface SkillResponse {
+    skillId: string;
+    output: unknown;
+    outputSchema?: Record<string, unknown>;
+    durationMs: number;
+}
+//# sourceMappingURL=seller-provider.d.ts.map

package/dist/interfaces/seller-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-provider.d.ts","sourceRoot":"","sources":["../../src/interfaces/seller-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IAEb,0GAA0G;IAC1G,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,qFAAqF;IACrF,OAAO,EAAE,eAAe,CAAC;IAEzB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE3E,sEAAsE;IACtE,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,2DAA2D;IAC3D,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhD,2EAA2E;IAC3E,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEpC,6EAA6E;IAC7E,UAAU,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAEzD,uCAAuC;IACvC,WAAW,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,CAAC;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/seller-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seller-provider.js.map

package/dist/interfaces/seller-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-provider.js","sourceRoot":"","sources":["../../src/interfaces/seller-provider.ts"],"names":[],"mappings":""}

package/dist/metering/index.d.ts

@@ -0,0 +1,7 @@
+export { estimateTokens, estimateTokensFromContentLength, estimateTokensFromStreamBytes, BYTES_PER_TOKEN, MIN_REQUEST_TOKENS, MIN_RESPONSE_TOKENS } from './token-counter.js';
+export { MeteringStorage } from './storage.js';
+export { ReceiptGenerator, buildSignaturePayload, calculateCost, type Signer } from './receipt-generator.js';
+export { ReceiptVerifier, type SignatureVerifier, type VerifierOptions } from './receipt-verifier.js';
+export { SessionTracker } from './session-tracker.js';
+export { UsageAggregator, type AggregationGranularity, type TimePeriod } from './usage-aggregator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9K,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/metering/index.js

@@ -0,0 +1,7 @@
+export { estimateTokens, estimateTokensFromContentLength, estimateTokensFromStreamBytes, BYTES_PER_TOKEN, MIN_REQUEST_TOKENS, MIN_RESPONSE_TOKENS } from './token-counter.js';
+export { MeteringStorage } from './storage.js';
+export { ReceiptGenerator, buildSignaturePayload, calculateCost } from './receipt-generator.js';
+export { ReceiptVerifier } from './receipt-verifier.js';
+export { SessionTracker } from './session-tracker.js';
+export { UsageAggregator } from './usage-aggregator.js';
+//# sourceMappingURL=index.js.map

package/dist/metering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9K,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,aAAa,EAAe,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAgD,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAgD,MAAM,uBAAuB,CAAC"}

package/dist/metering/receipt-generator.d.ts

@@ -0,0 +1,49 @@
+import type { ProviderType, TokenCount, UsageReceipt } from '../types/metering.js';
+/**
+ * Interface for signing data with the seller's Ed25519 private key.
+ * The actual implementation lives in the identity module (PRD-01).
+ */
+export interface Signer {
+    /**
+     * Sign a message with the seller's Ed25519 private key.
+     * @param message - UTF-8 string to sign
+     * @returns Hex-encoded signature
+     */
+    sign(message: string): string;
+    /** The seller's peer ID (Ed25519 public key hex) */
+    peerId: string;
+}
+/**
+ * Build the canonical string representation of receipt data for signing.
+ * The order and format must be deterministic so both sides produce the
+ * same string from the same receipt data.
+ */
+export declare function buildSignaturePayload(receipt: Omit<UsageReceipt, 'signature'>): string;
+/**
+ * Calculate the cost in USD cents from token count and price.
+ *
+ * @param totalTokens - Total estimated tokens
+ * @param unitPriceCentsPerThousandTokens - Unit price in USD cents per 1,000 tokens
+ * @returns Cost in USD cents (rounded to nearest cent)
+ */
+export declare function calculateCost(totalTokens: number, unitPriceCentsPerThousandTokens: number): number;
+/**
+ * Generates signed usage receipts for the seller side.
+ */
+export declare class ReceiptGenerator {
+    private readonly signer;
+    constructor(signer: Signer);
+    /**
+     * Generate a signed receipt for a completed request.
+     *
+     * @param sessionId - The buyer session ID
+     * @param eventId - The metering event ID
+     * @param provider - Provider used
+     * @param buyerPeerId - Buyer's peer ID
+     * @param tokens - Token estimate
+     * @param unitPriceCentsPerThousandTokens - Effective unit price in USD cents per 1,000 tokens
+     * @returns Signed UsageReceipt
+     */
+    generate(sessionId: string, eventId: string, provider: ProviderType, buyerPeerId: string, tokens: TokenCount, unitPriceCentsPerThousandTokens: number): UsageReceipt;
+}
+//# sourceMappingURL=receipt-generator.d.ts.map

package/dist/metering/receipt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-generator.d.ts","sourceRoot":"","sources":["../../src/metering/receipt-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,MAAM,CAYtF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,GAAG,MAAM,CAGlG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,EAClB,+BAA+B,EAAE,MAAM,GACtC,YAAY;CA0BhB"}

package/dist/metering/receipt-generator.js

@@ -0,0 +1,74 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Build the canonical string representation of receipt data for signing.
+ * The order and format must be deterministic so both sides produce the
+ * same string from the same receipt data.
+ */
+export function buildSignaturePayload(receipt) {
+    return [
+        receipt.receiptId,
+        receipt.sessionId,
+        receipt.eventId,
+        receipt.timestamp.toString(),
+        receipt.provider,
+        receipt.sellerPeerId,
+        receipt.buyerPeerId,
+        receipt.tokens.totalTokens.toString(),
+        receipt.costCents.toString(),
+    ].join('|');
+}
+/**
+ * Calculate the cost in USD cents from token count and price.
+ *
+ * @param totalTokens - Total estimated tokens
+ * @param unitPriceCentsPerThousandTokens - Unit price in USD cents per 1,000 tokens
+ * @returns Cost in USD cents (rounded to nearest cent)
+ */
+export function calculateCost(totalTokens, unitPriceCentsPerThousandTokens) {
+    const raw = (totalTokens / 1000) * unitPriceCentsPerThousandTokens;
+    return raw > 0 ? Math.max(1, Math.round(raw)) : 0;
+}
+/**
+ * Generates signed usage receipts for the seller side.
+ */
+export class ReceiptGenerator {
+    signer;
+    constructor(signer) {
+        this.signer = signer;
+    }
+    /**
+     * Generate a signed receipt for a completed request.
+     *
+     * @param sessionId - The buyer session ID
+     * @param eventId - The metering event ID
+     * @param provider - Provider used
+     * @param buyerPeerId - Buyer's peer ID
+     * @param tokens - Token estimate
+     * @param unitPriceCentsPerThousandTokens - Effective unit price in USD cents per 1,000 tokens
+     * @returns Signed UsageReceipt
+     */
+    generate(sessionId, eventId, provider, buyerPeerId, tokens, unitPriceCentsPerThousandTokens) {
+        const receiptId = randomUUID();
+        const timestamp = Date.now();
+        const costCents = calculateCost(tokens.totalTokens, unitPriceCentsPerThousandTokens);
+        const receiptData = {
+            receiptId,
+            sessionId,
+            eventId,
+            timestamp,
+            provider,
+            sellerPeerId: this.signer.peerId,
+            buyerPeerId,
+            tokens,
+            unitPriceCentsPerThousandTokens,
+            costCents,
+        };
+        const payload = buildSignaturePayload(receiptData);
+        const signature = this.signer.sign(payload);
+        return {
+            ...receiptData,
+            signature,
+        };
+    }
+}
+//# sourceMappingURL=receipt-generator.js.map

package/dist/metering/receipt-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-generator.js","sourceRoot":"","sources":["../../src/metering/receipt-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmBzC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAwC;IAC5E,OAAO;QACL,OAAO,CAAC,SAAS;QACjB,OAAO,CAAC,SAAS;QACjB,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;QAC5B,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,WAAW;QACnB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE;QACrC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;KAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,+BAAuC;IACxF,MAAM,GAAG,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,+BAA+B,CAAC;IACnE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAS;IAEhC,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAiB,EACjB,OAAe,EACf,QAAsB,EACtB,WAAmB,EACnB,MAAkB,EAClB,+BAAuC;QAEvC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;QAErF,MAAM,WAAW,GAAoC;YACnD,SAAS;YACT,SAAS;YACT,OAAO;YACP,SAAS;YACT,QAAQ;YACR,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAChC,WAAW;YACX,MAAM;YACN,+BAA+B;YAC/B,SAAS;SACV,CAAC;QAEF,MAAM,OAAO,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5C,OAAO;YACL,GAAG,WAAW;YACd,SAAS;SACV,CAAC;IACJ,CAAC;CACF"}

package/dist/metering/receipt-verifier.d.ts

@@ -0,0 +1,52 @@
+import type { UsageReceipt, TokenCount, ReceiptVerification } from '../types/metering.js';
+/**
+ * Interface for verifying Ed25519 signatures.
+ * The actual implementation lives in the identity module (PRD-01).
+ */
+export interface SignatureVerifier {
+    /**
+     * Verify an Ed25519 signature.
+     * @param message - The original signed message (UTF-8 string)
+     * @param signature - Hex-encoded signature
+     * @param publicKeyHex - Signer's Ed25519 public key (hex)
+     * @returns true if signature is valid
+     */
+    verify(message: string, signature: string, publicKeyHex: string): boolean;
+}
+export interface VerifierOptions {
+    /**
+     * Maximum acceptable percentage difference between buyer and seller
+     * token estimates before flagging as disputed.
+     * Default: 15 (percent)
+     */
+    disputeThresholdPercent: number;
+}
+/**
+ * Verifies seller-issued usage receipts on the buyer side.
+ */
+export declare class ReceiptVerifier {
+    private readonly signatureVerifier;
+    private readonly options;
+    constructor(signatureVerifier: SignatureVerifier, options?: Partial<VerifierOptions>);
+    /**
+     * Verify a receipt against the buyer's independent token estimate.
+     *
+     * Verification steps:
+     * 1. Verify the Ed25519 signature using the seller's public key
+     * 2. Compare seller's token estimate with buyer's estimate
+     * 3. Calculate percentage difference
+     * 4. Flag as disputed if difference exceeds threshold
+     *
+     * @param receipt - The seller's signed receipt
+     * @param buyerEstimate - The buyer's independent token estimate
+     * @returns ReceiptVerification result
+     */
+    verify(receipt: UsageReceipt, buyerEstimate: TokenCount): ReceiptVerification;
+    /**
+     * Calculate the percentage difference between two token counts.
+     * Formula: abs(a - b) / max(a, b) * 100
+     * Returns 0 if both are 0.
+     */
+    static calculatePercentageDifference(a: number, b: number): number;
+}
+//# sourceMappingURL=receipt-verifier.d.ts.map

package/dist/metering/receipt-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-verifier.d.ts","sourceRoot":"","sources":["../../src/metering/receipt-verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG1F;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3E;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAMD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAKpF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,GAAG,mBAAmB;IAmC7E;;;;OAIG;IACH,MAAM,CAAC,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;CAKnE"}