0g-orbit 0.1.0 → 0.2.0

package/dist/orbit.d.ts

@@ -1,14 +1,18 @@
 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';
+import { FineTuningClient } from './fine-tuning.js';
+import type { OrbitConfig, StoreResult, StoreOptions, RetrieveOptions, InferResult, InferOptions, ServiceInfo, AccountStatus, DatasetUploadResult, CreateTaskOptions, FineTuneTask, FineTuneModel, FineTuneProvider } from './types.js';
 export declare class Orbit {
     readonly network: NetworkConfig;
     readonly storage: StorageClient;
     readonly inference: InferenceClient;
+    private _fineTuning;
     private wallet;
     private provider;
     private constructor();
+    /** Lazy-initialized fine-tuning client */
+    get fineTuning(): FineTuningClient;
     /**
      * Connect to the 0G network. This is the primary entry point.
      *
@@ -21,6 +25,12 @@ export declare class Orbit {
     retrieve(rootHash: string, outputPath: string, options?: RetrieveOptions): Promise<void>;
     infer(model: string, options: InferOptions): Promise<InferResult>;
     listServices(): Promise<ServiceInfo[]>;
+    uploadDataset(filePath: string): Promise<DatasetUploadResult>;
+    createFineTuneTask(options: CreateTaskOptions): Promise<FineTuneTask>;
+    getFineTuneTask(providerAddress: string, taskId: string): Promise<FineTuneTask>;
+    downloadModel(providerAddress: string, taskId: string, outputPath: string): Promise<void>;
+    listModels(): Promise<FineTuneModel[]>;
+    listProviders(): Promise<FineTuneProvider[]>;
     status(): Promise<AccountStatus>;
     get address(): string;
 }

package/dist/orbit.d.ts.map

@@ -1 +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"}
+{"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,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,gBAAgB,EACnB,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,WAAW,CAAgC;IACnD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAiB;IAEjC,OAAO;IAYP,0CAA0C;IAC1C,IAAI,UAAU,IAAI,gBAAgB,CAKjC;IAED;;;;;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,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrE,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E,aAAa,CACf,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAIV,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItC,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM5C,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAWtC,IAAI,OAAO,IAAI,MAAM,CAEpB;CACJ"}

package/dist/orbit.js

@@ -2,11 +2,13 @@ import { Wallet, JsonRpcProvider } from 'ethers';
 import { getNetwork } from './networks.js';
 import { StorageClient } from './storage.js';
 import { InferenceClient } from './inference.js';
+import { FineTuningClient } from './fine-tuning.js';
 import { ConnectionError } from './errors.js';
 export class Orbit {
     network;
     storage;
     inference;
+    _fineTuning = null;
     wallet;
     provider;
     constructor(network, wallet, provider) {
@@ -16,6 +18,13 @@ export class Orbit {
         this.storage = new StorageClient(network, wallet);
         this.inference = new InferenceClient(network, wallet);
     }
+    /** Lazy-initialized fine-tuning client */
+    get fineTuning() {
+        if (!this._fineTuning) {
+            this._fineTuning = new FineTuningClient(this.network, this.wallet, this.storage);
+        }
+        return this._fineTuning;
+    }
     /**
      * Connect to the 0G network. This is the primary entry point.
      *
@@ -91,6 +100,25 @@ export class Orbit {
     async listServices() {
         return this.inference.listServices();
     }
+    // --- Fine-Tuning shortcuts ---
+    async uploadDataset(filePath) {
+        return this.fineTuning.uploadDataset(filePath);
+    }
+    async createFineTuneTask(options) {
+        return this.fineTuning.createTask(options);
+    }
+    async getFineTuneTask(providerAddress, taskId) {
+        return this.fineTuning.getTask(providerAddress, taskId);
+    }
+    async downloadModel(providerAddress, taskId, outputPath) {
+        return this.fineTuning.downloadModel(providerAddress, taskId, outputPath);
+    }
+    async listModels() {
+        return this.fineTuning.listModels();
+    }
+    async listProviders() {
+        return this.fineTuning.listProviders();
+    }
     // --- Account ---
     async status() {
         const balance = await this.provider.getBalance(this.wallet.address);

package/dist/orbit.js.map

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

package/dist/storage.js

@@ -73,15 +73,15 @@ export class StorageClient {
             if (uploadErr) {
                 const msg = uploadErr.message;
                 let suggestion = 'Check your OG balance and try again.';
-                if (msg.includes('gas') || msg.includes('underpriced')) {
+                if (msg.includes('insufficient funds') || msg.includes('INSUFFICIENT_FUNDS')) {
+                    suggestion = 'Your wallet needs more OG for gas. Get testnet OG from: https://faucet.0g.ai';
+                }
+                else if (msg.includes('underpriced') || msg.includes('gas required exceeds')) {
                     suggestion = `Gas auto-escalation hit the ceiling (${maxGas} wei). Try a higher maxGasPrice, e.g. { maxGasPrice: ${maxGas * 2}n }`;
                 }
                 else if (msg.includes('timeout') || msg.includes('ETIMEDOUT')) {
                     suggestion = 'The RPC endpoint timed out. Try a different RPC URL with the rpcUrl option.';
                 }
-                else if (msg.includes('insufficient funds')) {
-                    suggestion = 'Your wallet needs more OG for gas. Get testnet OG from: https://faucet.0g.ai';
-                }
                 throw new StorageError(`Upload failed: ${msg}`, suggestion);
             }
             if ('txHash' in result) {

package/dist/storage.js.map

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

package/dist/types.d.ts

@@ -78,4 +78,58 @@ export interface AccountStatus {
     /** Wallet address */
     address: string;
 }
