Merge remote-tracking branch 'origin/main' into feature/storage-first-flow-v2

# Conflicts:
#	cli.commonjs/cli/fine-tuning.d.ts.map
#	cli.commonjs/cli/fine-tuning.js
#	cli.commonjs/cli/fine-tuning.js.map
#	cli.commonjs/cli/inference.d.ts.map
#	cli.commonjs/cli/inference.js
#	cli.commonjs/cli/inference.js.map
#	cli.commonjs/cli/ledger.d.ts.map
#	cli.commonjs/cli/util.d.ts.map
#	cli.commonjs/sdk/common/utils/index.d.ts
#	cli.commonjs/sdk/common/utils/index.d.ts.map
#	cli.commonjs/sdk/common/utils/index.js
#	cli.commonjs/sdk/common/utils/index.js.map
#	cli.commonjs/sdk/fine-tuning/broker/broker.d.ts
#	cli.commonjs/sdk/fine-tuning/broker/broker.d.ts.map
#	cli.commonjs/sdk/fine-tuning/broker/broker.js
#	cli.commonjs/sdk/fine-tuning/broker/broker.js.map
#	cli.commonjs/sdk/fine-tuning/broker/dataset.d.ts
#	cli.commonjs/sdk/fine-tuning/broker/dataset.d.ts.map
#	cli.commonjs/sdk/fine-tuning/broker/dataset.js
#	cli.commonjs/sdk/fine-tuning/broker/dataset.js.map
#	cli.commonjs/sdk/fine-tuning/broker/model.d.ts
#	cli.commonjs/sdk/fine-tuning/broker/model.d.ts.map
#	cli.commonjs/sdk/fine-tuning/broker/model.js
#	cli.commonjs/sdk/fine-tuning/broker/model.js.map
#	cli.commonjs/sdk/fine-tuning/zg-storage/zg-storage.d.ts
#	cli.commonjs/sdk/fine-tuning/zg-storage/zg-storage.d.ts.map
#	cli.commonjs/sdk/fine-tuning/zg-storage/zg-storage.js
#	cli.commonjs/sdk/fine-tuning/zg-storage/zg-storage.js.map
#	cli.commonjs/sdk/inference/broker/broker.d.ts.map
#	cli.commonjs/sdk/ledger/broker.d.ts.map
#	lib.commonjs/common/utils/index.d.ts
#	lib.commonjs/common/utils/index.d.ts.map
#	lib.commonjs/common/utils/index.js
#	lib.commonjs/common/utils/index.js.map
#	lib.commonjs/fine-tuning/broker/broker.d.ts
#	lib.commonjs/fine-tuning/broker/broker.d.ts.map
#	lib.commonjs/fine-tuning/broker/broker.js
#	lib.commonjs/fine-tuning/broker/broker.js.map
#	lib.commonjs/fine-tuning/broker/dataset.d.ts
#	lib.commonjs/fine-tuning/broker/dataset.d.ts.map
#	lib.commonjs/fine-tuning/broker/dataset.js
#	lib.commonjs/fine-tuning/broker/dataset.js.map
#	lib.commonjs/fine-tuning/broker/model.d.ts
#	lib.commonjs/fine-tuning/broker/model.d.ts.map
#	lib.commonjs/fine-tuning/broker/model.js
#	lib.commonjs/fine-tuning/broker/model.js.map
#	lib.commonjs/fine-tuning/zg-storage/zg-storage.d.ts
#	lib.commonjs/fine-tuning/zg-storage/zg-storage.d.ts.map
#	lib.commonjs/fine-tuning/zg-storage/zg-storage.js
#	lib.commonjs/fine-tuning/zg-storage/zg-storage.js.map
#	lib.commonjs/inference/broker/broker.d.ts.map
#	lib.commonjs/ledger/broker.d.ts.map
#	lib.esm/_commonjsHelpers-0f3c985d.js
#	lib.esm/adm-zip-0609067e.js
#	lib.esm/adm-zip-0609067e.js.map
#	lib.esm/browser-0fd4d439.js
#	lib.esm/browser-0fd4d439.js.map
#	lib.esm/common/utils/index.d.ts
#	lib.esm/common/utils/index.d.ts.map
#	lib.esm/fine-tuning/broker/broker.d.ts
#	lib.esm/fine-tuning/broker/broker.d.ts.map
#	lib.esm/fine-tuning/broker/dataset.d.ts
#	lib.esm/fine-tuning/broker/dataset.d.ts.map
#	lib.esm/fine-tuning/broker/model.d.ts
#	lib.esm/fine-tuning/broker/model.d.ts.map
#	lib.esm/fine-tuning/zg-storage/zg-storage.d.ts
#	lib.esm/fine-tuning/zg-storage/zg-storage.d.ts.map
#	lib.esm/index-291e4713.js
#	lib.esm/index.d.ts
#	lib.esm/index.mjs
#	lib.esm/inference/broker/broker.d.ts.map
#	lib.esm/ledger/broker.d.ts.map
#	src.ts/cli/fine-tuning.ts
#	src.ts/sdk/fine-tuning/broker/dataset.ts
#	src.ts/sdk/fine-tuning/broker/model.ts
#	src.ts/sdk/fine-tuning/zg-storage/zg-storage.ts
#	types/common/utils/index.d.ts
#	types/common/utils/index.d.ts.map
#	types/fine-tuning/broker/broker.d.ts
#	types/fine-tuning/broker/broker.d.ts.map
#	types/fine-tuning/broker/dataset.d.ts
#	types/fine-tuning/broker/dataset.d.ts.map
#	types/fine-tuning/broker/model.d.ts
#	types/fine-tuning/broker/model.d.ts.map
#	types/fine-tuning/zg-storage/zg-storage.d.ts
#	types/fine-tuning/zg-storage/zg-storage.d.ts.map
#	types/inference/broker/broker.d.ts.map
#	types/ledger/broker.d.ts.map

