@halot/cli 1.0.2 → 1.0.4

package/README.md

@@ -27,6 +27,8 @@ npx @halot/cli --help
 
 ```bash
 halot provider init
+halot provider init --testnet
+halot provider init --mainnet
 ```
 
 This creates:
@@ -42,19 +44,15 @@ This creates:
     "0g:testnet": {
       "privateKey": "0x..."
     },
-    "0g:mainnet": {
-      "privateKey": "0x..."
-    },
     "stellar:testnet": {
       "privateKey": "S..."
-    },
-    "stellar:mainnet": {
-      "privateKey": "S..."
     }
   }
 }
 ```
 
+The default is `--testnet`. `--mainnet` generates the equivalent `0g:mainnet` and `stellar:mainnet` scoped workspace without adding testnet entries.
+
 `halot.provider.json` stores provider identity, the selected Halot actor authority, and settlement wallets:
 
 ```json
@@ -77,9 +75,7 @@ This creates:
   },
   "settlementWallets": {
     "0g:testnet": "0x...",
-    "0g:mainnet": "0x...",
-    "stellar:testnet": "G...",
-    "stellar:mainnet": "G..."
+    "stellar:testnet": "G..."
   }
 }
 ```
@@ -275,9 +271,7 @@ This creates:
   },
   "settlementWallets": {
     "0g:testnet": "0x...",
-    "0g:mainnet": "0x...",
-    "stellar:testnet": "G...",
-    "stellar:mainnet": "G..."
+    "stellar:testnet": "G..."
   },
   "stake": {
     "amount": "1000",

package/dist/features/provider/provider-init.command.js

@@ -3,11 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runProviderInitCommand = runProviderInitCommand;
 const wallet_manager_1 = require("@halot/cli/shared/wallet/wallet.manager");
 const authority_util_1 = require("@halot/cli/shared/wallet/authority.util");
+const init_cluster_util_1 = require("@halot/cli/shared/wallet/init-cluster.util");
 const workspace_service_1 = require("@halot/cli/shared/workspace/workspace.service");
-async function runProviderInitCommand() {
+const console_1 = require("@halot/cli/shared/ui/console");
+async function runProviderInitCommand(options = {}) {
+    const cluster = (0, init_cluster_util_1.resolveInitCluster)(options);
+    const authorities = (0, init_cluster_util_1.describeClusterAuthorities)(cluster);
     const workspace = new workspace_service_1.WorkspaceService();
     const walletManager = new wallet_manager_1.WalletManager(workspace);
-    const wallets = walletManager.createWallets();
+    const wallets = walletManager.createWallets(cluster);
+    const zeroGAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.zeroG);
+    const stellarAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.stellar);
     workspace.writeProviderConfig({
         providerId: '',
         displayName: 'My Provider',
@@ -17,17 +23,31 @@ async function runProviderInitCommand() {
             erc8004TokenId: '',
             agentRegistry: '',
             agentUri: '',
-            ownerAddress: (0, authority_util_1.resolveAuthorityAddress)(wallets, '0g:testnet'),
+            ownerAddress: zeroGAddress,
             domain: 'myprovider.0g',
             domainType: 'space-id',
         },
         authority: {
             path: './wallets.json',
-            actor: '0g:testnet',
+            actor: authorities.zeroG,
         },
         settlementWallets: (0, authority_util_1.createDefaultSettlementWallets)(wallets),
     });
-    console.log('Provider workspace initialized.');
-    console.log(`0G testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, '0g:testnet')}`);
-    console.log(`Stellar testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, 'stellar:testnet')}`);
+    (0, console_1.printInitSummary)({
+        title: 'Provider workspace initialized',
+        subtitle: `Cluster: ${cluster}`,
+        rows: [
+            { label: 'Actor', value: authorities.zeroG },
+            { label: 'Owner', value: zeroGAddress },
+            { label: 'Settlement', value: `${authorities.zeroG}, ${authorities.stellar}` },
+            { label: 'Stellar', value: stellarAddress },
+        ],
+        files: ['wallets.json', 'halot.provider.json', '.gitignore'],
+        warnings: ['wallets.json contains private keys. Do not commit it.'],
+        nextSteps: [
+            'Edit halot.provider.json',
+            `Run ${(0, console_1.command)('halot provider register')}`,
+            `Run ${(0, console_1.command)('halot service init --name "GPT-5.4 Text" --category text')}`,
+        ],
+    });
 }

package/dist/features/requester/requester-init.command.js

@@ -3,20 +3,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runRequesterInitCommand = runRequesterInitCommand;
 const wallet_manager_1 = require("@halot/cli/shared/wallet/wallet.manager");
 const authority_util_1 = require("@halot/cli/shared/wallet/authority.util");
+const init_cluster_util_1 = require("@halot/cli/shared/wallet/init-cluster.util");
 const workspace_service_1 = require("@halot/cli/shared/workspace/workspace.service");
-async function runRequesterInitCommand() {
+const console_1 = require("@halot/cli/shared/ui/console");
+async function runRequesterInitCommand(options = {}) {
+    const cluster = (0, init_cluster_util_1.resolveInitCluster)(options);
+    const authorities = (0, init_cluster_util_1.describeClusterAuthorities)(cluster);
     const workspace = new workspace_service_1.WorkspaceService();
     const walletManager = new wallet_manager_1.WalletManager(workspace);
-    const wallets = walletManager.createWallets();
+    const wallets = walletManager.createWallets(cluster);
+    const zeroGAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.zeroG);
+    const stellarAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.stellar);
     workspace.writeRequesterConfig({
         requesterId: '',
         displayName: 'Halot Requester',
         authority: {
             path: './wallets.json',
-            actor: '0g:testnet',
+            actor: authorities.zeroG,
         },
     });
-    console.log('Requester workspace initialized.');
-    console.log(`0G testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, '0g:testnet')}`);
-    console.log(`Stellar testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, 'stellar:testnet')}`);
+    (0, console_1.printInitSummary)({
+        title: 'Requester workspace initialized',
+        subtitle: `Cluster: ${cluster}`,
+        rows: [
+            { label: 'Actor', value: authorities.zeroG },
+            { label: '0G', value: zeroGAddress },
+            { label: 'Stellar', value: stellarAddress },
+        ],
+        files: ['wallets.json', 'halot.requester.json', '.gitignore'],
+        warnings: ['wallets.json contains private keys. Do not commit it.'],
+        nextSteps: [
+            `Run ${(0, console_1.command)('halot browse')}`,
+            `Run ${(0, console_1.command)('halot quote --service <serviceId> --input \'{"query":"hello"}\'')}`,
+            `Run ${(0, console_1.command)('halot job create --service <serviceId> --input \'{"query":"hello"}\'')}`,
+        ],
+    });
 }

package/dist/features/service/service-init.command.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runServiceInitCommand = runServiceInitCommand;
 const sdk_1 = require("@halot/sdk");
+const console_1 = require("@halot/cli/shared/ui/console");
 const workspace_service_1 = require("@halot/cli/shared/workspace/workspace.service");
 async function runServiceInitCommand(options) {
     const workspace = new workspace_service_1.WorkspaceService();
@@ -67,7 +68,21 @@ async function runServiceInitCommand(options) {
         },
     };
     workspace.writeService(fileName, service);
-    console.log(`Created service draft services/${fileName}`);
+    (0, console_1.printInitSummary)({
+        title: 'Service draft initialized',
+        rows: [
+            { label: 'Service', value: name },
+            { label: 'Category', value: category },
+            { label: 'Trust', value: trustLevel },
+            { label: 'Draft', value: `services/${fileName}` },
+        ],
+        files: [`services/${fileName}`],
+        nextSteps: [
+            `Edit services/${fileName}`,
+            `Run ${(0, console_1.command)(`halot service register --file ${fileName}`)}`,
+            'Use the returned serviceId in SDK middleware or worker configuration',
+        ],
+    });
 }
 function parseServiceCategory(value) {
     if (!value) {

package/dist/features/verifier/verifier-init.command.js

@@ -3,11 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runVerifierInitCommand = runVerifierInitCommand;
 const wallet_manager_1 = require("@halot/cli/shared/wallet/wallet.manager");
 const authority_util_1 = require("@halot/cli/shared/wallet/authority.util");
+const init_cluster_util_1 = require("@halot/cli/shared/wallet/init-cluster.util");
 const workspace_service_1 = require("@halot/cli/shared/workspace/workspace.service");
-async function runVerifierInitCommand() {
+const console_1 = require("@halot/cli/shared/ui/console");
+async function runVerifierInitCommand(options = {}) {
+    const cluster = (0, init_cluster_util_1.resolveInitCluster)(options);
+    const authorities = (0, init_cluster_util_1.describeClusterAuthorities)(cluster);
     const workspace = new workspace_service_1.WorkspaceService();
     const walletManager = new wallet_manager_1.WalletManager(workspace);
-    const wallets = walletManager.createWallets();
+    const wallets = walletManager.createWallets(cluster);
+    const zeroGAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.zeroG);
+    const stellarAddress = (0, authority_util_1.resolveAuthorityAddress)(wallets, authorities.stellar);
     workspace.writeVerifierConfig({
         verifierId: '',
         displayName: 'My Verifier',
@@ -16,13 +22,13 @@ async function runVerifierInitCommand() {
             erc8004TokenId: '',
             agentRegistry: '',
             agentUri: '',
-            ownerAddress: (0, authority_util_1.resolveAuthorityAddress)(wallets, '0g:testnet'),
+            ownerAddress: zeroGAddress,
             domain: 'myverifier.0g',
             domainType: 'space-id',
         },
         authority: {
             path: './wallets.json',
-            actor: '0g:testnet',
+            actor: authorities.zeroG,
         },
         settlementWallets: (0, authority_util_1.createDefaultSettlementWallets)(wallets),
         stake: {
@@ -41,7 +47,7 @@ async function runVerifierInitCommand() {
             verifiability: 'TeeML',
         },
         sdk: {
-            network: 'testnet',
+            network: cluster,
         },
         timeout: 60,
     });
@@ -63,7 +69,29 @@ async function runVerifierInitCommand() {
         maxConcurrentJobs: 5,
         minConfidenceThreshold: 0.75,
     });
-    console.log('Verifier workspace initialized.');
-    console.log(`0G testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, '0g:testnet')}`);
-    console.log(`Stellar testnet authority: ${(0, authority_util_1.resolveAuthorityAddress)(wallets, 'stellar:testnet')}`);
+    (0, console_1.printInitSummary)({
+        title: 'Verifier workspace initialized',
+        subtitle: `Cluster: ${cluster}`,
+        rows: [
+            { label: 'Actor', value: authorities.zeroG },
+            { label: 'Owner', value: zeroGAddress },
+            { label: 'Settlement', value: `${authorities.zeroG}, ${authorities.stellar}` },
+            { label: 'Stellar', value: stellarAddress },
+        ],
+        files: [
+            'wallets.json',
+            'halot.verifier.json',
+            'model.config.json',
+            'inference.json',
+            'specializations.json',
+            '.gitignore',
+        ],
+        warnings: ['wallets.json contains private keys. Do not commit it.'],
+        nextSteps: [
+            'Edit halot.verifier.json',
+            'Edit model.config.json, inference.json, and specializations.json',
+            `Run ${(0, console_1.command)('halot verifier register')}`,
+            `Run ${(0, console_1.command)('halot verifier run')}`,
+        ],
+    });
 }

package/dist/index.js

@@ -1,6 +1,11 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const commander_1 = require("commander");
 const browse_command_1 = require("@halot/cli/features/browse/browse.command");
 const job_create_command_1 = require("@halot/cli/features/jobs/job-create.command");
@@ -28,7 +33,7 @@ const program = new commander_1.Command();
 program
     .name('halot')
     .description('Halot protocol CLI')
-    .version('1.0.0');
+    .version(resolveCliVersion());
 program
     .command('browse')
     .option('--server <url>', 'Halot server url', defaultServerUrl)
@@ -43,9 +48,15 @@ program
 const requester = program.command('requester').description('Requester workspace');
 requester
     .command('init')
+    .option('--testnet', 'Initialize a testnet requester workspace', false)
+    .option('--mainnet', 'Initialize a mainnet requester workspace', false)
     .action(requester_init_command_1.runRequesterInitCommand);
 const provider = program.command('provider').description('Provider workspace');
-provider.command('init').action(provider_init_command_1.runProviderInitCommand);
+provider
+    .command('init')
+    .option('--testnet', 'Initialize a testnet provider workspace', false)
+    .option('--mainnet', 'Initialize a mainnet provider workspace', false)
+    .action(provider_init_command_1.runProviderInitCommand);
 provider
     .command('register')
     .option('--server <url>', 'Halot server url', defaultServerUrl)
@@ -92,7 +103,11 @@ service
     .option('--server <url>', 'Halot server url', defaultServerUrl)
     .action(service_remove_command_1.runServiceRemoveCommand);
 const verifier = program.command('verifier').description('Verifier workspace');
-verifier.command('init').action(verifier_init_command_1.runVerifierInitCommand);
+verifier
+    .command('init')
+    .option('--testnet', 'Initialize a testnet verifier workspace', false)
+    .option('--mainnet', 'Initialize a mainnet verifier workspace', false)
+    .action(verifier_init_command_1.runVerifierInitCommand);
 verifier
     .command('register')
     .option('--server <url>', 'Halot server url', defaultServerUrl)
@@ -132,3 +147,13 @@ program.parseAsync().catch((error) => {
     console.error(error instanceof Error ? error.message : error);
     process.exitCode = 1;
 });
+function resolveCliVersion() {
+    try {
+        const packageJsonPath = node_path_1.default.resolve(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, 'utf8'));
+        return packageJson.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}

package/dist/shared/ui/console.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printInitSummary = printInitSummary;
+exports.command = command;
+const HALOT_ASCII = [
+    ' _   _    _    _     ___ _____',
+    '| | | |  / \\  | |   / _ \\_   _|',
+    '| |_| | / _ \\ | |  | | | || |',
+    '|  _  |/ ___ \\| |__| |_| || |',
+    '|_| |_/_/   \\_\\_____\\___/ |_|',
+].join('\n');
+const colorEnabled = Boolean(process.stdout.isTTY && !process.env.NO_COLOR);
+const paint = {
+    bold: (value) => wrap(value, '1', '22'),
+    dim: (value) => wrap(value, '2', '22'),
+    green: (value) => wrap(value, '32', '39'),
+    orange: (value) => wrap(value, '38;5;215', '39'),
+    cyan: (value) => wrap(value, '36', '39'),
+};
+function printInitSummary(summary) {
+    const output = [
+        '',
+        paint.orange(HALOT_ASCII),
+        '',
+        paint.bold(summary.title),
+        summary.subtitle ? paint.dim(summary.subtitle) : undefined,
+        summary.rows?.length ? renderRows(summary.rows) : undefined,
+        summary.files?.length ? renderList('Files', summary.files) : undefined,
+        summary.warnings?.length ? renderList('Notes', summary.warnings) : undefined,
+        summary.nextSteps?.length ? renderNumberedList('Next', summary.nextSteps) : undefined,
+        '',
+    ].filter((line) => Boolean(line));
+    console.log(output.join('\n'));
+}
+function command(value) {
+    return paint.cyan(value);
+}
+function renderRows(rows) {
+    const width = rows.reduce((max, row) => Math.max(max, row.label.length), 0);
+    return rows
+        .map((row) => `${paint.dim(row.label.padEnd(width))}  ${paint.green(row.value)}`)
+        .join('\n');
+}
+function renderList(title, items) {
+    return [
+        paint.bold(title),
+        ...items.map((item) => `- ${item}`),
+    ].join('\n');
+}
+function renderNumberedList(title, items) {
+    return [
+        paint.bold(title),
+        ...items.map((item, index) => `${index + 1}. ${item}`),
+    ].join('\n');
+}
+function wrap(value, open, close) {
+    if (!colorEnabled) {
+        return value;
+    }
+    return `\x1b[${open}m${value}\x1b[${close}m`;
+}

package/dist/shared/wallet/authority.util.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveClusterAuthorities = resolveClusterAuthorities;
 exports.resolveAuthorityWallet = resolveAuthorityWallet;
 exports.resolveActorWallet = resolveActorWallet;
 exports.resolveAuthorityAddress = resolveAuthorityAddress;
@@ -10,8 +11,18 @@ exports.isMainnetAuthority = isMainnetAuthority;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const ethers_1 = require("ethers");
 const sdk_1 = require("@halot/sdk");
+function resolveClusterAuthorities(cluster) {
+    return {
+        zeroG: `0g:${cluster}`,
+        stellar: `stellar:${cluster}`,
+    };
+}
 function resolveAuthorityWallet(wallets, authority) {
-    return wallets.authorities[authority];
+    const wallet = wallets.authorities[authority];
+    if (!wallet) {
+        throw new Error(`Wallet authority ${authority} is missing from wallets.json`);
+    }
+    return wallet;
 }
 function resolveActorWallet(wallets, authority) {
     return new ethers_1.Wallet(resolveAuthorityWallet(wallets, authority).privateKey);
@@ -30,12 +41,12 @@ function deriveVerifierSigningPublicKey(wallets, authority) {
     return new ethers_1.SigningKey(resolveAuthorityWallet(wallets, asZeroGAuthority(authority)).privateKey).publicKey;
 }
 function createDefaultSettlementWallets(wallets) {
-    return {
-        '0g:testnet': resolveAuthorityAddress(wallets, '0g:testnet'),
-        '0g:mainnet': resolveAuthorityAddress(wallets, '0g:mainnet'),
-        'stellar:testnet': resolveAuthorityAddress(wallets, 'stellar:testnet'),
-        'stellar:mainnet': resolveAuthorityAddress(wallets, 'stellar:mainnet'),
-    };
+    return sdk_1.settlementNetworkValues.reduce((settlementWallets, network) => {
+        if (wallets.authorities[network]) {
+            settlementWallets[network] = resolveAuthorityAddress(wallets, network);
+        }
+        return settlementWallets;
+    }, {});
 }
 function resolveZeroGAuthorityProfile(authority) {
     return (0, sdk_1.resolveZeroGAuthorityProfile)(asZeroGAuthority(authority));

package/dist/shared/wallet/init-cluster.util.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveInitCluster = resolveInitCluster;
+exports.describeClusterAuthorities = describeClusterAuthorities;
+const authority_util_1 = require("@halot/cli/shared/wallet/authority.util");
+function resolveInitCluster(options = {}) {
+    if (options.testnet && options.mainnet) {
+        throw new Error('Choose either --testnet or --mainnet, not both.');
+    }
+    return options.mainnet ? 'mainnet' : 'testnet';
+}
+function describeClusterAuthorities(cluster) {
+    const authorities = (0, authority_util_1.resolveClusterAuthorities)(cluster);
+    return {
+        zeroG: authorities.zeroG,
+        stellar: authorities.stellar,
+    };
+}

package/dist/shared/wallet/wallet.manager.js

@@ -4,29 +4,23 @@ exports.WalletManager = void 0;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const ethers_1 = require("ethers");
 const workspace_service_1 = require("@halot/cli/shared/workspace/workspace.service");
+const authority_util_1 = require("@halot/cli/shared/wallet/authority.util");
 class WalletManager {
     workspaceService;
     constructor(workspaceService = new workspace_service_1.WorkspaceService()) {
         this.workspaceService = workspaceService;
     }
-    createWallets() {
-        const zeroGTestnetWallet = ethers_1.Wallet.createRandom();
-        const zeroGMainnetWallet = ethers_1.Wallet.createRandom();
-        const stellarTestnetWallet = stellar_sdk_1.Keypair.random();
-        const stellarMainnetWallet = stellar_sdk_1.Keypair.random();
+    createWallets(cluster = 'testnet') {
+        const zeroGWallet = ethers_1.Wallet.createRandom();
+        const stellarWallet = stellar_sdk_1.Keypair.random();
+        const authorities = (0, authority_util_1.resolveClusterAuthorities)(cluster);
         const wallets = {
             authorities: {
-                '0g:testnet': {
-                    privateKey: zeroGTestnetWallet.privateKey,
+                [authorities.zeroG]: {
+                    privateKey: zeroGWallet.privateKey,
                 },
-                '0g:mainnet': {
-                    privateKey: zeroGMainnetWallet.privateKey,
-                },
-                'stellar:testnet': {
-                    privateKey: stellarTestnetWallet.secret(),
-                },
-                'stellar:mainnet': {
-                    privateKey: stellarMainnetWallet.secret(),
+                [authorities.stellar]: {
+                    privateKey: stellarWallet.secret(),
                 },
             },
         };

package/dist/shared/workspace/workspace.service.js

@@ -144,13 +144,15 @@ class WorkspaceService {
 exports.WorkspaceService = WorkspaceService;
 function normalizeWalletBundle(input) {
     if (isRecord(input) && isRecord(input.authorities)) {
+        const authorities = {};
+        for (const network of sdk_1.settlementNetworkValues) {
+            const entry = input.authorities[network];
+            if (entry !== undefined) {
+                authorities[network] = normalizeAuthorityEntry(entry);
+            }
+        }
         return {
-            authorities: {
-                '0g:testnet': normalizeAuthorityEntry(input.authorities['0g:testnet']),
-                '0g:mainnet': normalizeAuthorityEntry(input.authorities['0g:mainnet']),
-                'stellar:testnet': normalizeAuthorityEntry(input.authorities['stellar:testnet']),
-                'stellar:mainnet': normalizeAuthorityEntry(input.authorities['stellar:mainnet']),
-            },
+            authorities,
         };
     }
     if (isRecord(input) && input.zeroG && input.stellar) {
@@ -159,9 +161,7 @@ function normalizeWalletBundle(input) {
         return {
             authorities: {
                 '0g:testnet': zeroG,
-                '0g:mainnet': zeroG,
                 'stellar:testnet': stellar,
-                'stellar:mainnet': stellar,
             },
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halot/cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Halot protocol CLI",
   "main": "dist/index.js",
   "bin": {
@@ -30,7 +30,7 @@
     "./*": "./dist/*.js"
   },
   "dependencies": {
-    "@halot/sdk": "^1.0.1",
+    "@halot/sdk": "^1.0.2",
     "@stellar/stellar-sdk": "^15.0.1",
     "@web3-name-sdk/core": "^0.1.18",
     "commander": "^14.0.3",