+export interface DatasetUploadResult {
+    /** Merkle root hash of the uploaded dataset in 0G Storage */
+    root: string;
+    /** On-chain transaction hash */
+    txHash: string;
+}
+export interface CreateTaskOptions {
+    /** Name of the base model to fine-tune (e.g. 'Qwen2.5-0.5B-Instruct') */
+    model: string;
+    /** Root hash of the dataset in 0G Storage (from uploadDataset) */
+    dataset: string;
+    /** Provider wallet address */
+    providerAddress: string;
+    /** Training hyperparameters (JSON object or file path) */
+    trainingParams?: {
+        nEpochs?: number;
+        batchSize?: number;
+        learningRate?: number;
+        loraRank?: number;
+        loraAlpha?: number;
+        [key: string]: unknown;
+    };
+}
+export type FineTuneStatus = 'init' | 'setting-up' | 'set-up' | 'training' | 'trained' | 'delivering' | 'delivered' | 'acknowledged' | 'finished' | 'failed';
+export interface FineTuneTask {
+    /** Task ID */
+    id: string;
+    /** Base model name or hash */
+    model: string;
+    /** Dataset root hash */
+    dataset: string;
+    /** Provider address */
+    provider: string;
+    /** Current task status */
+    status: FineTuneStatus;
+    /** Task creation time */
+    createdAt?: string;
+    /** Last update time */
+    updatedAt?: string;
+}
+export interface FineTuneModel {
+    /** Model name */
+    name: string;
+    /** Model configuration (hash, description, etc.) */
+    config: Record<string, string>;
+}
+export interface FineTuneProvider {
+    /** Provider wallet address */
+    address: string;
+    /** Provider endpoint URL */
+    url: string;
+    /** Customized models offered by this provider */
+    models: string[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,WAAW,WAAW;IACxB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IACzB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE;QACJ,YAAY,EAAE,MAAM,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,WAAW,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IACzB,mCAAmC;IACnC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3E,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB;IACnB,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0g-orbit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,15 @@
     "typescript": "^5.4.0",
     "vitest": "^1.6.0"
   },
-  "keywords": ["0g", "blockchain", "ai", "storage", "inference", "sdk", "cli"],
+  "keywords": [
+    "0g",
+    "blockchain",
+    "ai",
+    "storage",
+    "inference",
+    "sdk",
+    "cli"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"

package/src/cli/cli.ts

@@ -3,6 +3,7 @@
 import { Command } from 'commander'
 import { storeCommand, storeDataCommand, retrieveCommand } from './commands/storage.js'
 import { inferCommand, listServicesCommand } from './commands/inference.js'
+import { fineTuneCommand, tasksCommand, modelsCommand } from './commands/fine-tuning.js'
 import { statusCommand } from './commands/account.js'
 import { initCommand } from './commands/init.js'
 
@@ -60,6 +61,31 @@ program
     .option('-n, --network <name>', 'network (testnet|mainnet)', 'testnet')
     .action(listServicesCommand)
 
+program
+    .command('fine-tune <dataset>')
+    .description('Upload dataset and create a fine-tuning task')
+    .option('-n, --network <name>', 'network (testnet|mainnet)', 'testnet')
+    .requiredOption('--model <name>', 'base model to fine-tune')
+    .requiredOption('--provider <address>', 'provider wallet address')
+    .option('--epochs <n>', 'number of training epochs')
+    .option('--batch-size <n>', 'training batch size')
+    .option('--learning-rate <n>', 'learning rate')
+    .option('--lora-rank <n>', 'LoRA rank')
+    .option('--lora-alpha <n>', 'LoRA alpha')
+    .action(fineTuneCommand)
+
+program
+    .command('tasks <provider> [taskId]')
+    .description('List fine-tuning tasks or show a specific task')
+    .option('-n, --network <name>', 'network (testnet|mainnet)', 'testnet')
+    .action(tasksCommand)
+
+program
+    .command('models')
+    .description('List available base models for fine-tuning')
+    .option('-n, --network <name>', 'network (testnet|mainnet)', 'testnet')
+    .action(modelsCommand)
+
 program
     .command('status')
     .description('Show account status and balance')

package/src/cli/commands/fine-tuning.ts

@@ -0,0 +1,169 @@
+import ora from 'ora'
+import chalk from 'chalk'
+import { connectOrbit, formatError } from '../utils.js'
+
+interface FineTuneOpts {
+    network: string
+    model: string
+    provider: string
+    epochs?: string
+    batchSize?: string
+    learningRate?: string
+    loraRank?: string
+    loraAlpha?: string
+}
+
+export async function fineTuneCommand(dataset: string, opts: FineTuneOpts) {
+    const spinner = ora('Connecting to 0G...').start()
+
+    try {
+        const orbit = await connectOrbit(opts.network)
+
+        // Step 1: Upload dataset
+        spinner.text = `Uploading dataset ${dataset}...`
+        const upload = await orbit.uploadDataset(dataset)
+        spinner.text = `Dataset uploaded (root: ${upload.root.slice(0, 12)}...). Creating task...`
+
+        // Step 2: Create task
+        const trainingParams: Record<string, unknown> = {}
+        if (opts.epochs) trainingParams.nEpochs = parseInt(opts.epochs, 10)
+        if (opts.batchSize) trainingParams.batchSize = parseInt(opts.batchSize, 10)
+        if (opts.learningRate) trainingParams.learningRate = parseFloat(opts.learningRate)
+        if (opts.loraRank) trainingParams.loraRank = parseInt(opts.loraRank, 10)
+        if (opts.loraAlpha) trainingParams.loraAlpha = parseInt(opts.loraAlpha, 10)
+
+        const task = await orbit.createFineTuneTask({
+            model: opts.model,
+            dataset: upload.root,
+            providerAddress: opts.provider,
+            trainingParams: Object.keys(trainingParams).length > 0 ? trainingParams : undefined,
+        })
+
+        spinner.succeed('Fine-tuning task created')
+        console.log()
+        console.log(chalk.bold('  Task ID:   ') + chalk.cyan(task.id))
+        console.log(chalk.bold('  Model:     ') + task.model)
+        console.log(chalk.bold('  Dataset:   ') + chalk.dim(upload.root))
+        console.log(chalk.bold('  Provider:  ') + chalk.dim(task.provider))
+        console.log(chalk.bold('  Status:    ') + task.status)
+        console.log()
+        console.log(chalk.dim(`  Check progress: orbit tasks ${task.provider} ${task.id}`))
+    } catch (err) {
+        spinner.fail(chalk.red('Fine-tuning failed'))
+        console.error(chalk.dim(`  ${formatError(err)}`))
+        process.exit(1)
+    }
+}
+
+interface TasksOpts {
+    network: string
+}
+
+export async function tasksCommand(
+    providerAddress: string,
+    taskId: string | undefined,
+    opts: TasksOpts
+) {
+    const spinner = ora('Fetching tasks...').start()
+
+    try {
+        const orbit = await connectOrbit(opts.network)
+
+        if (taskId) {
+            // Show single task + log
+            const task = await orbit.getFineTuneTask(providerAddress, taskId)
+            spinner.stop()
+
+            console.log(chalk.bold(`\n  Task ${task.id}\n`))
+            console.log(`  Status:    ${statusColor(task.status)}`)
+            console.log(`  Model:     ${task.model}`)
+            console.log(`  Dataset:   ${chalk.dim(task.dataset)}`)
+            console.log(`  Provider:  ${chalk.dim(task.provider)}`)
+            if (task.createdAt) console.log(`  Created:   ${task.createdAt}`)
+            if (task.updatedAt) console.log(`  Updated:   ${task.updatedAt}`)
+
+            // Try to get log
+            try {
+                const log = await orbit.fineTuning.getTaskLog(providerAddress, taskId)
+                if (log) {
+                    console.log(chalk.bold('\n  Training Log:\n'))
+                    console.log(chalk.dim(`  ${log.replace(/\n/g, '\n  ')}`))
+                }
+            } catch {
+                // Log not available yet
+            }
+            console.log()
+        } else {
+            // List all tasks for this provider
+            const tasks = await orbit.fineTuning.listTasks(providerAddress)
+            spinner.stop()
+
+            if (tasks.length === 0) {
+                console.log(chalk.dim('\n  No tasks found for this provider.\n'))
+                return
+            }
+
+            console.log(chalk.bold(`\n  ${tasks.length} tasks\n`))
+            for (const task of tasks) {
+                console.log(`  ${chalk.cyan(task.id ?? 'unknown')}  ${statusColor(task.status)}  ${chalk.dim(task.model)}`)
+            }
+            console.log()
+        }
+    } catch (err) {
+        spinner.fail(chalk.red('Failed to fetch tasks'))
+        console.error(chalk.dim(`  ${formatError(err)}`))
+        process.exit(1)
+    }
+}
+
+interface ModelsOpts {
+    network: string
+}
+
+export async function modelsCommand(opts: ModelsOpts) {
+    const spinner = ora('Fetching models...').start()
+
+    try {
+        const orbit = await connectOrbit(opts.network)
+        const models = await orbit.listModels()
+
+        spinner.stop()
+
+        if (models.length === 0) {
+            console.log(chalk.dim('\n  No models available on this network.\n'))
+            return
+        }
+
+        console.log(chalk.bold(`\n  ${models.length} models available for fine-tuning\n`))
+        for (const model of models) {
+            const desc = model.config.description ?? ''
+            const provider = model.config.provider
+            console.log(`  ${chalk.cyan(model.name)}`)
+            if (desc) console.log(chalk.dim(`    ${desc}`))
+            if (provider) console.log(chalk.dim(`    provider: ${provider}`))
+        }
+        console.log()
+    } catch (err) {
+        spinner.fail(chalk.red('Failed to list models'))
+        console.error(chalk.dim(`  ${formatError(err)}`))
+        process.exit(1)
+    }
+}
+
+function statusColor(status: string): string {
+    switch (status) {
+        case 'finished':
+        case 'acknowledged':
+            return chalk.green(status)
+        case 'training':
+        case 'delivering':
+        case 'setting-up':
+            return chalk.yellow(status)
+        case 'failed':
+            return chalk.red(status)
+        case 'delivered':
+            return chalk.blue(status)
+        default:
+            return chalk.dim(status)
+    }
+}

package/src/errors.ts

@@ -77,3 +77,14 @@ export class TimeoutError extends OrbitError {
         this.name = 'TimeoutError'
     }
 }
+
+export class FineTuningError extends OrbitError {
+    constructor(message: string, suggestion?: string) {
+        super(
+            message,
+            'FINE_TUNING_ERROR',
+            suggestion ?? 'Check model and provider availability with orbit.listModels() or orbit.listProviders().'
+        )
+        this.name = 'FineTuningError'
+    }
+}