Author: zeyuyuyu

.github/workflows/cli-test.yml

@@ -48,6 +48,10 @@ jobs:
           pnpm install --frozen-lockfile
           pnpm build
           pnpm pack
+
+      - name: Run CLI integration tests
+        run: pnpm test:cli
+        timeout-minutes: 10
 
       - name: Setup test environment
         run: |
@@ -86,16 +90,44 @@ jobs:
           # Test CLI commands using local binary
           if [ -f "./node_modules/.bin/0g-compute-cli" ]; then
             # npm/yarn classic with node_modules/.bin
+            echo "Testing basic CLI commands..."
             ./node_modules/.bin/0g-compute-cli --version
             ./node_modules/.bin/0g-compute-cli --help
             ./node_modules/.bin/0g-compute-cli inference --help
             ./node_modules/.bin/0g-compute-cli show-network || echo "Network command tested"
+
+            echo "Testing authentication-free commands..."
+            echo "→ Testing inference list-providers (no auth required)"
+            ./node_modules/.bin/0g-compute-cli inference list-providers --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing inference list-providers-detail (no auth required)"
+            ./node_modules/.bin/0g-compute-cli inference list-providers-detail --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing fine-tuning list-providers (no auth required)"
+            ./node_modules/.bin/0g-compute-cli fine-tuning list-providers --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing fine-tuning list-models (no auth required)"
+            ./node_modules/.bin/0g-compute-cli fine-tuning list-models --rpc https://evmrpc-testnet.0g.ai
           elif [ "${{ matrix.pkg-manager }}" = "yarn" ]; then
             # yarn 4+ with PnP mode
+            echo "Testing basic CLI commands..."
             yarn run 0g-compute-cli --version
             yarn run 0g-compute-cli --help
             yarn run 0g-compute-cli inference --help
             yarn run 0g-compute-cli show-network || echo "Network command tested"
+
+            echo "Testing authentication-free commands..."
+            echo "→ Testing inference list-providers (no auth required)"
+            yarn run 0g-compute-cli inference list-providers --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing inference list-providers-detail (no auth required)"
+            yarn run 0g-compute-cli inference list-providers-detail --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing fine-tuning list-providers (no auth required)"
+            yarn run 0g-compute-cli fine-tuning list-providers --rpc https://evmrpc-testnet.0g.ai
+
+            echo "→ Testing fine-tuning list-models (no auth required)"
+            yarn run 0g-compute-cli fine-tuning list-models --rpc https://evmrpc-testnet.0g.ai
           else
             echo "CLI binary not found"
             exit 1

.gitignore

@@ -7,6 +7,12 @@ node_modules
 token_counter
 token_counter.*
 
+# Build outputs (generated files)
+lib.commonjs/
+lib.esm/
+cli.commonjs/
+types/
+
 # Next.js build outputs
 .next
 out
