0g-orbit 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.3] - 2026-04-05
+
+### Fixed
+- **Storage dedup**: Skip re-uploading files that already exist on storage nodes (prevents retrieve regression)
+- **Retrieve crash guard**: Catch SDK-internal null crashes and throw descriptive `StorageError` instead of raw `TypeError`
+
+## [0.2.2] - 2026-04-04
+
+### Fixed
+- Version string synced across root, core, and CLI packages
+
+## [0.2.1] - 2026-04-04
+
+### Changed
+- Added axios override recommendations to mitigate transitive vulnerabilities
+
+## [0.2.0] - 2026-04-04
+
+### Added
+- **Fine-Tuning Support**: Full `FineTuningClient` with dataset upload, task management, and model download
+- CLI commands: `orbit fine-tune`, `orbit tasks`, `orbit models`
+- `FineTuningError` class with actionable suggestions
+- 19 new tests for fine-tuning functionality (85 total tests passing)
+
+### Changed
+- `Orbit` class now exposes `fineTuning` accessor and shortcut methods
+
+## [0.1.0] - 2026-04-03
+
+### Added
+- Initial release
+- `StorageClient` — file and data upload/download to 0G Storage
+- `InferenceClient` — AI inference on 0G Compute Network
+- `Orbit` unified class combining storage, inference, and chain operations
+- CLI with `orbit store`, `orbit retrieve`, `orbit infer`, `orbit services`, `orbit status`, `orbit init`
+- Automatic retry with exponential backoff for transient errors
+- Testnet and mainnet network configurations
+- 66 tests passing

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 cyber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# 0G Orbit
+
+The developer toolkit for [0G](https://0g.ai). Store, infer, fine-tune — one SDK, one CLI, five minutes.
+
+[![CI](https://github.com/cyber/0g-orbit/actions/workflows/ci.yml/badge.svg)](https://github.com/cyber/0g-orbit/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/0g-orbit)](https://www.npmjs.com/package/0g-orbit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/node/v/0g-orbit)](https://nodejs.org)
+
+## What is this?
+
+0G Orbit wraps the 0G storage SDK, serving broker, and chain interactions into a single unified interface. Instead of juggling `@0gfoundation/0g-ts-sdk`, `@0glabs/0g-serving-broker`, and raw ethers calls, you get one `Orbit` class and one `orbit` CLI.
+
+**Storage** — Upload and download files to 0G's decentralized storage network
+**Inference** — Run AI models on 0G's decentralized compute network
+**Fine-Tuning** — Upload datasets, create training tasks, download fine-tuned models
+
+## Install
+
+```bash
+npm install 0g-orbit
+```
+
+## Quick Start
+
+### SDK
+
+```typescript
+import { Orbit } from '0g-orbit'
+
+const orbit = await Orbit.connect({
+  network: 'testnet',
+  privateKey: process.env.PRIVATE_KEY,
+})
+
+// Upload a file
+const { root, txHash } = await orbit.store('./data.json')
+console.log(`Stored: ${root}`)
+
+// Download it back
+await orbit.retrieve(root, './downloaded.json')
+
+// Run AI inference
+const response = await orbit.infer('meta-llama/Llama-3.2-3B-Instruct', {
+  message: 'Explain zero-knowledge proofs in one sentence.',
+})
+console.log(response.content)
+
+// Fine-tune a model
+const dataset = await orbit.uploadDataset('./training-data.jsonl')
+const task = await orbit.createFineTuneTask({
+  model: 'base-model',
+  dataset: dataset.root,
+  providerAddress: '0x...',
+})
+```
+
+### CLI
+
+```bash
+# Set your private key
+export PRIVATE_KEY=0x...
+
+# Upload a file
+orbit store ./my-file.txt
+
+# Download a file
+orbit retrieve <rootHash> ./output.txt
+
+# Run inference
+orbit infer meta-llama/Llama-3.2-3B-Instruct -m "Hello, 0G!"
+
+# List available AI services
+orbit services
+
+# Fine-tune a model
+orbit fine-tune ./dataset.jsonl --model base-model --provider 0x...
+
+# Check account status
+orbit status
+```
+
+## API
+
+### `Orbit.connect(config)`
+
+Creates a connected Orbit instance.
+
+| Option | Type | Description |
+|---|---|---|
+| `network` | `'testnet' \| 'mainnet'` | Network to connect to |
+| `privateKey` | `string?` | Wallet private key (falls back to `PRIVATE_KEY` env var) |
+| `rpcUrl` | `string?` | Custom RPC URL |
+
+### Storage
+
+| Method | Description |
+|---|---|
+| `orbit.store(path, options?)` | Upload a file, returns `{ root, txHash }` |
+| `orbit.storeData(text, options?)` | Upload a text string |
+| `orbit.retrieve(rootHash, outputPath, options?)` | Download a file by root hash |
+
+### Inference
+
+| Method | Description |
+|---|---|
+| `orbit.infer(model, options)` | Run AI inference, returns `{ content, tokensUsed }` |
+| `orbit.listServices()` | List available AI services on the network |
+
+### Fine-Tuning
+
+| Method | Description |
+|---|---|
+| `orbit.uploadDataset(path)` | Upload a training dataset to storage |
+| `orbit.createFineTuneTask(options)` | Create a fine-tuning task |
+| `orbit.getFineTuneTask(provider, taskId)` | Check task status |
+| `orbit.downloadModel(provider, taskId, outputDir)` | Download a fine-tuned model |
+| `orbit.listModels()` | List available base models |
+| `orbit.listProviders()` | List fine-tuning providers |
+
+### Direct Client Access
+
+For advanced usage, access the underlying clients directly:
+
+```typescript
+orbit.storage    // StorageClient
+orbit.inference  // InferenceClient
+orbit.fineTuning // FineTuningClient
+```
+
+## Security
+
+This package has transitive dependencies with known vulnerabilities (from upstream 0G SDKs). To mitigate, add this to your project's `package.json`:
+
+```json
+{
+  "overrides": {
+    "axios": "1.14.0"
+  }
+}
+```
+
+See [SECURITY.md](SECURITY.md) for details.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/cli/cli.js

@@ -9,7 +9,7 @@ const program = new Command();
 program
     .name('orbit')
     .description('The developer toolkit for 0G')
-    .version('0.1.0');
+    .version('0.2.3');
 program
     .command('init')
     .description('Initialize a new 0G project')

package/dist/storage.d.ts.map

@@ -1 +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"}
+{"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;IA0EpB;;OAEG;IACG,QAAQ,CACV,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC;YAOF,SAAS;CA6B1B"}

package/dist/storage.js

@@ -59,6 +59,20 @@ export class StorageClient {
             if (treeErr || !tree) {
                 throw new StorageError(`Failed to compute merkle tree: ${treeErr?.message ?? 'unknown error'}`, 'Ensure the file exists, is readable, and is not empty.');
             }
+            // Skip upload if this exact file is already on storage nodes.
+            // Re-uploading finalized data creates a conflicting tx that breaks retrieval.
+            const rootHash = tree.rootHash();
+            if (rootHash) {
+                try {
+                    const locations = await this.indexer.getFileLocations(rootHash);
+                    if (locations && locations.length > 0) {
+                        return { root: rootHash, txHash: '' };
+                    }
+                }
+                catch {
+                    // Location check failed — proceed with upload
+                }
+            }
             // Always enable gas auto-escalation via the SDK's built-in retry.
             // MaxGasPrice sets the ceiling — the SDK starts from the network estimate
             // and bumps 10% on each retry until it hits this cap.
@@ -107,7 +121,15 @@ export class StorageClient {
         return withRetry(() => this._retrieve(rootHash, outputPath, options), { maxAttempts: 3 });
     }
     async _retrieve(rootHash, outputPath, options) {
-        const err = await this.indexer.download(rootHash, outputPath, options.proof ?? false);
+        let err;
+        try {
+            err = await this.indexer.download(rootHash, outputPath, options.proof ?? false);
+        }
+        catch (e) {
+            // Catch crashes from SDK internals (e.g. null getFileLocations)
+            const msg = e?.message ?? String(e);
+            throw new StorageError(`Download failed: ${msg}`, 'The file may not be fully replicated yet. Wait a moment and retry, or verify the root hash.');
+        }
         if (err) {
             const msg = err.message;
             let suggestion = 'Verify the root hash is correct and the file was uploaded successfully.';

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/package.json

@@ -1,7 +1,17 @@
 {
   "name": "0g-orbit",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.",
+  "author": "cyber",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyber/0g-orbit.git"
+  },
+  "homepage": "https://github.com/cyber/0g-orbit#readme",
+  "bugs": {
+    "url": "https://github.com/cyber/0g-orbit/issues"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,12 +24,20 @@
   "bin": {
     "orbit": "./dist/cli/cli.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@0gfoundation/0g-ts-sdk": "^1.0.1",
@@ -36,17 +54,23 @@
   },
   "keywords": [
     "0g",
+    "zero-gravity",
     "blockchain",
     "ai",
     "storage",
     "inference",
+    "fine-tuning",
     "sdk",
-    "cli"
+    "cli",
+    "web3",
+    "decentralized"
   ],
-  "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "overrides": {
     "axios": "1.14.0",
     "open-jsonrpc-provider": {

package/examples/ai-chatbot/index.ts

@@ -1,74 +0,0 @@
-/**
- * 0G Orbit — AI Chatbot Example
- *
- * A simple interactive chatbot using 0G Compute Network.
- * Demonstrates multi-turn conversations with TEE verification.
- *
- * Usage:
- *   PRIVATE_KEY=0x... npx tsx index.ts
- */
-
-import { Orbit } from '@0g-orbit/core'
-import { createInterface } from 'node:readline'
-
-const MODEL = 'meta-llama/Llama-3.3-70B'
-
-async function main() {
-    const orbit = await Orbit.connect({
-        network: 'testnet',
-        privateKey: process.env.PRIVATE_KEY!,
-    })
-
-    const status = await orbit.status()
-    console.log(`Connected: ${status.address} (${status.balance} OG)`)
-    console.log(`Model: ${MODEL}`)
-    console.log('Type "quit" to exit.\n')
-
-    const history: Array<{ role: 'system' | 'user' | 'assistant'; content: string }> = [
-        {
-            role: 'system',
-            content: 'You are a helpful AI assistant running on 0G decentralized compute. Be concise.',
-        },
-    ]
-
-    const rl = createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    })
-
-    const ask = (prompt: string): Promise<string> =>
-        new Promise((resolve) => rl.question(prompt, resolve))
-
-    while (true) {
-        const input = await ask('You: ')
-        if (input.toLowerCase() === 'quit') break
-        if (!input.trim()) continue
-
-        history.push({ role: 'user', content: input })
-
-        try {
-            const result = await orbit.infer(MODEL, {
-                messages: history,
-                temperature: 0.7,
-                maxTokens: 1024,
-            })
-
-            history.push({ role: 'assistant', content: result.content })
-
-            console.log(`\nAssistant: ${result.content}`)
-
-            const meta: string[] = []
-            if (result.usage) meta.push(`${result.usage.totalTokens} tokens`)
-            if (result.verified === true) meta.push('TEE verified')
-            if (meta.length) console.log(`  (${meta.join(' | ')})`)
-            console.log()
-        } catch (err) {
-            console.error(`Error: ${err instanceof Error ? err.message : err}\n`)
-        }
-    }
-
-    rl.close()
-    console.log('Goodbye!')
-}
-
-main().catch(console.error)

package/examples/model-registry/index.ts

@@ -1,137 +0,0 @@
-/**
- * 0G Orbit — Model Registry Example
- *
- * Store AI model weights on 0G Storage and maintain
- * a registry of model versions with their root hashes.
- *
- * Usage:
- *   PRIVATE_KEY=0x... npx tsx index.ts
- */
-
-import { Orbit } from '@0g-orbit/core'
-import { writeFileSync, readFileSync, existsSync } from 'node:fs'
-
-const REGISTRY_FILE = './registry.json'
-
-interface ModelEntry {
-    name: string
-    version: string
-    rootHash: string
-    txHash: string
-    uploadedAt: string
-    sizeBytes?: number
-}
-
-interface Registry {
-    models: ModelEntry[]
-}
-
-function loadRegistry(): Registry {
-    if (existsSync(REGISTRY_FILE)) {
-        return JSON.parse(readFileSync(REGISTRY_FILE, 'utf-8'))
-    }
-    return { models: [] }
-}
-
-function saveRegistry(registry: Registry) {
-    writeFileSync(REGISTRY_FILE, JSON.stringify(registry, null, 2) + '\n')
-}
-
-async function registerModel(
-    orbit: Orbit,
-    name: string,
-    version: string,
-    filePath: string
-) {
-    console.log(`\nUploading ${name} v${version}...`)
-    const { root, txHash } = await orbit.store(filePath)
-
-    const registry = loadRegistry()
-    registry.models.push({
-        name,
-        version,
-        rootHash: root,
-        txHash,
-        uploadedAt: new Date().toISOString(),
-    })
-    saveRegistry(registry)
-
-    console.log(`Registered: ${name} v${version}`)
-    console.log(`  Root:  ${root}`)
-    console.log(`  Tx:    ${txHash}`)
-    return root
-}
-
-async function downloadModel(
-    orbit: Orbit,
-    name: string,
-    version: string,
-    outputPath: string
-) {
-    const registry = loadRegistry()
-    const entry = registry.models.find(
-        (m) => m.name === name && m.version === version
-    )
-
-    if (!entry) {
-        console.error(`Model ${name} v${version} not found in registry.`)
-        return
-    }
-
-    console.log(`\nDownloading ${name} v${version}...`)
-    await orbit.retrieve(entry.rootHash, outputPath)
-    console.log(`Downloaded to ${outputPath}`)
-}
-
-function listModels() {
-    const registry = loadRegistry()
-    if (registry.models.length === 0) {
-        console.log('No models registered.')
-        return
-    }
-
-    console.log('\nRegistered models:')
-    for (const m of registry.models) {
-        console.log(`  ${m.name} v${m.version}`)
-        console.log(`    root: ${m.rootHash}`)
-        console.log(`    date: ${m.uploadedAt}`)
-    }
-}
-
-async function main() {
-    const orbit = await Orbit.connect({
-        network: 'testnet',
-        privateKey: process.env.PRIVATE_KEY!,
-    })
-
-    const status = await orbit.status()
-    console.log(`Connected: ${status.address} (${status.balance} OG)`)
-
-    const command = process.argv[2] || 'list'
-
-    switch (command) {
-        case 'register': {
-            const [, , , name, version, filePath] = process.argv
-            if (!name || !version || !filePath) {
-                console.error('Usage: npx tsx index.ts register <name> <version> <file>')
-                process.exit(1)
-            }
-            await registerModel(orbit, name, version, filePath)
-            break
-        }
-        case 'download': {
-            const [, , , name, version, outputPath] = process.argv
-            if (!name || !version || !outputPath) {
-                console.error('Usage: npx tsx index.ts download <name> <version> <output>')
-                process.exit(1)
-            }
-            await downloadModel(orbit, name, version, outputPath)
-            break
-        }
-        case 'list':
-        default:
-            listModels()
-    }
-}
-
-main().catch(console.error)

package/examples/quick-start/index.ts

@@ -1,65 +0,0 @@
-/**
- * 0G Orbit — Quick Start
- *
- * Demonstrates the three core operations:
- * 1. Check account status
- * 2. Store a file to 0G Storage
- * 3. Run AI inference on 0G Compute
- *
- * Usage:
- *   PRIVATE_KEY=0x... npx tsx index.ts
- */
-
-import { Orbit } from '@0g-orbit/core'
-import { writeFileSync, unlinkSync } from 'node:fs'
-
-async function main() {
-    // Connect
-    const orbit = await Orbit.connect({
-        network: 'testnet',
-        privateKey: process.env.PRIVATE_KEY!,
-    })
-
-    // 1. Account status
-    const status = await orbit.status()
-    console.log(`Connected: ${status.address}`)
-    console.log(`Balance:   ${status.balance} OG on ${status.network}`)
-
-    // 2. Store a file
-    const testFile = '/tmp/orbit-test.txt'
-    writeFileSync(testFile, 'Hello from 0G Orbit!')
-
-    console.log('\nUploading file...')
-    const { root, txHash } = await orbit.store(testFile)
-    console.log(`Stored! Root: ${root}`)
-    console.log(`Tx:     ${txHash}`)
-
-    unlinkSync(testFile)
-
-    // 3. Retrieve it back
-    const outputFile = '/tmp/orbit-test-downloaded.txt'
-    console.log('\nDownloading...')
-    await orbit.retrieve(root, outputFile)
-    console.log(`Downloaded to ${outputFile}`)
-
-    // 4. AI inference
-    console.log('\nRunning inference...')
-    const result = await orbit.infer('meta-llama/Llama-3.3-70B', {
-        messages: [
-            { role: 'system', content: 'You are a helpful assistant.' },
-            { role: 'user', content: 'Explain what 0G is in one sentence.' },
-        ],
-        temperature: 0.7,
-    })
-
-    console.log(`\nResponse: ${result.content}`)
-    console.log(`Model:    ${result.model}`)
-    if (result.usage) {
-        console.log(`Tokens:   ${result.usage.totalTokens}`)
-    }
-    if (result.verified !== null) {
-        console.log(`Verified: ${result.verified}`)
-    }
-}
-
-main().catch(console.error)

package/packages/cli/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "0g-orbit-cli",
-  "version": "0.1.0",
-  "description": "CLI for 0G Orbit — store, infer, deploy from your terminal.",
-  "type": "module",
-  "bin": {
-    "orbit": "./dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "0g-orbit-core": "workspace:*",
-    "commander": "^12.1.0",
-    "ora": "^8.0.1",
-    "chalk": "^5.3.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.4.0",
-    "@types/node": "^20.12.0"
-  },
-  "keywords": ["0g", "cli", "blockchain", "ai"],
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}