@antseed/node 0.1.0

package/dist/config/plugin-config-manager.js

@@ -0,0 +1,135 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { encryptValue, decryptValue, deriveMachineKey, generateSalt } from './encryption.js';
+const ENCRYPTED_PREFIX = 'enc:';
+function isEncrypted(value) {
+    return typeof value === 'string' && value.startsWith(ENCRYPTED_PREFIX);
+}
+/**
+ * Load plugin config file. Returns empty config if file doesn't exist.
+ */
+export async function loadPluginConfig(configPath) {
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            instances: Array.isArray(parsed['instances']) ? parsed['instances'] : [],
+            encryption: parsed['encryption'],
+        };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { instances: [] };
+        }
+        throw err;
+    }
+}
+/**
+ * Save plugin config file. Preserves non-plugin fields.
+ */
+export async function savePluginConfig(configPath, pluginConfig) {
+    let existing = {};
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist yet
+    }
+    const merged = {
+        ...existing,
+        instances: pluginConfig.instances,
+        ...(pluginConfig.encryption ? { encryption: pluginConfig.encryption } : {}),
+    };
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, JSON.stringify(merged, null, 2), 'utf-8');
+}
+function getOrCreateEncryption(config) {
+    if (config.encryption?.salt) {
+        const salt = Buffer.from(config.encryption.salt, 'hex');
+        return { key: deriveMachineKey(salt), encryption: config.encryption };
+    }
+    const salt = generateSalt();
+    const encryption = { algorithm: 'aes-256-gcm', kdf: 'scrypt', salt: salt.toString('hex') };
+    return { key: deriveMachineKey(salt), encryption };
+}
+function encryptSecrets(instanceConfig, key, schema) {
+    const result = { ...instanceConfig };
+    const secretKeys = new Set(schema?.filter(f => f.type === 'secret').map(f => f.key) ?? []);
+    for (const [k, v] of Object.entries(result)) {
+        if (secretKeys.has(k) && typeof v === 'string' && !isEncrypted(v)) {
+            result[k] = ENCRYPTED_PREFIX + encryptValue(v, key);
+        }
+    }
+    return result;
+}
+function decryptSecrets(instanceConfig, key) {
+    const result = { ...instanceConfig };
+    for (const [k, v] of Object.entries(result)) {
+        if (isEncrypted(v)) {
+            result[k] = decryptValue(v.slice(ENCRYPTED_PREFIX.length), key);
+        }
+    }
+    return result;
+}
+/**
+ * Add a plugin instance with encrypted secrets.
+ */
+export async function addInstance(configPath, instance, schema) {
+    const config = await loadPluginConfig(configPath);
+    if (config.instances.some(i => i.id === instance.id)) {
+        throw new Error(`Instance "${instance.id}" already exists`);
+    }
+    const { key, encryption } = getOrCreateEncryption(config);
+    config.encryption = encryption;
+    const encrypted = { ...instance, config: encryptSecrets(instance.config, key, schema) };
+    config.instances.push(encrypted);
+    await savePluginConfig(configPath, config);
+}
+/**
+ * Remove an instance by ID.
+ */
+export async function removeInstance(configPath, instanceId) {
+    const config = await loadPluginConfig(configPath);
+    config.instances = config.instances.filter(i => i.id !== instanceId);
+    await savePluginConfig(configPath, config);
+}
+/**
+ * Get a single instance with decrypted secrets.
+ */
+export async function getInstance(configPath, instanceId) {
+    const config = await loadPluginConfig(configPath);
+    const instance = config.instances.find(i => i.id === instanceId);
+    if (!instance)
+        return null;
+    if (!config.encryption?.salt)
+        return instance;
+    const salt = Buffer.from(config.encryption.salt, 'hex');
+    const key = deriveMachineKey(salt);
+    return { ...instance, config: decryptSecrets(instance.config, key) };
+}
+/**
+ * Get all instances with decrypted secrets.
+ */
+export async function getInstances(configPath) {
+    const config = await loadPluginConfig(configPath);
+    if (!config.encryption?.salt)
+        return config.instances;
+    const salt = Buffer.from(config.encryption.salt, 'hex');
+    const key = deriveMachineKey(salt);
+    return config.instances.map(i => ({ ...i, config: decryptSecrets(i.config, key) }));
+}
+/**
+ * Update config for an existing instance.
+ */
+export async function updateInstanceConfig(configPath, instanceId, newConfig, schema) {
+    const config = await loadPluginConfig(configPath);
+    const idx = config.instances.findIndex(i => i.id === instanceId);
+    if (idx === -1)
+        throw new Error(`Instance "${instanceId}" not found`);
+    const { key, encryption } = getOrCreateEncryption(config);
+    config.encryption = encryption;
+    config.instances[idx] = { ...config.instances[idx], config: encryptSecrets(newConfig, key, schema) };
+    await savePluginConfig(configPath, config);
+}
+//# sourceMappingURL=plugin-config-manager.js.map

