0g-orbit 0.1.0

package/dist/inference.js

@@ -0,0 +1,179 @@
+import { createZGComputeNetworkBroker, } from '@0glabs/0g-serving-broker';
+import { InferenceError, ProviderNotFoundError, TimeoutError } from './errors.js';
+import { withRetry } from './retry.js';
+const DEFAULT_LEDGER_DEPOSIT = 0.1; // 0.1 OG initial deposit
+const AUTO_FUND_INTERVAL = 30_000; // 30 seconds
+const DEFAULT_TIMEOUT = 30_000; // 30 seconds
+export class InferenceClient {
+    broker = null;
+    wallet;
+    network;
+    initialized = false;
+    constructor(network, wallet) {
+        this.network = network;
+        this.wallet = wallet;
+    }
+    async ensureBroker() {
+        if (this.broker && this.initialized)
+            return this.broker;
+        try {
+            // Cast wallet to avoid ESM/CJS ethers type mismatch
+            this.broker = await createZGComputeNetworkBroker(this.wallet, this.network.ledgerContractAddress, this.network.inferenceContractAddress, this.network.fineTuningContractAddress);
+            this.initialized = true;
+            return this.broker;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new InferenceError(`Failed to initialize compute broker: ${msg}`, 'Check your network connection and wallet private key. The compute contracts may be temporarily unavailable.');
+        }
+    }
+    async listServices() {
+        const broker = await this.ensureBroker();
+        return withRetry(async () => {
+            try {
+                const services = await broker.inference.listService();
+                return services.map((s) => ({
+                    provider: s.provider ?? s.address ?? '',
+                    model: s.model ?? '',
+                    url: s.url ?? '',
+                    inputPrice: BigInt(s.inputPrice ?? 0),
+                    outputPrice: BigInt(s.outputPrice ?? 0),
+                    verifiable: Boolean(s.verifiability ?? s.verifiable),
+                }));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new InferenceError(`Failed to list services: ${msg}`, 'The inference contract may be temporarily unavailable. Check your network connection.');
+            }
+        }, { maxAttempts: 3 });
+    }
+    async infer(model, options) {
+        const broker = await this.ensureBroker();
+        // Find a provider for the requested model
+        const providerAddress = options.provider ?? await this.findProvider(model);
+        const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        try {
+            // Ensure ledger exists and has funds
+            await this.ensureLedgerFunded(broker);
+            // Start auto-funding for this provider
+            await broker.inference.startAutoFunding(providerAddress, {
+                interval: AUTO_FUND_INTERVAL,
+            });
+            // Get service metadata (endpoint + model name)
+            const { endpoint, model: providerModel } = await broker.inference.getServiceMetadata(providerAddress);
+            // Build the request content for billing calculation
+            const content = options.messages.map((m) => m.content).join('\n');
+            // Get authenticated headers
+            const headers = await broker.inference.getRequestHeaders(providerAddress, content);
+            // Make the OpenAI-compatible request with timeout + retry
+            const data = await withRetry(() => this.fetchCompletion(endpoint, providerModel, options, headers, timeout), {
+                maxAttempts: 2,
+                baseDelay: 2000,
+                isRetryable: (err) => {
+                    // Don't retry timeouts (user already waited long enough)
+                    if (err instanceof TimeoutError)
+                        return false;
+                    // Retry transient provider errors
+                    if (err instanceof InferenceError) {
+                        const msg = err.message;
+                        return msg.includes('502') || msg.includes('503') || msg.includes('504');
+                    }
+                    return false;
+                },
+            });
+            // Extract chatID for TEE verification
+            const chatID = data._chatID;
+            // Process response (caches fees + verifies TEE signature)
+            let verified = null;
+            try {
+                verified = await broker.inference.processResponse(providerAddress, chatID, data.usage ? JSON.stringify(data.usage) : undefined);
+            }
+            catch {
+                // Verification failure is non-fatal
+                verified = null;
+            }
+            // Stop auto-funding
+            broker.inference.stopAutoFunding(providerAddress);
+            return {
+                content: data.choices?.[0]?.message?.content ?? '',
+                model: data.model ?? providerModel,
+                usage: data.usage
+                    ? {
+                        promptTokens: data.usage.prompt_tokens ?? 0,
+                        completionTokens: data.usage.completion_tokens ?? 0,
+                        totalTokens: data.usage.total_tokens ?? 0,
+                    }
+                    : undefined,
+                verified,
+            };
+        }
+        catch (err) {
+            // Clean up auto-funding on error
+            broker.inference.stopAutoFunding(providerAddress);
+            if (err instanceof InferenceError || err instanceof TimeoutError || err instanceof ProviderNotFoundError)
+                throw err;
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new InferenceError(`Inference failed: ${msg}`);
+        }
+    }
+    async fetchCompletion(endpoint, providerModel, options, headers, timeout) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        let response;
+        try {
+            response = await fetch(`${endpoint}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+                body: JSON.stringify({
+                    model: providerModel,
+                    messages: options.messages,
+                    temperature: options.temperature,
+                    max_tokens: options.maxTokens,
+                }),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new TimeoutError(`Inference request timed out after ${timeout / 1000}s.`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new InferenceError(`Provider returned ${response.status}: ${body}`, response.status === 429
+                ? 'Provider is rate-limited. Wait a moment and retry, or try a different provider.'
+                : response.status >= 500
+                    ? 'The provider is experiencing issues. Try a different provider with the provider option.'
+                    : 'Check the model name and request parameters.');
+        }
+        const data = (await response.json());
+        const chatID = response.headers.get('ZG-Res-Key') ?? data.id ?? undefined;
+        return { ...data, _chatID: chatID };
+    }
+    async findProvider(model) {
+        const services = await this.listServices();
+        const match = services.find((s) => s.model.toLowerCase() === model.toLowerCase());
+        if (!match) {
+            const available = [...new Set(services.map((s) => s.model))].join(', ') || 'none';
+            throw new ProviderNotFoundError(`No provider found for model "${model}". Available models: ${available}`);
+        }
+        return match.provider;
+    }
+    async ensureLedgerFunded(broker) {
+        try {
+            await broker.ledger.getLedger();
+        }
+        catch {
+            // Ledger doesn't exist yet — create it with initial deposit
+            await broker.ledger.addLedger(DEFAULT_LEDGER_DEPOSIT);
+        }
+    }
+}
+//# sourceMappingURL=inference.js.map

package/dist/inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.js","sourceRoot":"","sources":["../src/inference.ts"],"names":[],"mappings":"AACA,OAAO,EACH,4BAA4B,GAE/B,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,sBAAsB,GAAG,GAAG,CAAA,CAAC,yBAAyB;AAC5D,MAAM,kBAAkB,GAAG,MAAM,CAAA,CAAC,aAAa;AAC/C,MAAM,eAAe,GAAG,MAAM,CAAA,CAAC,aAAa;AAa5C,MAAM,OAAO,eAAe;IAChB,MAAM,GAAkC,IAAI,CAAA;IAC5C,MAAM,CAAQ;IACd,OAAO,CAAe;IACtB,WAAW,GAAG,KAAK,CAAA;IAE3B,YAAY,OAAsB,EAAE,MAAc;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC;IAEO,KAAK,CAAC,YAAY;QACtB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,MAAM,CAAA;QAEvD,IAAI,CAAC;YACD,oDAAoD;YACpD,IAAI,CAAC,MAAM,GAAG,MAAM,4BAA4B,CAC5C,IAAI,CAAC,MAAa,EAClB,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAClC,IAAI,CAAC,OAAO,CAAC,wBAAwB,EACrC,IAAI,CAAC,OAAO,CAAC,yBAAyB,CACzC,CAAA;YACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;YACvB,OAAO,IAAI,CAAC,MAAM,CAAA;QACtB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC5D,MAAM,IAAI,cAAc,CACpB,wCAAwC,GAAG,EAAE,EAC7C,6GAA6G,CAChH,CAAA;QACL,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QACxC,OAAO,SAAS,CACZ,KAAK,IAAI,EAAE;YACP,IAAI,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAA;gBACrD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;oBAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE;oBACvC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;oBACpB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;oBAChB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;oBACrC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;oBACvC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,UAAU,CAAC;iBACvD,CAAC,CAAC,CAAA;YACP,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAC5D,MAAM,IAAI,cAAc,CACpB,4BAA4B,GAAG,EAAE,EACjC,uFAAuF,CAC1F,CAAA;YACL,CAAC;QACL,CAAC,EACD,EAAE,WAAW,EAAE,CAAC,EAAE,CACrB,CAAA;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CACP,KAAa,EACb,OAAqB;QAErB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QAExC,0CAA0C;QAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAA;QAElD,IAAI,CAAC;YACD,qCAAqC;YACrC,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;YAErC,uCAAuC;YACvC,MAAM,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,eAAe,EAAE;gBACrD,QAAQ,EAAE,kBAAkB;aAC/B,CAAC,CAAA;YAEF,+CAA+C;YAC/C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GACpC,MAAM,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAA;YAE9D,oDAAoD;YACpD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAEjE,4BAA4B;YAC5B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,iBAAiB,CACpD,eAAe,EACf,OAAO,CACV,CAAA;YAED,0DAA0D;YAC1D,MAAM,IAAI,GAAG,MAAM,SAAS,CACxB,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAC9E;gBACI,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;oBACjB,yDAAyD;oBACzD,IAAI,GAAG,YAAY,YAAY;wBAAE,OAAO,KAAK,CAAA;oBAC7C,kCAAkC;oBAClC,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;wBAChC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAA;wBACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;oBAC5E,CAAC;oBACD,OAAO,KAAK,CAAA;gBAChB,CAAC;aACJ,CACJ,CAAA;YAED,sCAAsC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;YAE3B,0DAA0D;YAC1D,IAAI,QAAQ,GAAmB,IAAI,CAAA;YACnC,IAAI,CAAC;gBACD,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAC7C,eAAe,EACf,MAAM,EACN,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CACtD,CAAA;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,oCAAoC;gBACpC,QAAQ,GAAG,IAAI,CAAA;YACnB,CAAC;YAED,oBAAoB;YACpB,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,eAAe,CAAC,CAAA;YAEjD,OAAO;gBACH,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;gBAClD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa;gBAClC,KAAK,EAAE,IAAI,CAAC,KAAK;oBACb,CAAC,CAAC;wBACI,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC;wBAC3C,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC;wBACnD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC;qBAC5C;oBACH,CAAC,CAAC,SAAS;gBACf,QAAQ;aACX,CAAA;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,iCAAiC;YACjC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,eAAe,CAAC,CAAA;YAEjD,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,YAAY,qBAAqB;gBAAE,MAAM,GAAG,CAAA;YACnH,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC5D,MAAM,IAAI,cAAc,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAA;QACxD,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,eAAe,CACzB,QAAgB,EAChB,aAAqB,EACrB,OAAqB,EACrB,OAAwC,EACxC,OAAe;QAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;QAE3D,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACD,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,mBAAmB,EAAE;gBACnD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACL,cAAc,EAAE,kBAAkB;oBAClC,GAAG,OAAO;iBACb;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,KAAK,EAAE,aAAa;oBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,UAAU,EAAE,OAAO,CAAC,SAAS;iBAChC,CAAC;gBACF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC5B,CAAC,CAAA;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACpD,MAAM,IAAI,YAAY,CAClB,qCAAqC,OAAO,GAAG,IAAI,IAAI,CAC1D,CAAA;YACL,CAAC;YACD,MAAM,GAAG,CAAA;QACb,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAClD,MAAM,IAAI,cAAc,CACpB,qBAAqB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,EAC/C,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACnB,CAAC,CAAC,iFAAiF;gBACnF,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;oBACtB,CAAC,CAAC,yFAAyF;oBAC3F,CAAC,CAAC,8CAA8C,CACzD,CAAA;QACL,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAA;QAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,SAAS,CAAA;QAEzE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IACvC,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAa;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CACvD,CAAA;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAA;YACjF,MAAM,IAAI,qBAAqB,CAC3B,gCAAgC,KAAK,wBAAwB,SAAS,EAAE,CAC3E,CAAA;QACL,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAA;IACzB,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC5B,MAA8B;QAE9B,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACL,4DAA4D;YAC5D,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAA;QACzD,CAAC;IACL,CAAC;CACJ"}

package/dist/networks.d.ts

@@ -0,0 +1,16 @@
+export type NetworkName = 'testnet' | 'mainnet';
+export interface NetworkConfig {
+    name: NetworkName;
+    chainId: bigint;
+    rpcUrl: string;
+    /** Fallback RPC URLs, tried in order if the primary fails */
+    rpcUrls: string[];
+    indexerUrl: string;
+    flowContractAddress: string;
+    ledgerContractAddress: string;
+    inferenceContractAddress: string;
+    fineTuningContractAddress: string;
+}
+export declare const NETWORKS: Record<NetworkName, NetworkConfig>;
+export declare function getNetwork(nameOrChainId: NetworkName | bigint): NetworkConfig;
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,wBAAwB,EAAE,MAAM,CAAA;IAChC,yBAAyB,EAAE,MAAM,CAAA;CACpC;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,CA+BvD,CAAA;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,GAAG,aAAa,CAa7E"}

package/dist/networks.js

@@ -0,0 +1,48 @@
+export const NETWORKS = {
+    testnet: {
+        name: 'testnet',
+        chainId: 16602n,
+        rpcUrl: 'https://evmrpc-testnet.0g.ai',
+        rpcUrls: [
+            'https://evmrpc-testnet.0g.ai',
+            'https://16600-rpc.testnet.0g.ai',
+            'https://og-testnet-evm-rpc.allthatnode.com',
+        ],
+        indexerUrl: 'https://indexer-storage-testnet-turbo.0g.ai',
+        flowContractAddress: '0xbD2C3F0E65eDF5582141C35969d66e34e4E6BF80',
+        ledgerContractAddress: '0xE70830508dAc0A97e6c087c75f402f9Be669E406',
+        inferenceContractAddress: '0xa79F4c8311FF93C06b8CfB403690cc987c93F91E',
+        fineTuningContractAddress: '0xC6C075D8039763C8f1EbE580be5ADdf2fd6941bA',
+    },
+    mainnet: {
+        name: 'mainnet',
+        chainId: 16661n,
+        rpcUrl: 'https://evmrpc.0g.ai',
+        rpcUrls: [
+            'https://evmrpc.0g.ai',
+            'https://0g-rpc-evm01.validatorvn.com',
+            'https://rpc.0g.thirdweb.com',
+        ],
+        indexerUrl: 'https://indexer-storage.0g.ai',
+        flowContractAddress: '0x0460aA47b41a66694c0a73f667a1b795A5ED3556',
+        ledgerContractAddress: '0x2dE54c845Cd948B72D2e32e39586fe89607074E3',
+        inferenceContractAddress: '0x47340d900bdFec2BD393c626E12ea0656F938d84',
+        fineTuningContractAddress: '0x4e3474095518883744ddf135b7E0A23301c7F9c0',
+    },
+};
+export function getNetwork(nameOrChainId) {
+    if (typeof nameOrChainId === 'string') {
+        const config = NETWORKS[nameOrChainId];
+        if (!config)
+            throw new Error(`Unknown network: ${nameOrChainId}`);
+        // Return a copy so overrides don't mutate the original
+        return { ...config, rpcUrls: [...config.rpcUrls] };
+    }
+    for (const config of Object.values(NETWORKS)) {
+        if (config.chainId === nameOrChainId) {
+            return { ...config, rpcUrls: [...config.rpcUrls] };
+        }
+    }
+    throw new Error(`Unknown chain ID: ${nameOrChainId}`);
+}
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,QAAQ,GAAuC;IACxD,OAAO,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,8BAA8B;QACtC,OAAO,EAAE;YACL,8BAA8B;YAC9B,iCAAiC;YACjC,4CAA4C;SAC/C;QACD,UAAU,EAAE,6CAA6C;QACzD,mBAAmB,EAAE,4CAA4C;QACjE,qBAAqB,EAAE,4CAA4C;QACnE,wBAAwB,EAAE,4CAA4C;QACtE,yBAAyB,EAAE,4CAA4C;KAC1E;IACD,OAAO,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,sBAAsB;QAC9B,OAAO,EAAE;YACL,sBAAsB;YACtB,sCAAsC;YACtC,6BAA6B;SAChC;QACD,UAAU,EAAE,+BAA+B;QAC3C,mBAAmB,EAAE,4CAA4C;QACjE,qBAAqB,EAAE,4CAA4C;QACnE,wBAAwB,EAAE,4CAA4C;QACtE,yBAAyB,EAAE,4CAA4C;KAC1E;CACJ,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,aAAmC;IAC1D,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;QACtC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAA;QACjE,uDAAuD;QACvD,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;IACtD,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;YACnC,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QACtD,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,aAAa,EAAE,CAAC,CAAA;AACzD,CAAC"}

package/dist/orbit.d.ts

@@ -0,0 +1,27 @@
+import type { NetworkConfig } from './networks.js';
+import { StorageClient } from './storage.js';
+import { InferenceClient } from './inference.js';
+import type { OrbitConfig, StoreResult, StoreOptions, RetrieveOptions, InferResult, InferOptions, ServiceInfo, AccountStatus } from './types.js';
+export declare class Orbit {
+    readonly network: NetworkConfig;
+    readonly storage: StorageClient;
+    readonly inference: InferenceClient;
+    private wallet;
+    private provider;
+    private constructor();
+    /**
+     * Connect to the 0G network. This is the primary entry point.
+     *
+     * Tries the primary RPC URL first, then falls back to alternates.
+     * If privateKey is not provided, reads from PRIVATE_KEY env var.
+     */
+    static connect(config: OrbitConfig): Promise<Orbit>;
+    store(filePath: string, options?: StoreOptions): Promise<StoreResult>;
+    storeData(data: string | Buffer | Uint8Array, options?: StoreOptions): Promise<StoreResult>;
+    retrieve(rootHash: string, outputPath: string, options?: RetrieveOptions): Promise<void>;
+    infer(model: string, options: InferOptions): Promise<InferResult>;
+    listServices(): Promise<ServiceInfo[]>;
+    status(): Promise<AccountStatus>;
+    get address(): string;
+}
+//# sourceMappingURL=orbit.d.ts.map

package/dist/orbit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.d.ts","sourceRoot":"","sources":["../src/orbit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,eAAe,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EAChB,MAAM,YAAY,CAAA;AAGnB,qBAAa,KAAK;IACd,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAiB;IAEjC,OAAO;IAYP;;;;;OAKG;WACU,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAuEnD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrE,SAAS,CACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EAClC,OAAO,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC,WAAW,CAAC;IAIjB,QAAQ,CACV,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC;IAMV,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAIjE,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAMtC,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAWtC,IAAI,OAAO,IAAI,MAAM,CAEpB;CACJ"}

package/dist/orbit.js

@@ -0,0 +1,108 @@
+import { Wallet, JsonRpcProvider } from 'ethers';
+import { getNetwork } from './networks.js';
+import { StorageClient } from './storage.js';
+import { InferenceClient } from './inference.js';
+import { ConnectionError } from './errors.js';
+export class Orbit {
+    network;
+    storage;
+    inference;
+    wallet;
+    provider;
+    constructor(network, wallet, provider) {
+        this.network = network;
+        this.wallet = wallet;
+        this.provider = provider;
+        this.storage = new StorageClient(network, wallet);
+        this.inference = new InferenceClient(network, wallet);
+    }
+    /**
+     * Connect to the 0G network. This is the primary entry point.
+     *
+     * Tries the primary RPC URL first, then falls back to alternates.
+     * If privateKey is not provided, reads from PRIVATE_KEY env var.
+     */
+    static async connect(config) {
+        // Resolve private key: explicit > env var
+        const privateKey = config.privateKey ?? process.env.PRIVATE_KEY;
+        if (!privateKey) {
+            throw new ConnectionError('No private key provided.', 'Pass privateKey in config or set the PRIVATE_KEY environment variable. Example: PRIVATE_KEY=0x... npx tsx index.ts');
+        }
+        const networkConfig = getNetwork(config.network);
+        // Allow overrides
+        if (config.rpcUrl)
+            networkConfig.rpcUrl = config.rpcUrl;
+        if (config.indexerUrl)
+            networkConfig.indexerUrl = config.indexerUrl;
+        // Build candidate RPC URLs: explicit override first, then the fallback list
+        const rpcUrls = config.rpcUrl
+            ? [config.rpcUrl]
+            : networkConfig.rpcUrls;
+        // Try each RPC URL until one connects
+        let lastError = null;
+        for (const url of rpcUrls) {
+            try {
+                const provider = new JsonRpcProvider(url);
+                const wallet = new Wallet(privateKey, provider);
+                const chainId = (await provider.getNetwork()).chainId;
+                if (chainId !== networkConfig.chainId) {
+                    throw new ConnectionError(`Chain ID mismatch: expected ${networkConfig.chainId}, got ${chainId}`, `Your RPC endpoint is on a different network. Use the correct RPC URL for ${networkConfig.name}.`);
+                }
+                // Lock in the working URL
+                networkConfig.rpcUrl = url;
+                // Check balance and warn if zero (non-blocking)
+                try {
+                    const balance = await provider.getBalance(wallet.address);
+                    if (balance === 0n) {
+                        console.warn(`[0G Orbit] Warning: wallet ${wallet.address} has 0 OG balance on ${networkConfig.name}. ` +
+                            `Get testnet tokens at https://faucet.0g.ai`);
+                    }
+                }
+                catch {
+                    // Balance check failure is non-fatal
+                }
+                return new Orbit(networkConfig, wallet, provider);
+            }
+            catch (err) {
+                // Chain ID mismatch is not a transient failure — don't try other URLs
+                if (err instanceof ConnectionError && err.message.includes('Chain ID mismatch')) {
+                    throw err;
+                }
+                lastError = err instanceof Error ? err : new Error(String(err));
+            }
+        }
+        const tried = rpcUrls.join(', ');
+        throw new ConnectionError(`Failed to connect to any RPC endpoint. Tried: ${tried}. Last error: ${lastError?.message ?? 'unknown'}`, 'All RPC endpoints are unreachable. Check your internet connection, or provide a custom RPC URL with the rpcUrl option.');
+    }
+    // --- Storage shortcuts ---
+    async store(filePath, options) {
+        return this.storage.store(filePath, options);
+    }
+    async storeData(data, options) {
+        return this.storage.storeData(data, options);
+    }
+    async retrieve(rootHash, outputPath, options) {
+        return this.storage.retrieve(rootHash, outputPath, options);
+    }
+    // --- Inference shortcuts ---
+    async infer(model, options) {
+        return this.inference.infer(model, options);
+    }
+    async listServices() {
+        return this.inference.listServices();
+    }
+    // --- Account ---
+    async status() {
+        const balance = await this.provider.getBalance(this.wallet.address);
+        const balanceOG = Number(balance) / 1e18;
+        return {
+            balance: balanceOG.toFixed(6),
+            network: this.network.name,
+            address: this.wallet.address,
+        };
+    }
+    get address() {
+        return this.wallet.address;
+    }
+}
+//# sourceMappingURL=orbit.js.map