@@ -19,3 +25,4 @@ ack_tee.cjs
 *.secret.cjs
 
 .pnpm-store
+.vscode/

README.md

@@ -4,15 +4,15 @@ Access decentralized AI computing through the 0G Compute Network - a GPU marketp
 
 ## Features
 
-- **AI Inference**: Run LLMs, text-to-image, and speech-to-text models
+- **AI Inference**: Run LLMs, text-to-image, image editing, and speech-to-text models — with both sync and async modes
 - **Fine-tuning**: Customize models with your own data
 - **OpenAI Compatible**: Works with existing OpenAI SDK clients
 - **Web UI**: Built-in interface for easy service discovery and testing
 - **CLI Tools**: Command-line interface for automation
 
 ## Requirements
 
-- Node.js >= 22.0.0
+- Node.js >= 20.0.0
 - A wallet with 0G tokens
 
 ## Installation
@@ -43,6 +43,7 @@ The fastest way to get started:
 ```
 
 Open `http://localhost:3090` in your browser to:
+
 - Connect your wallet (MetaMask)
 - Browse available AI services
 - Chat with AI models directly
@@ -79,56 +80,104 @@ Open `http://localhost:3090` in your browser to:
 ### SDK
 
 ```typescript
-import { ethers } from "ethers";
-import { createZGComputeNetworkBroker } from "@0glabs/0g-serving-broker";
+import { ethers } from 'ethers'
+import { createZGComputeNetworkBroker } from '@0glabs/0g-serving-broker'
 
 // Initialize
-const provider = new ethers.JsonRpcProvider("https://evmrpc-testnet.0g.ai");
-const wallet = new ethers.Wallet(process.env.PRIVATE_KEY!, provider);
-const broker = await createZGComputeNetworkBroker(wallet);
+const provider = new ethers.JsonRpcProvider('https://evmrpc-testnet.0g.ai')
+const wallet = new ethers.Wallet(process.env.PRIVATE_KEY!, provider)
+const broker = await createZGComputeNetworkBroker(wallet)
 
 // Discover services
-const services = await broker.inference.listService();
+const services = await broker.inference.listService()
 
 // Fund your account
-await broker.ledger.depositFund(10);
+await broker.ledger.depositFund(10)
 
 // Acknowledge provider
-await broker.inference.acknowledgeProviderSigner(providerAddress);
+await broker.inference.acknowledgeProviderSigner(providerAddress)
 
 // Get service metadata
-const { endpoint, model } = await broker.inference.getServiceMetadata(providerAddress);
+const { endpoint, model } =
+    await broker.inference.getServiceMetadata(providerAddress)
 
 // Generate auth headers
-const headers = await broker.inference.getRequestHeaders(providerAddress);
+const headers = await broker.inference.getRequestHeaders(providerAddress)
 
 // Make request (OpenAI compatible)
 const response = await fetch(`${endpoint}/chat/completions`, {
-  method: "POST",
-  headers: { "Content-Type": "application/json", ...headers },
-  body: JSON.stringify({
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...headers },
+    body: JSON.stringify({
+        model,
+        messages: [{ role: 'user', content: 'Hello!' }],
+    }),
+})
+
+// Or make async request (support images-generations and images-edits)
+
+// Async endpoints live under /v1/async instead of /v1/proxy
+const asyncBase = endpoint.replace('/v1/proxy', '/v1/async')
+const requestBody = {
     model,
-    messages: [{ role: "user", content: "Hello!" }]
-  })
-});
+    prompt: 'A cute baby sea otter',
+    n: 1,
+    size: '512x512',
+    response_format: 'b64_json',
+}
+
+// Step 1 — submit the job
+const submitHeaders = await broker.inference.getRequestHeaders(
+    providerAddress,
+    JSON.stringify(requestBody)
+)
+const submitRes = await fetch(`${asyncBase}/images/generations`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...submitHeaders },
+    body: JSON.stringify(requestBody),
+})
+// 202 Accepted → { jobId: "uuid", status: "pending" }
+const { jobId } = await submitRes.json()
+
+// Step 2 — poll until done
+let job
+do {
+    const retryAfter = job?.retryAfter ?? 5
+    await new Promise((r) => setTimeout(r, retryAfter * 1000))
+
+    const pollHeaders =
+        await broker.inference.getRequestHeaders(providerAddress)
+    const pollRes = await fetch(`${asyncBase}/jobs/${jobId}`, {
+        headers: pollHeaders,
+    })
+    const retryAfterHeader = pollRes.headers.get('Retry-After')
+    job = {
+        ...(await pollRes.json()),
+        retryAfter: retryAfterHeader ? Number(retryAfterHeader) : 5,
+    }
+} while (job.status === 'pending' || job.status === 'processing')
+
+if (job.status === 'failed') throw new Error(job.errorMessage)
+
+// job.data — raw provider response, e.g. { data: [{ b64_json: "..." }] }
 ```
 
 ## Direct API Access
 
 After obtaining a secret with `0g-compute-cli inference get-secret`, use any OpenAI-compatible client:
 
 ```typescript
-import OpenAI from 'openai';
+import OpenAI from 'openai'
 
 const client = new OpenAI({
-  baseURL: `${serviceUrl}/v1/proxy`,
-  apiKey: 'app-sk-<YOUR_SECRET>'
-});
+    baseURL: `${serviceUrl}/v1/proxy`,
+    apiKey: 'app-sk-<YOUR_SECRET>',
+})
 
 const completion = await client.chat.completions.create({
-  model: 'model-name',
-  messages: [{ role: 'user', content: 'Hello!' }]
-});
+    model: 'model-name',
+    messages: [{ role: 'user', content: 'Hello!' }],
+})
 ```
 
 ## Account Management