package/dist/config/plugin-config-manager.js.map

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

package/dist/config/plugin-loader.d.ts

@@ -0,0 +1,25 @@
+import type { Provider } from '../interfaces/seller-provider.js';
+import type { Router } from '../interfaces/buyer-router.js';
+import type { AntseedPlugin } from '../interfaces/plugin.js';
+export interface LoadedProvider {
+    instanceId: string;
+    provider: Provider;
+    pluginName: string;
+}
+export interface LoadedRouter {
+    instanceId: string;
+    router: Router;
+    pluginName: string;
+}
+/**
+ * Load a plugin's default export from its npm package.
+ */
+export declare function loadPluginModule(packageName: string, pluginsDir: string): Promise<AntseedPlugin>;
+/**
+ * Load all enabled plugin instances from config and instantiate them.
+ */
+export declare function loadAllPlugins(configPath: string, pluginsDir: string): Promise<{
+    providers: LoadedProvider[];
+    routers: LoadedRouter[];
+}>;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/config/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/config/plugin-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,KAAK,EAA8C,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAGxG,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BtG;AAYD;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACpF,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAC,CAuBD"}

package/dist/config/plugin-loader.js

@@ -0,0 +1,64 @@
+import { getInstances } from './plugin-config-manager.js';
+/**
+ * Load a plugin's default export from its npm package.
+ */
+export async function loadPluginModule(packageName, pluginsDir) {
+    const { join, resolve } = await import('node:path');
+    const pluginPath = join(pluginsDir, 'node_modules', packageName, 'dist', 'index.js');
+    const resolved = resolve(pluginPath);
+    if (!resolved.startsWith(resolve(pluginsDir))) {
+        throw new Error(`Invalid plugin path: ${packageName}`);
+    }
+    let mod;
+    try {
+        mod = await import(resolved);
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err.message : String(err);
+        throw new Error(`Plugin "${packageName}" failed to load from ${resolved}: ${cause}`);
+    }
+    const plugin = mod.default;
+    if (!plugin || typeof plugin !== 'object') {
+        throw new Error(`Plugin "${packageName}" does not export a valid plugin object`);
+    }
+    const typed = plugin;
+    if (typed.type !== 'provider' && typed.type !== 'router') {
+        throw new Error(`Plugin "${packageName}" has invalid type: ${typed.type}`);
+    }
+    return plugin;
+}
+function instanceConfigToRecord(config) {
+    const result = {};
+    for (const [key, value] of Object.entries(config)) {
+        if (value !== null && value !== undefined) {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+/**
+ * Load all enabled plugin instances from config and instantiate them.
+ */
+export async function loadAllPlugins(configPath, pluginsDir) {
+    const instances = await getInstances(configPath);
+    const providers = [];
+    const routers = [];
+    for (const instance of instances) {
+        if (instance.enabled === false)
+            continue;
+        const plugin = await loadPluginModule(instance.package, pluginsDir);
+        const configRecord = instanceConfigToRecord(instance.config);
+        if (instance.type === 'provider' && plugin.type === 'provider') {
+            const providerPlugin = plugin;
+            const provider = await providerPlugin.createProvider(configRecord);
+            providers.push({ instanceId: instance.id, provider, pluginName: plugin.name });
+        }
+        else if (instance.type === 'router' && plugin.type === 'router') {
+            const routerPlugin = plugin;
+            const router = await routerPlugin.createRouter(configRecord);
+            routers.push({ instanceId: instance.id, router, pluginName: plugin.name });
+        }
+    }
+    return { providers, routers };
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/config/plugin-loader.js.map

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

package/dist/discovery/announcer.d.ts

@@ -0,0 +1,44 @@
+import type { Identity } from "../p2p/identity.js";
+import type { DHTNode } from "./dht-node.js";
+import type { PeerOffering } from "../types/capability.js";
+import type { PeerMetadata } from "./peer-metadata.js";
+import type { BaseEscrowClient } from "../payments/evm/escrow-client.js";
+export interface AnnouncerConfig {
+    identity: Identity;
+    dht: DHTNode;
+    providers: Array<{
+        provider: string;
+        models: string[];
+        maxConcurrency: number;
+    }>;
+    region: string;
+    pricing: Map<string, {
+        defaults: {
+            inputUsdPerMillion: number;
+            outputUsdPerMillion: number;
+        };
+        models?: Record<string, {
+            inputUsdPerMillion: number;
+            outputUsdPerMillion: number;
+        }>;
+    }>;
+    offerings?: PeerOffering[];
+    stakeAmountUSDC?: number;
+    trustScore?: number;
+    escrowClient?: BaseEscrowClient;
+    reannounceIntervalMs: number;
+    signalingPort: number;
+}
+export declare class PeerAnnouncer {
+    private readonly config;
+    private intervalHandle;
+    private readonly loadMap;
+    private _latestMetadata;
+    constructor(config: AnnouncerConfig);
+    announce(): Promise<void>;
+    startPeriodicAnnounce(): void;
+    stopPeriodicAnnounce(): void;
+    updateLoad(providerName: string, currentLoad: number): void;
+    getLatestMetadata(): PeerMetadata | null;
+}
+//# sourceMappingURL=announcer.d.ts.map

package/dist/discovery/announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../../src/discovery/announcer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAK7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CACV,MAAM,EACN;QACE,QAAQ,EAAE;YAAE,kBAAkB,EAAE,MAAM,CAAC;YAAC,mBAAmB,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,kBAAkB,EAAE,MAAM,CAAC;YAAC,mBAAmB,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtF,CACF,CAAC;IACF,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,eAAe,CAA6B;gBAExC,MAAM,EAAE,eAAe;IAI7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4F/B,qBAAqB,IAAI,IAAI;IAe7B,oBAAoB,IAAI,IAAI;IAO5B,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAI3D,iBAAiB,IAAI,YAAY,GAAG,IAAI;CAGzC"}

package/dist/discovery/announcer.js

@@ -0,0 +1,129 @@
+import { signData } from "../p2p/identity.js";
+import { providerTopic, capabilityTopic, topicToInfoHash } from "./dht-node.js";
+import { METADATA_VERSION } from "./peer-metadata.js";
+import { encodeMetadataForSigning } from "./metadata-codec.js";
+import { debugWarn } from "../utils/debug.js";
+import { bytesToHex } from "../utils/hex.js";
+import { identityToEvmAddress } from "../payments/evm/keypair.js";
+export class PeerAnnouncer {
+    config;
+    intervalHandle = null;
+    loadMap = new Map();
+    _latestMetadata = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async announce() {
+        const providers = this.config.providers.map((p) => {
+            const pricing = this.config.pricing.get(p.provider) ?? {
+                defaults: {
+                    inputUsdPerMillion: 0,
+                    outputUsdPerMillion: 0,
+                },
+            };
+            return {
+                provider: p.provider,
+                models: p.models,
+                defaultPricing: pricing.defaults,
+                ...(pricing.models ? { modelPricing: pricing.models } : {}),
+                maxConcurrency: p.maxConcurrency,
+                currentLoad: this.loadMap.get(p.provider) ?? 0,
+            };
+        });
+        const metadata = {
+            peerId: this.config.identity.peerId,
+            version: METADATA_VERSION,
+            providers,
+            ...(this.config.offerings && this.config.offerings.length > 0
+                ? { offerings: this.config.offerings }
+                : {}),
+            ...(this.config.stakeAmountUSDC != null
+                ? { stakeAmountUSDC: this.config.stakeAmountUSDC }
+                : {}),
+            ...(this.config.trustScore != null
+                ? { trustScore: this.config.trustScore }
+                : {}),
+            region: this.config.region,
+            timestamp: Date.now(),
+            signature: "",
+        };
+        // Populate EVM address and on-chain reputation if escrow client is available
+        if (this.config.escrowClient) {
+            try {
+                const evmAddress = identityToEvmAddress(this.config.identity);
+                metadata.evmAddress = evmAddress;
+                const reputation = await this.config.escrowClient.getReputation(evmAddress);
+                metadata.onChainReputation = reputation.weightedAverage;
+                metadata.onChainSessionCount = reputation.sessionCount;
+                metadata.onChainDisputeCount = reputation.disputeCount;
+            }
+            catch {
+                // Silently continue without reputation data
+            }
+        }
+        // Sign metadata
+        const dataToSign = encodeMetadataForSigning(metadata);
+        const signature = await signData(this.config.identity.privateKey, dataToSign);
+        metadata.signature = bytesToHex(signature);
+        this._latestMetadata = metadata;
+        // Announce under each provider topic (continue on failure)
+        for (const p of providers) {
+            try {
+                const topic = providerTopic(p.provider);
+                const infoHash = topicToInfoHash(topic);
+                await this.config.dht.announce(infoHash, this.config.signalingPort);
+            }
+            catch {
+                // DHT may not have peers yet — will retry on next cycle
+            }
+        }
+        // Also announce under the wildcard topic for generic discovery
+        try {
+            const wildcardInfoHash = topicToInfoHash(providerTopic("*"));
+            await this.config.dht.announce(wildcardInfoHash, this.config.signalingPort);
+        }
+        catch {
+            // DHT may not have peers yet — will retry on next cycle
+        }
+        // Announce under each capability topic
+        if (this.config.offerings) {
+            for (const offering of this.config.offerings) {
+                try {
+                    const topic = capabilityTopic(offering.capability, offering.name);
+                    const infoHash = topicToInfoHash(topic);
+                    await this.config.dht.announce(infoHash, this.config.signalingPort);
+                }
+                catch {
+                    // DHT may not have peers yet — will retry on next cycle
+                }
+            }
+        }
+    }
+    startPeriodicAnnounce() {
+        if (this.intervalHandle) {
+            return;
+        }
+        // Announce immediately, then on interval
+        void this.announce().catch((err) => {
+            debugWarn(`[Announcer] Initial announce failed: ${err instanceof Error ? err.message : err}`);
+        });
+        this.intervalHandle = setInterval(() => {
+            void this.announce().catch((err) => {
+                debugWarn(`[Announcer] Periodic announce failed: ${err instanceof Error ? err.message : err}`);
+            });
+        }, this.config.reannounceIntervalMs);
+    }
+    stopPeriodicAnnounce() {
+        if (this.intervalHandle) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+    }
+    updateLoad(providerName, currentLoad) {
+        this.loadMap.set(providerName, currentLoad);
+    }
+    getLatestMetadata() {
+        return this._latestMetadata;
+    }
+}
+//# sourceMappingURL=announcer.js.map

package/dist/discovery/announcer.js.map

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

package/dist/discovery/bootstrap.d.ts

@@ -0,0 +1,13 @@
+export interface BootstrapNode {
+    host: string;
+    port: number;
+    label?: string;
+}
+export declare const OFFICIAL_BOOTSTRAP_NODES: BootstrapNode[];
+export declare function parseBootstrapList(entries: string[]): BootstrapNode[];
+export declare function mergeBootstrapNodes(official: BootstrapNode[], userConfigured: BootstrapNode[]): BootstrapNode[];
+export declare function toBootstrapConfig(nodes: BootstrapNode[]): Array<{
+    host: string;
+    port: number;
+}>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/discovery/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/discovery/bootstrap.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,wBAAwB,EAAE,aAAa,EAOnD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAiBrE;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,cAAc,EAAE,aAAa,EAAE,GAC9B,aAAa,EAAE,CAajB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EAAE,GACrB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAEvC"}

package/dist/discovery/bootstrap.js

@@ -0,0 +1,39 @@
+export const OFFICIAL_BOOTSTRAP_NODES = [
+    { host: "router.bittorrent.com", port: 6881, label: "BitTorrent" },
+    { host: "dht.transmissionbt.com", port: 6881, label: "Transmission" },
+    { host: "router.utorrent.com", port: 6881, label: "uTorrent" },
+    { host: "dht.libtorrent.org", port: 25401, label: "libtorrent" },
+    { host: "router.silotis.us", port: 6881, label: "Silotis" },
+    { host: "dht.aelitis.com", port: 6881, label: "Vuze" },
+];
+export function parseBootstrapList(entries) {
+    return entries.map((entry) => {
+        const lastColon = entry.lastIndexOf(":");
+        if (lastColon === -1) {
+            throw new Error(`Invalid bootstrap entry, missing port: "${entry}"`);
+        }
+        const host = entry.slice(0, lastColon);
+        const portStr = entry.slice(lastColon + 1);
+        const port = parseInt(portStr, 10);
+        if (!Number.isFinite(port) || port < 1 || port > 65535) {
+            throw new Error(`Invalid port in bootstrap entry: "${entry}"`);
+        }
+        return { host, port };
+    });
+}
+export function mergeBootstrapNodes(official, userConfigured) {
+    const seen = new Set();
+    const result = [];
+    for (const node of [...official, ...userConfigured]) {
+        const key = `${node.host}:${node.port}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(node);
+        }
+    }
+    return result;
+}
+export function toBootstrapConfig(nodes) {
+    return nodes.map((n) => ({ host: n.host, port: n.port }));
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/discovery/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/discovery/bootstrap.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE;IAClE,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE;IACrE,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;IAC9D,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE;IAChE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IAC3D,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;CACvD,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,OAAiB;IAClD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,GAAG,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,GAAG,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAyB,EACzB,cAA+B;IAE/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/discovery/default-metadata-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { PeerEndpoint, MetadataResolver } from "./metadata-resolver.js";
+import type { PeerMetadata } from "./peer-metadata.js";
+/**
+ * Default fail-closed metadata resolver.
+ *
+ * Always returns `null`, meaning no peer metadata can be resolved.
+ * This is intentional: without a real transport-specific resolver wired in,
+ * no peers will pass the metadata resolution step and `findSellers()` will
+ * return an empty list. Callers must supply a concrete `MetadataResolver`
+ * implementation (e.g. one that fetches metadata over HTTP or a P2P channel)
+ * to discover real peers.
+ */
+export declare class DefaultMetadataResolver implements MetadataResolver {
+    resolve(_peer: PeerEndpoint): Promise<PeerMetadata | null>;
+}
+//# sourceMappingURL=default-metadata-resolver.d.ts.map

package/dist/discovery/default-metadata-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-metadata-resolver.d.ts","sourceRoot":"","sources":["../../src/discovery/default-metadata-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IACxD,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAGjE"}

package/dist/discovery/default-metadata-resolver.js

@@ -0,0 +1,16 @@
+/**
+ * Default fail-closed metadata resolver.
+ *
+ * Always returns `null`, meaning no peer metadata can be resolved.
+ * This is intentional: without a real transport-specific resolver wired in,
+ * no peers will pass the metadata resolution step and `findSellers()` will
+ * return an empty list. Callers must supply a concrete `MetadataResolver`
+ * implementation (e.g. one that fetches metadata over HTTP or a P2P channel)
+ * to discover real peers.
+ */
+export class DefaultMetadataResolver {
+    async resolve(_peer) {
+        return null;
+    }
+}
+//# sourceMappingURL=default-metadata-resolver.js.map

package/dist/discovery/default-metadata-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-metadata-resolver.js","sourceRoot":"","sources":["../../src/discovery/default-metadata-resolver.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/discovery/dht-health.d.ts

@@ -0,0 +1,38 @@
+export interface DHTHealthSnapshot {
+    nodeCount: number;
+    totalLookups: number;
+    successfulLookups: number;
+    failedLookups: number;
+    totalAnnounces: number;
+    successfulAnnounces: number;
+    failedAnnounces: number;
+    averageLookupLatencyMs: number;
+    isHealthy: boolean;
+}
+export interface HealthThresholds {
+    minNodeCount: number;
+    minLookupSuccessRate: number;
+    maxAvgLookupLatencyMs: number;
+}
+export declare const DEFAULT_HEALTH_THRESHOLDS: HealthThresholds;
+export declare class DHTHealthMonitor {
+    private readonly thresholds;
+    private readonly getNodeCount;
+    private _totalLookups;
+    private _successfulLookups;
+    private _failedLookups;
+    private _totalAnnounces;
+    private _successfulAnnounces;
+    private _failedAnnounces;
+    private readonly latencySamples;
+    private static readonly MAX_LATENCY_SAMPLES;
+    constructor(getNodeCount: () => number, thresholds?: HealthThresholds);
+    recordLookup(success: boolean, latencyMs: number): void;
+    recordAnnounce(success: boolean): void;
+    getSnapshot(): DHTHealthSnapshot;
+    isHealthy(): boolean;
+    reset(): void;
+    private computeAverageLatency;
+    private evaluateHealth;
+}
+//# sourceMappingURL=dht-health.d.ts.map

package/dist/discovery/dht-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dht-health.d.ts","sourceRoot":"","sources":["../../src/discovery/dht-health.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAIvC,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;gBAGhD,YAAY,EAAE,MAAM,MAAM,EAC1B,UAAU,GAAE,gBAA4C;IAM1D,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAcvD,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAStC,WAAW,IAAI,iBAAiB;IAkBhC,SAAS,IAAI,OAAO;IAMpB,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,cAAc;CA0BvB"}