@obbyx/cli 0.0.0-stage → 0.1.0

package/dist/lib/doctor.js

@@ -0,0 +1,97 @@
+import { existsSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import obyte from 'obyte';
+import { toDisplay } from '@obbyx/obyte';
+import { ClientChannelStore, CoinReservations, hubCall } from '@obbyx/x402-obyte';
+import { channelStorePath } from './channels.js';
+import { obbyxHome, walletPath } from '@obbyx/obyte/wallet';
+export async function doctor(network, opts) {
+    const results = [];
+    const report = (status, what, detail = '') => {
+        results.push(status);
+        opts.out(`${status === 'ok' ? '✓' : status === 'warn' ? '!' : '✗'} ${what}${detail ? ` — ${detail}` : ''}`);
+    };
+    // Wallet
+    const wallet = walletPath(network);
+    let address;
+    if (!existsSync(wallet)) {
+        report('fail', 'wallet', `missing; run: obbyx init --network ${network.name}`);
+    }
+    else if ((statSync(wallet).mode & 0o077) !== 0) {
+        report('fail', 'wallet', `${wallet} is readable by others; run: chmod 600 ${wallet}`);
+    }
+    else {
+        const { readFileSync } = await import('node:fs');
+        address = JSON.parse(readFileSync(wallet, 'utf8')).address;
+        report('ok', 'wallet', `${address} (${wallet})`);
+    }
+    // Hub
+    const client = new obyte.Client(opts.hub ?? network.defaultHubUrl, { testnet: network.testnet });
+    try {
+        const started = Date.now();
+        const mci = await hubCall(() => client.api.getLastMci(), 10_000);
+        if (mci.kind !== 'ok') {
+            report('fail', 'hub', `${opts.hub ?? network.defaultHubUrl}: ${mci.error}`);
+        }
+        else {
+            report('ok', 'hub', `${opts.hub ?? network.defaultHubUrl}, last MCI ${mci.value}, ${Date.now() - started} ms`);
+            if (address !== undefined) {
+                const b = await hubCall(() => client.api.getBalances([address]), 10_000);
+                if (b.kind === 'ok') {
+                    const base = b.value[address]?.['base'];
+                    const stable = BigInt(base?.stable ?? 0);
+                    const pending = BigInt(base?.pending ?? 0);
+                    report(stable === 0n ? (network.testnet ? 'warn' : 'fail') : 'ok', 'balance', `${toDisplay(stable, 9)} GBYTE stable, ${toDisplay(pending, 9)} pending` +
+                        (stable === 0n && network.testnet ? '; run: obbyx faucet' : ''));
+                }
+                else {
+                    report('warn', 'balance', b.error);
+                }
+            }
+        }
+    }
+    finally {
+        client.close();
+    }
+    // Local payment state
+    const coinsPath = join(obbyxHome(), `coins-${network.name}.db`);
+    if (existsSync(coinsPath)) {
+        const reservations = new CoinReservations(coinsPath);
+        const units = reservations.boundUnits(network.caip2);
+        reservations.close();
+        report(units.length === 0 ? 'ok' : 'warn', 'coin reservations', units.length === 0
+            ? 'none'
+            : `${units.length} unpublished payment unit(s) hold inputs; they are released once seen on the ledger or after the publication window`);
+    }
+    const channelsPath = channelStorePath(network);
+    if (existsSync(channelsPath)) {
+        const channels = new ClientChannelStore(channelsPath);
+        const list = channels.list().filter((c) => c.network === network.caip2);
+        channels.close();
+        const pending = list.filter((c) => c.pending !== null);
+        report(pending.length === 0 ? 'ok' : 'warn', 'channels', `${list.length} channel(s)` +
+            (pending.length
+                ? `, ${pending.length} with a voucher of unknown outcome (retry that request with --payment)`
+                : ''));
+    }
+    // Facilitator (optional)
+    if (opts.facilitator !== undefined) {
+        try {
+            const res = await fetch(new URL('/supported', opts.facilitator), {
+                signal: AbortSignal.timeout(10_000),
+            });
+            const supported = (await res.json());
+            const kinds = (supported.kinds ?? [])
+                .filter((k) => k.network === network.caip2)
+                .map((k) => k.scheme);
+            report(kinds.length > 0 ? 'ok' : 'fail', 'facilitator', kinds.length > 0
+                ? `${opts.facilitator}: ${kinds.join(', ')}`
+                : `does not serve ${network.caip2}`);
+        }
+        catch (err) {
+            report('fail', 'facilitator', `${opts.facilitator}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return results.includes('fail') ? 1 : 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/lib/doctor.js.map

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

package/dist/lib/logs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `obbyx logs` — follow ONE payment through the JSON logs of the seller
+ * middleware, the facilitator and the watcher (they share correlation fields:
+ * requestId, binding, proofId, aa, seq). Reads files or stdin.
+ */
+export interface LogFilter {
+    readonly binding?: string;
+    readonly proof?: string;
+    readonly aa?: string;
+    readonly request?: string;
+    readonly level?: string;
+}
+export declare function matches(entry: Record<string, unknown>, f: LogFilter): boolean;
+export declare function format(entry: Record<string, unknown>): string;
+export declare function logs(files: readonly string[], filter: LogFilter, out: (s: string) => void): Promise<number>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/lib/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/lib/logs.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAiBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAY7E;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQ7D;AAED,wBAAsB,IAAI,CACxB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/lib/logs.js

@@ -0,0 +1,64 @@
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+const LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
+const SHOWN = [
+    'binding',
+    'proofId',
+    'aa',
+    'seq',
+    'reason',
+    'from',
+    'to',
+    'transaction',
+    'amountSpent',
+    'status',
+    'err',
+];
+export function matches(entry, f) {
+    if (f.binding !== undefined && entry['binding'] !== f.binding)
+        return false;
+    if (f.proof !== undefined && entry['proofId'] !== f.proof && entry['unit'] !== f.proof)
+        return false;
+    if (f.aa !== undefined && entry['aa'] !== f.aa)
+        return false;
+    if (f.request !== undefined && entry['requestId'] !== f.request && entry['reqId'] !== f.request)
+        return false;
+    if (f.level !== undefined) {
+        const min = LEVELS.indexOf(f.level);
+        if (min >= 0 && LEVELS.indexOf(String(entry['level'])) < min)
+            return false;
+    }
+    return true;
+}
+export function format(entry) {
+    const time = String(entry['time'] ?? '').slice(11, 23);
+    const extra = SHOWN.filter((k) => entry[k] !== undefined)
+        .map((k) => `${k}=${typeof entry[k] === 'object' ? JSON.stringify(entry[k]) : String(entry[k])}`)
+        .join(' ');
+    return `${time} ${String(entry['level'] ?? '').padEnd(5)} ${String(entry['service'] ?? '-')}/${String(entry['module'] ?? '-')}: ${String(entry['msg'] ?? '')}${extra ? `  ${extra}` : ''}`;
+}
+export async function logs(files, filter, out) {
+    const sources = files.length > 0 ? files : ['-'];
+    const found = [];
+    for (const file of sources) {
+        const input = file === '-' ? process.stdin : createReadStream(file, 'utf8');
+        for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+            if (!line.startsWith('{'))
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                if (matches(entry, filter))
+                    found.push(entry);
+            }
+            catch {
+                // not a JSON log line
+            }
+        }
+    }
+    // Several components' logs merged into one timeline.
+    found.sort((a, b) => String(a['time'] ?? '').localeCompare(String(b['time'] ?? '')));
+    for (const entry of found)
+        out(format(entry));
+    return found.length > 0 ? 0 : 1;
+}
+//# sourceMappingURL=logs.js.map

package/dist/lib/logs.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { hideBin } from 'yargs/helpers';
+import { runCli } from './cli.js';
+runCli(hideBin(process.argv), {
+    out: (line = '') => process.stdout.write(`${line}\n`),
+    err: (line) => process.stderr.write(`${line}\n`),
+}).then((code) => process.exit(code), (e) => {
+    process.stderr.write(`error: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;IAC5B,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IACrD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACjD,CAAC,CAAC,IAAI,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,CAAU,EAAE,EAAE;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,21 @@
+import obyte from 'obyte';
+import { type ObyteNetwork } from '@obbyx/obyte';
+import { type Logger } from '@obbyx/obyte/logger';
+import { ReservingComposer } from '@obbyx/x402-obyte';
+/** Helpers shared by the commands: network/hub, logger, argument parsing, output. */
+export declare function printPayment(err: (l: string) => void, network: ObyteNetwork, p: {
+    success: boolean;
+    amount?: string;
+    transaction: string;
+    errorReason?: string;
+    extra?: unknown;
+}): void;
+export declare function cliLogger(): Logger;
+export declare function bytesArg(value: string, name: string): bigint;
+export declare function seconds(value: string, name: string): number;
+/** Reserving coin picker for this wallet (inputs of unpublished units are never reused). */
+export declare function reservingComposer(client: obyte.Client, network: ObyteNetwork, address: string, logger: Logger): ReservingComposer;
+export declare function resolveNetwork(name: string): ObyteNetwork;
+export declare function connect(network: ObyteNetwork, hub: string | undefined): obyte.Client;
+export declare function decodeAny(value: string): unknown;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,EAGL,KAAK,YAAY,EAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAoB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACxB,OAAO,EAAE,YAAY,EACrB,CAAC,EAAE;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,IAAI,CAoBN;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,iBAAiB,CAQnB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAOzD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAEpF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAoBhD"}

package/dist/runtime.js

@@ -0,0 +1,86 @@
+import { join } from 'node:path';
+import obyte from 'obyte';
+import { decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, } from '@x402/core/http';
+import { OBYTE_NETWORKS, ObbyxError, explorerUnitUrl, getNetwork, toDisplay, } from '@obbyx/obyte';
+import { createLogger } from '@obbyx/obyte/logger';
+import { obbyxHome } from '@obbyx/obyte/wallet';
+import { CoinReservations, ReservingComposer } from '@obbyx/x402-obyte';
+/** Helpers shared by the commands: network/hub, logger, argument parsing, output. */
+export function printPayment(err, network, p) {
+    const channel = p.extra;
+    if (p.success && channel?.chargedAmount !== undefined) {
+        // batch-settlement: an off-chain voucher, no unit per call.
+        err(`Paid: ${toDisplay(BigInt(channel.chargedAmount), 9)} GBYTE via channel ${channel.channelState?.channelId ?? ''}` +
+            ` (total in this period: ${toDisplay(BigInt(channel.channelState?.chargedCumulativeAmount ?? '0'), 9)} GBYTE)`);
+    }
+    else if (p.success) {
+        err(`Paid: ${toDisplay(BigInt(p.amount ?? '0'), 9)} GBYTE, unit ${p.transaction}\n  ${explorerUnitUrl(network, p.transaction)}`);
+    }
+    else {
+        err(`Payment not completed: ${p.errorReason}${p.transaction ? ` (${p.transaction})` : ''}`);
+    }
+}
+export function cliLogger() {
+    return createLogger({
+        level: process.env['LOG_LEVEL'] ?? 'warn',
+        pretty: process.stderr.isTTY,
+    });
+}
+export function bytesArg(value, name) {
+    if (!/^\d+$/.test(value))
+        throw new ObbyxError('usage', `--${name} must be a whole number of bytes`);
+    return BigInt(value);
+}
+export function seconds(value, name) {
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0 || n > 86_400) {
+        throw new ObbyxError('usage', `--${name} must be a whole number of seconds (1..86400)`);
+    }
+    return n;
+}
+/** Reserving coin picker for this wallet (inputs of unpublished units are never reused). */
+export function reservingComposer(client, network, address, logger) {
+    return new ReservingComposer({
+        client,
+        network: network.caip2,
+        address,
+        reservations: new CoinReservations(join(obbyxHome(), `coins-${network.name}.db`)),
+        logger,
+    });
+}
+export function resolveNetwork(name) {
+    if (name === 'testnet' || name === 'livenet')
+        return OBYTE_NETWORKS[name];
+    try {
+        return getNetwork(name);
+    }
+    catch {
+        throw new ObbyxError('usage', `Unknown --network "${name}" (use testnet or livenet)`);
+    }
+}
+export function connect(network, hub) {
+    return new obyte.Client(hub ?? network.defaultHubUrl, { testnet: network.testnet });
+}
+export function decodeAny(value) {
+    for (const [kind, decode] of [
+        ['PAYMENT-SIGNATURE', decodePaymentSignatureHeader],
+        ['PAYMENT-REQUIRED', decodePaymentRequiredHeader],
+        ['PAYMENT-RESPONSE', decodePaymentResponseHeader],
+    ]) {
+        try {
+            const decoded = decode(value);
+            const looksRight = kind === 'PAYMENT-SIGNATURE'
+                ? 'payload' in decoded && 'accepted' in decoded
+                : kind === 'PAYMENT-REQUIRED'
+                    ? 'accepts' in decoded
+                    : 'success' in decoded;
+            if (looksRight)
+                return { header: kind, value: decoded };
+        }
+        catch {
+            // try next
+        }
+    }
+    throw new ObbyxError('decode_failed', 'Not a recognizable x402 header');
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@obbyx/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "obbyx command line: Obyte wallet, testnet faucet, paying x402 APIs, payment channels, diagnostics",
+  "keywords": [
+    "x402",
+    "obyte",
+    "cli",
+    "payments",
+    "wallet"
+  ],
+  "license": "MIT",
+  "author": "Alexander Ponomarev",
+  "homepage": "https://github.com/Taump/obbyx/tree/master/packages/cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Taump/obbyx.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Taump/obbyx/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "obbyx": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@obbyx/obyte": "^0.1.0",
+    "@obbyx/sdk": "^0.1.0",
+    "@obbyx/x402-obyte": "^0.1.0",
+    "@x402/core": "^2.29.0",
+    "obyte": "0.2.1",
+    "yargs": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/yargs": "^17.0.35"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx --conditions=@obbyx/source src/main.ts"
+  }
 }

package/src/cli.ts

@@ -0,0 +1,139 @@
+import yargs, { type Argv, type CommandModule } from 'yargs';
+import { ObbyxError } from '@obbyx/obyte';
+import { addressCommand } from './commands/address.js';
+import { balanceCommand } from './commands/balance.js';
+import { channelCommands } from './commands/channel.js';
+import { decodeCommand } from './commands/decode.js';
+import { doctorCommand } from './commands/doctor.js';
+import { faucetCommand } from './commands/faucet.js';
+import { initCommand } from './commands/init.js';
+import { logsCommand } from './commands/logs.js';
+import { payCommand } from './commands/pay.js';
+import type { AnyCmd, CliIo, CommandContext } from './commands/types.js';
+
+export type { CliIo } from './commands/types.js';
+export { decodeAny, resolveNetwork } from './runtime.js';
+
+/**
+ * The `obbyx` command line, on yargs. Every command lives in `commands/` as a
+ * definition (name, options, handler); this module only assembles them. The
+ * CLI reference in the docs is generated from the same definitions
+ * (`renderHelp`, `commandPaths`).
+ */
+
+/** Commands store their exit code here (yargs handlers cannot return one). */
+interface RunState {
+  code: number;
+  io: CliIo;
+}
+
+const EPILOG = `Environment:
+  OBBYX_HOME  wallet directory (default ~/.obbyx)
+  LOG_LEVEL   logging to stderr (default warn)
+
+Exit codes: 0 ok, 1 error/usage, 2 refused (HTTP error, faucet refusal), 3 pending (retry later)`;
+
+function commands(state: RunState): { top: AnyCmd[]; channel: AnyCmd[] } {
+  const ctx: CommandContext = {
+    out: state.io.out,
+    err: state.io.err,
+    done: (code) => {
+      state.code = code;
+    },
+  };
+  return {
+    top: [
+      initCommand(ctx),
+      addressCommand(ctx),
+      balanceCommand(ctx),
+      faucetCommand(ctx),
+      payCommand(ctx),
+      doctorCommand(ctx),
+      logsCommand(ctx),
+      decodeCommand(ctx),
+    ] as AnyCmd[],
+    channel: channelCommands(ctx) as AnyCmd[],
+  };
+}
+
+/** Builds the yargs parser. `width` fixes the help width (docs generation). */
+export function buildCli(argv: readonly string[], state: RunState, width?: number): Argv {
+  const defs = commands(state);
+  let cli: Argv = yargs([...argv])
+    .scriptName('obbyx')
+    .usage('obbyx — x402 payments on Obyte\n\nUsage: $0 <command> [options]')
+    .option('network', {
+      type: 'string',
+      default: 'testnet',
+      global: true,
+      choices: ['testnet', 'livenet', 'obyte:testnet', 'obyte:livenet'],
+      describe: 'Obyte network',
+    })
+    .option('hub', { type: 'string', global: true, describe: 'Obyte hub WebSocket URL' });
+  for (const c of defs.top) cli = cli.command(c as unknown as CommandModule);
+  cli = cli
+    .command('channel', 'Payment channels: open, list, status, deposit, close, confirm', (y) => {
+      let ch = y;
+      for (const c of defs.channel) ch = ch.command(c as unknown as CommandModule);
+      return ch.demandCommand(1, 'Choose a channel command').strict();
+    })
+    .demandCommand(1, 'Choose a command')
+    .recommendCommands()
+    .strict()
+    .epilog(EPILOG)
+    .alias('h', 'help')
+    .version(false)
+    .exitProcess(false)
+    .showHelpOnFail(false)
+    .wrap(width ?? Math.min(100, process.stdout.columns ?? 100))
+    .fail((msg, e) => {
+      throw (
+        e ??
+        new ObbyxError('usage', msg.startsWith('Did you mean') ? `Unknown command. ${msg}` : msg)
+      );
+    });
+  return cli;
+}
+
+/** Runs the CLI; returns the process exit code. */
+export async function runCli(argv: readonly string[], io: CliIo): Promise<number> {
+  const state: RunState = { code: 0, io };
+  try {
+    let helpOutput = '';
+    await buildCli(argv, state).parseAsync([...argv], {}, (_e, _a, output) => {
+      helpOutput = output;
+    });
+    if (helpOutput) io.out(helpOutput);
+    return state.code;
+  } catch (e) {
+    io.err(`error: ${e instanceof Error ? e.message : String(e)}`);
+    if (e instanceof ObbyxError && e.code === 'usage') io.err('Run `obbyx --help` for usage.');
+    return 1;
+  }
+}
+
+/** Help text of a command path (e.g. `['channel', 'open']`), for the generated CLI reference. */
+export async function renderHelp(path: readonly string[], width = 100): Promise<string> {
+  const state: RunState = { code: 0, io: { out: () => undefined, err: () => undefined } };
+  let text = '';
+  await buildCli([...path, '--help'], state, width).parseAsync(
+    [...path, '--help'],
+    {},
+    (_e, _a, output) => {
+      text = output;
+    },
+  );
+  return text;
+}
+
+/** Command paths for the reference, in display order (from the same definitions). */
+export function commandPaths(): string[][] {
+  const defs = commands({ code: 0, io: { out: () => undefined, err: () => undefined } });
+  const name = (c: AnyCmd) => String(c.command).split(' ')[0] ?? '';
+  return [
+    [],
+    ...defs.top.map((c) => [name(c)]),
+    ['channel'],
+    ...defs.channel.map((c) => ['channel', name(c)]),
+  ];
+}

package/src/commands/address.ts

@@ -0,0 +1,14 @@
+import { loadWallet } from '@obbyx/obyte/wallet';
+import { resolveNetwork } from '../runtime.js';
+import type { CommandContext, Cmd } from './types.js';
+
+export function addressCommand({ out, done }: CommandContext): Cmd {
+  return {
+    command: 'address',
+    describe: 'Show your address',
+    handler: (a) => {
+      out(loadWallet(resolveNetwork(a.network)).address);
+      done(0);
+    },
+  };
+}

package/src/commands/balance.ts

@@ -0,0 +1,35 @@
+import { toDisplay } from '@obbyx/obyte';
+import { loadWallet } from '@obbyx/obyte/wallet';
+import { connect, resolveNetwork } from '../runtime.js';
+import type { CommandContext, Cmd } from './types.js';
+
+export function balanceCommand({ out, done }: CommandContext): Cmd {
+  return {
+    command: 'balance',
+    describe: 'Show your balance',
+    handler: async (a) => {
+      const network = resolveNetwork(a.network);
+      const wallet = loadWallet(network);
+      const client = connect(network, a.hub);
+      try {
+        const balances = (await client.api.getBalances([wallet.address])) as Record<
+          string,
+          Record<string, { stable: number; pending: number }>
+        >;
+        const mine = balances[wallet.address] ?? {};
+        const bytes = mine['base'] ?? { stable: 0, pending: 0 };
+        out(`${wallet.address} on ${network.caip2}`);
+        out(
+          `  GBYTE: ${toDisplay(BigInt(bytes.stable), 9)} stable, ${toDisplay(BigInt(bytes.pending), 9)} pending`,
+        );
+        for (const [asset, b] of Object.entries(mine)) {
+          if (asset !== 'base')
+            out(`  ${asset}: ${b.stable} stable, ${b.pending} pending (atomic units)`);
+        }
+      } finally {
+        client.close();
+      }
+      done(0);
+    },
+  };
+}