@@ -214,11 +263,11 @@ Service providers can manage their deployed containers and configurations remote
 
 The controller manages three types of configurations:
 
-| Type | Description | Format |
-|------|-------------|--------|
-| `core` | Broker + Event shared config | YAML |
-| `ingress` | Nginx ingress environment variables | JSON |
-| `prometheus` | Prometheus monitoring config | YAML (auto base64 encoded) |
+| Type         | Description                         | Format                     |
+| ------------ | ----------------------------------- | -------------------------- |
+| `core`       | Broker + Event shared config        | YAML                       |
+| `ingress`    | Nginx ingress environment variables | JSON                       |
+| `prometheus` | Prometheus monitoring config        | YAML (auto base64 encoded) |
 
 ```bash
 # Get configuration
@@ -265,10 +314,10 @@ The controller manages three types of configurations:
 
 ## Network Configuration
 
-| Network | RPC Endpoint |
-|---------|--------------|
+| Network | RPC Endpoint                 |
+| ------- | ---------------------------- |
 | Testnet | https://evmrpc-testnet.0g.ai |
-| Mainnet | https://evmrpc.0g.ai |
+| Mainnet | https://evmrpc.0g.ai         |
 
 ## Browser Usage
 
@@ -280,21 +329,22 @@ pnpm add -D vite-plugin-node-polyfills
 
 ```javascript
 // vite.config.js
-import { nodePolyfills } from 'vite-plugin-node-polyfills';
+import { nodePolyfills } from 'vite-plugin-node-polyfills'
 
 export default {
-  plugins: [
-    nodePolyfills({
-      include: ['crypto', 'stream', 'util', 'buffer', 'process'],
-      globals: { Buffer: true, global: true, process: true }
-    })
-  ]
-};
+    plugins: [
+        nodePolyfills({
+            include: ['crypto', 'stream', 'util', 'buffer', 'process'],
+            globals: { Buffer: true, global: true, process: true },
+        }),
+    ],
+}
 ```
 
 ## Troubleshooting
 
 ### Insufficient Balance
+
 ```bash
 # Check which account needs funds
 0g-compute-cli get-account
@@ -307,11 +357,13 @@ export default {
 ```
 
 ### Provider Not Acknowledged
+
 ```bash
 0g-compute-cli inference acknowledge-provider --provider <PROVIDER_ADDRESS>
 ```
 
 ### Web UI Port Conflict
+
 ```bash
 0g-compute-cli ui start-web --port 3091
 ```
@@ -322,5 +374,3 @@ export default {
 - [Inference Guide](https://docs.0g.ai/developer-hub/building-on-0g/compute-network/inference)
 - [Fine-tuning Guide](https://docs.0g.ai/developer-hub/building-on-0g/compute-network/fine-tuning)
 - [Account Management](https://docs.0g.ai/developer-hub/building-on-0g/compute-network/account-management)
-
-