package/dist/orbit.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,23 @@
+export interface RetryOptions {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Base delay between retries in ms (default: 1000). Doubles each retry. */
+    baseDelay?: number;
+    /** Maximum delay cap in ms (default: 10000) */
+    maxDelay?: number;
+    /** Predicate to decide if an error is retryable (default: transient errors only) */
+    isRetryable?: (err: unknown) => boolean;
+    /** Called before each retry with attempt number and error */
+    onRetry?: (attempt: number, err: unknown) => void;
+}
+/**
+ * Retry an async operation with exponential backoff.
+ * Only retries on transient errors (network, timeout, 5xx) by default.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Determines if an error is transient and worth retrying.
+ * Covers: network failures, timeouts, RPC errors, 5xx responses.
+ */
+export declare function isTransientError(err: unknown): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IACvC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACpD;AASD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAiCtD"}

package/dist/retry.js

@@ -0,0 +1,90 @@
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    maxDelay: 10_000,
+    isRetryable: isTransientError,
+};
+/**
+ * Retry an async operation with exponential backoff.
+ * Only retries on transient errors (network, timeout, 5xx) by default.
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt === opts.maxAttempts || !opts.isRetryable(err)) {
+                throw err;
+            }
+            if (options.onRetry) {
+                options.onRetry(attempt, err);
+            }
+            // Exponential backoff with jitter
+            const delay = Math.min(opts.baseDelay * Math.pow(2, attempt - 1) + Math.random() * 500, opts.maxDelay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Determines if an error is transient and worth retrying.
+ * Covers: network failures, timeouts, RPC errors, 5xx responses.
+ */
+export function isTransientError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const msg = err.message.toLowerCase();
+    // Network-level failures
+    if (msg.includes('econnrefused'))
+        return true;
+    if (msg.includes('econnreset'))
+        return true;
+    if (msg.includes('etimedout'))
+        return true;
+    if (msg.includes('enotfound'))
+        return true;
+    if (msg.includes('epipe'))
+        return true;
+    if (msg.includes('fetch failed'))
+        return true;
+    if (msg.includes('network error'))
+        return true;
+    // Timeout
+    if (msg.includes('timeout'))
+        return true;
+    if (err.name === 'AbortError')
+        return true;
+    // RPC-level transient errors
+    if (msg.includes('server error'))
+        return true;
+    if (msg.includes('bad gateway'))
+        return true;
+    if (msg.includes('service unavailable'))
+        return true;
+    if (msg.includes('rate limit'))
+        return true;
+    if (msg.includes('429'))
+        return true;
+    if (msg.includes('502'))
+        return true;
+    if (msg.includes('503'))
+        return true;
+    if (msg.includes('504'))
+        return true;
+    // ethers provider errors
+    if (msg.includes('missing response'))
+        return true;
+    if (msg.includes('connection error'))
+        return true;
+    if (msg.includes('could not detect network'))
+        return true;
+    return false;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,26 @@
+import type { Signer } from 'ethers';
+import type { NetworkConfig } from './networks.js';
+import type { StoreResult, StoreOptions, RetrieveOptions } from './types.js';
+export declare class StorageClient {
+    private indexer;
+    private rpcUrl;
+    private signer;
+    constructor(network: NetworkConfig, signer: Signer);
+    /**
+     * Upload a file to 0G Storage by file path.
+     * Retries transient failures automatically. Gas escalates on each retry.
+     */
+    store(filePath: string, options?: StoreOptions): Promise<StoreResult>;
+    /**
+     * Upload raw data (string, Buffer, or Uint8Array) to 0G Storage.
+     * Writes to a temp file, uploads, then cleans up.
+     */
+    storeData(data: string | Buffer | Uint8Array, options?: StoreOptions): Promise<StoreResult>;
+    private _store;
+    /**
+     * Download a file from 0G Storage by root hash.
+     */
+    retrieve(rootHash: string, outputPath: string, options?: RetrieveOptions): Promise<void>;
+    private _retrieve;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAO5E,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAQ;gBAEV,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAMlD;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB/E;;;OAGG;IACG,SAAS,CACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EAClC,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC;YAUT,MAAM;IA4DpB;;OAEG;IACG,QAAQ,CACV,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC;YAOF,SAAS;CAmB1B"}