@obbyx/cli 0.0.0-stage → 0.1.0

package/dist/faucet/device.js

@@ -0,0 +1,222 @@
+// Ambient types for obyte.js internals (declaration only, no code).
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference
+/// <reference path="../../../obyte/src/types/obyte-internal.d.ts" />
+import { createCipheriv, createDecipheriv, createECDH, createHash, randomBytes } from 'node:crypto';
+import obyte from 'obyte';
+import { chashGetChash160, getSourceString, sign, toPublicKey, verify, } from 'obyte/lib/internal.js';
+import { ObbyxError } from '@obbyx/obyte';
+import { startHeartbeat } from '@obbyx/x402-obyte';
+import { moduleLogger } from '@obbyx/obyte/logger';
+export function newDeviceKey() {
+    for (;;) {
+        const priv = randomBytes(32);
+        try {
+            return { priv, pub: toPublicKey(priv) };
+        }
+        catch {
+            // invalid scalar, retry
+        }
+    }
+}
+export function deviceKeyFrom(priv) {
+    return { priv, pub: toPublicKey(priv) };
+}
+/** ocore object_hash.getDeviceAddress: '0' + chash160("s\0" + pubkey) (source-string form of a string). */
+export function deviceAddress(pubkey) {
+    return `0${chashGetChash160(`s\x00${pubkey}`)}`;
+}
+/** sha256 of the source string with nulls removed and without `signature` (ocore getDeviceMessageHashToSign). */
+export function deviceMessageHashToSign(message) {
+    const naked = { ...message };
+    delete naked['signature'];
+    return createHash('sha256')
+        .update(getSourceString(cleanNullsDeep(naked)), 'utf8')
+        .digest();
+}
+function cleanNullsDeep(value) {
+    if (Array.isArray(value))
+        return value.map(cleanNullsDeep);
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, v]) => v !== null && v !== undefined)
+            .map(([k, v]) => [k, cleanNullsDeep(v)]));
+    }
+    return value;
+}
+export function signDeviceMessage(message, key) {
+    return { ...message, signature: sign(deviceMessageHashToSign(message), key.priv) };
+}
+export function sharedSecret(peerPubkey, priv) {
+    const ecdh = createECDH('secp256k1');
+    ecdh.setPrivateKey(Buffer.from(priv));
+    const x = ecdh.computeSecret(Buffer.from(peerPubkey, 'base64'));
+    return createHash('sha256').update(x).digest().subarray(0, 16);
+}
+export function encryptPackage(json, recipientPubkey) {
+    const ephemeral = newDeviceKey();
+    const iv = randomBytes(12);
+    const cipher = createCipheriv('aes-128-gcm', sharedSecret(recipientPubkey, ephemeral.priv), iv);
+    const encrypted = Buffer.concat([cipher.update(JSON.stringify(json), 'utf8'), cipher.final()]);
+    return {
+        encrypted_message: encrypted.toString('base64'),
+        iv: iv.toString('base64'),
+        authtag: cipher.getAuthTag().toString('base64'),
+        dh: { sender_ephemeral_pubkey: ephemeral.pub, recipient_ephemeral_pubkey: recipientPubkey },
+    };
+}
+export function decryptPackage(pkg, keys) {
+    const key = keys.find((k) => k.pub === pkg.dh.recipient_ephemeral_pubkey);
+    if (key === undefined)
+        throw new ObbyxError('device_unknown_key', 'Message encrypted to an unknown key');
+    const decipher = createDecipheriv('aes-128-gcm', sharedSecret(pkg.dh.sender_ephemeral_pubkey, key.priv), Buffer.from(pkg.iv, 'base64'));
+    decipher.setAuthTag(Buffer.from(pkg.authtag, 'base64'));
+    const text = Buffer.concat([
+        decipher.update(Buffer.from(pkg.encrypted_message, 'base64')),
+        decipher.final(),
+    ]).toString('utf8');
+    const json = JSON.parse(text);
+    return json.encrypted_package === undefined ? json : decryptPackage(json.encrypted_package, keys);
+}
+export class DeviceSession {
+    client;
+    key;
+    hubHost;
+    address;
+    temp;
+    listeners = new Set();
+    log;
+    stopHeartbeat;
+    constructor(client, key, hubHost, logger, temp) {
+        this.client = client;
+        this.key = key;
+        this.hubHost = hubHost;
+        // The temp key is persisted by the caller (like ocore) so messages queued
+        // at the hub for the previous session can still be decrypted.
+        this.temp = temp ?? newDeviceKey();
+        this.address = deviceAddress(key.pub);
+        this.stopHeartbeat = startHeartbeat(client);
+        this.log = moduleLogger(logger, 'device', { device: this.address });
+    }
+    /** Connects to `wss://<hubHost>`, logs in with the permanent key and registers a temp key. */
+    static async connect(options) {
+        const client = new obyte.Client(`wss://${options.hubHost}`, {
+            testnet: options.testnet,
+            reconnect: true,
+        });
+        const session = new DeviceSession(client, options.key, options.hubHost, options.logger, options.tempKey);
+        const firstLogin = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new ObbyxError('device_hub_timeout', `Could not log in to ${options.hubHost}`)), options.timeoutMs ?? 15_000);
+            // Per obyte.js: subscriptions and hub login live for ONE connection, so
+            // everything per-connection is (re)done in onConnect after every reconnect.
+            client.onConnect(() => {
+                client.subscribe((_err, message) => {
+                    if (!Array.isArray(message) || message[0] !== 'justsaying')
+                        return;
+                    const { subject, body } = message[1];
+                    if (subject === 'hub/challenge' && typeof body === 'string') {
+                        session.login(body).then(() => {
+                            clearTimeout(timer);
+                            resolve();
+                        }, (err) => session.log.error({ err }, 'hub login failed'));
+                    }
+                    else if (subject === 'hub/message') {
+                        session.onHubMessage(body);
+                    }
+                });
+            });
+        });
+        try {
+            await firstLogin;
+        }
+        catch (err) {
+            session.close();
+            throw err;
+        }
+        return session;
+    }
+    /** Answers the hub challenge and registers our temp key (every connection). */
+    async login(challenge) {
+        this.client.justsaying('hub/login', signDeviceMessage({ challenge, pubkey: this.key.pub }, this.key));
+        const res = await this.api('tempPubkey', signDeviceMessage({ temp_pubkey: this.temp.pub, pubkey: this.key.pub }, this.key));
+        if (res !== 'updated') {
+            throw new ObbyxError('device_login_failed', `Hub did not accept the temp key: ${JSON.stringify(res)}`);
+        }
+        this.log.info({ hub: this.hubHost }, 'logged in to hub');
+    }
+    onMessage(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Sends {from, device_hub, subject, body} encrypted to the recipient's temp key. */
+    async send(recipientPubkey, subject, body) {
+        const temp = (await this.api('getTempPubkey', recipientPubkey));
+        if (typeof temp?.['temp_pubkey'] !== 'string' ||
+            temp['pubkey'] !== recipientPubkey ||
+            typeof temp['signature'] !== 'string' ||
+            !verify(deviceMessageHashToSign(temp), temp['signature'], recipientPubkey)) {
+            throw new ObbyxError('device_bad_temp_key', 'Recipient temp key is missing or not signed by the recipient');
+        }
+        const json = { from: this.address, device_hub: this.hubHost, subject, body };
+        const message = signDeviceMessage({
+            encrypted_package: encryptPackage(json, temp['temp_pubkey']),
+            to: deviceAddress(recipientPubkey),
+            pubkey: this.key.pub,
+        }, this.key);
+        const res = await this.api('deliver', message);
+        if (res !== 'accepted')
+            throw new ObbyxError('device_send_failed', `Hub did not accept the message: ${JSON.stringify(res)}`);
+        this.log.debug({ to: deviceAddress(recipientPubkey), subject }, 'message delivered to hub');
+    }
+    close() {
+        this.stopHeartbeat();
+        this.client.close();
+    }
+    async api(method, ...args) {
+        try {
+            const fn = this.client.api[method];
+            if (fn === undefined)
+                throw new Error(`obyte.js has no api.${method}`);
+            return await fn(...args);
+        }
+        catch (err) {
+            throw new ObbyxError('device_hub_error', `Hub request ${method} failed: ${typeof err === 'string' ? err : String(err)}`);
+        }
+    }
+    onHubMessage(body) {
+        const { message_hash: hash, message } = (body ?? {});
+        if (typeof hash !== 'string' || message === undefined)
+            return;
+        const ack = () => this.client.justsaying('hub/delete', hash);
+        try {
+            const pubkey = message['pubkey'];
+            if (message['to'] !== this.address ||
+                typeof pubkey !== 'string' ||
+                typeof message['signature'] !== 'string' ||
+                !verify(deviceMessageHashToSign(message), message['signature'], pubkey)) {
+                this.log.warn('dropping a message with a bad signature or recipient');
+                return ack();
+            }
+            const json = decryptPackage(message['encrypted_package'], [
+                this.temp,
+                this.key,
+            ]);
+            if (json.from !== deviceAddress(pubkey)) {
+                this.log.warn('dropping a message whose sender does not match its signature');
+                return ack();
+            }
+            const incoming = {
+                from: json.from,
+                fromPubkey: pubkey,
+                subject: String(json.subject),
+                body: json.body,
+            };
+            for (const listener of this.listeners)
+                listener(incoming);
+        }
+        catch (err) {
+            this.log.warn({ err }, 'failed to process an incoming message');
+        }
+        ack();
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/faucet/device.js.map

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

package/dist/faucet/faucet.d.ts

@@ -0,0 +1,40 @@
+import { type ObyteNetwork } from '@obbyx/obyte';
+import { type Logger } from '@obbyx/obyte/logger';
+import { type DeviceKey } from './device.js';
+/**
+ * Testnet faucet over the Obyte bot protocol (byteball/obyte-faucet):
+ * pair with the "Faucet Bot" listed by the testnet hub, send it our address,
+ * read its answer. The bot pays 0.5–1 GBYTE once per 24 h per device.
+ */
+export type FaucetStatus = 'sent' | 'rate_limited' | 'rejected' | 'no_answer';
+export interface FaucetResult {
+    readonly status: FaucetStatus;
+    readonly botMessages: readonly string[];
+    readonly bot: string;
+}
+export interface PairingCode {
+    readonly pubkey: string;
+    readonly hub: string;
+    readonly secret: string;
+}
+export declare function parsePairingCode(code: string): PairingCode;
+/** Classifies the faucet bot's replies (texts from byteball/obyte-faucet start.js). */
+export declare function classifyFaucetReply(text: string): FaucetStatus | undefined;
+/**
+ * Device keys for the CLI (`$OBBYX_HOME/device-<network>.json`, mode 0600):
+ * the permanent key (identity towards bots) and the temp key used for
+ * encryption, both kept across sessions like ocore does.
+ */
+export declare function loadOrCreateDeviceKeys(network: ObyteNetwork, env?: NodeJS.ProcessEnv): {
+    key: DeviceKey;
+    temp: DeviceKey;
+};
+export declare function requestFromFaucet(options: {
+    network: ObyteNetwork;
+    address: string;
+    logger: Logger;
+    timeoutMs?: number;
+    onBotText?: (text: string) => void;
+    env?: NodeJS.ProcessEnv;
+}): Promise<FaucetResult>;
+//# sourceMappingURL=faucet.d.ts.map

package/dist/faucet/faucet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.d.ts","sourceRoot":"","sources":["../../src/faucet/faucet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,aAAa,CAAC;AAGzF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAO1D;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAmBrC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2DxB"}

package/dist/faucet/faucet.js

@@ -0,0 +1,111 @@
+import { randomBytes } from 'node:crypto';
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import obyte from 'obyte';
+import { ObbyxError } from '@obbyx/obyte';
+import { moduleLogger } from '@obbyx/obyte/logger';
+import { DeviceSession, deviceKeyFrom, newDeviceKey } from './device.js';
+import { obbyxHome } from '@obbyx/obyte/wallet';
+export function parsePairingCode(code) {
+    const m = /^([A-Za-z0-9+/]{43}[A-Za-z0-9+/=])@([\w.-]+(?:\/[\w.-]+)*)#(.+)$/.exec(code.trim());
+    const [, pubkey, hub, secret] = m ?? [];
+    if (pubkey === undefined || hub === undefined || secret === undefined) {
+        throw new ObbyxError('bad_pairing_code', `Not a pairing code: ${code}`);
+    }
+    return { pubkey, hub, secret };
+}
+/** Classifies the faucet bot's replies (texts from byteball/obyte-faucet start.js). */
+export function classifyFaucetReply(text) {
+    if (/only once per 24 hours/i.test(text))
+        return 'rate_limited';
+    if (/valid address|unrecognized command/i.test(text))
+        return 'rejected';
+    if (/blackbytes/i.test(text))
+        return 'sent'; // sent after a successful payout
+    return undefined;
+}
+/**
+ * Device keys for the CLI (`$OBBYX_HOME/device-<network>.json`, mode 0600):
+ * the permanent key (identity towards bots) and the temp key used for
+ * encryption, both kept across sessions like ocore does.
+ */
+export function loadOrCreateDeviceKeys(network, env = process.env) {
+    const path = join(obbyxHome(env), `device-${network.name}.json`);
+    const stored = existsSync(path)
+        ? JSON.parse(readFileSync(path, 'utf8'))
+        : undefined;
+    const key = stored ? deviceKeyFrom(Buffer.from(stored.priv, 'base64')) : newDeviceKey();
+    const temp = stored?.tempPriv
+        ? deviceKeyFrom(Buffer.from(stored.tempPriv, 'base64'))
+        : newDeviceKey();
+    if (stored?.tempPriv === undefined) {
+        mkdirSync(obbyxHome(env), { recursive: true, mode: 0o700 });
+        const body = {
+            priv: Buffer.from(key.priv).toString('base64'),
+            tempPriv: Buffer.from(temp.priv).toString('base64'),
+        };
+        writeFileSync(path, `${JSON.stringify(body)}\n`, { mode: 0o600 });
+        chmodSync(path, 0o600);
+    }
+    return { key, temp };
+}
+export async function requestFromFaucet(options) {
+    if (!options.network.testnet)
+        throw new ObbyxError('faucet_testnet_only', 'The faucet is available on testnet only');
+    const log = moduleLogger(options.logger, 'faucet');
+    // 1. Find the faucet bot in the hub's bot directory.
+    const directory = new obyte.Client(options.network.defaultHubUrl, { testnet: true });
+    let code;
+    let botName;
+    try {
+        const bots = await directory.api.getBots();
+        const bot = bots.find((b) => /faucet/i.test(b.name));
+        if (bot === undefined)
+            throw new ObbyxError('faucet_not_found', 'No faucet bot listed by the testnet hub');
+        code = parsePairingCode(bot.pairing_code);
+        botName = bot.name;
+    }
+    finally {
+        directory.close();
+    }
+    log.info({ bot: botName, hub: code.hub }, 'faucet bot found');
+    // 2. Log in to the bot's hub with our device key.
+    const { key, temp } = loadOrCreateDeviceKeys(options.network, options.env);
+    const session = await DeviceSession.connect({
+        hubHost: code.hub,
+        testnet: true,
+        key,
+        tempKey: temp,
+        logger: options.logger,
+    });
+    const texts = [];
+    try {
+        const result = new Promise((resolve) => {
+            const timer = setTimeout(() => resolve('no_answer'), options.timeoutMs ?? 60_000);
+            session.onMessage((m) => {
+                if (m.fromPubkey !== code.pubkey || m.subject !== 'text' || typeof m.body !== 'string')
+                    return;
+                texts.push(m.body);
+                options.onBotText?.(m.body);
+                const status = classifyFaucetReply(m.body);
+                if (status !== undefined) {
+                    clearTimeout(timer);
+                    resolve(status);
+                }
+            });
+        });
+        // 3. Pair, then send our address.
+        await session.send(code.pubkey, 'pairing', {
+            pairing_secret: code.secret,
+            device_name: 'obbyx-cli',
+            reverse_pairing_secret: randomBytes(9).toString('base64'),
+        });
+        await session.send(code.pubkey, 'text', options.address);
+        log.info({ address: options.address }, 'address sent to the faucet');
+        return { status: await result, botMessages: texts, bot: botName };
+    }
+    finally {
+        session.close();
+    }
+}
+//# sourceMappingURL=faucet.js.map

package/dist/faucet/faucet.js.map

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

package/dist/lib/channels.d.ts

@@ -0,0 +1,24 @@
+import type obyte from 'obyte';
+import { type ObyteNetwork } from '@obbyx/obyte';
+import type { Logger } from '@obbyx/obyte/logger';
+import { type ReservingComposer } from '@obbyx/x402-obyte';
+/**
+ * `obbyx channel …` — the buyer's AA payment channels (party B).
+ * State lives in `$OBBYX_HOME/channels-<network>.db`.
+ */
+export declare function channelStorePath(network: ObyteNetwork, env?: NodeJS.ProcessEnv): string;
+export declare function channelCommand(args: {
+    sub: string | undefined;
+    target: string | undefined;
+    deposit?: string;
+    amount?: string;
+    timeout?: string;
+}, ctx: {
+    network: ObyteNetwork;
+    client: obyte.Client;
+    privateKey: Uint8Array;
+    logger: Logger;
+    out: (s?: string) => void;
+    composer?: ReservingComposer;
+}): Promise<number>;
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/lib/channels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAQL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAER;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,EACD,GAAG,EAAE;IACH,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GACA,OAAO,CAAC,MAAM,CAAC,CAuGjB"}

package/dist/lib/channels.js

@@ -0,0 +1,111 @@
+import { join } from 'node:path';
+import { ObbyxError, explorerUnitUrl, fromDisplay, toDisplay, } from '@obbyx/obyte';
+import { ClientChannelStore, closeChannel, confirmClose, deposit, hubCall, openChannel, } from '@obbyx/x402-obyte';
+import { obbyxHome } from '@obbyx/obyte/wallet';
+/**
+ * `obbyx channel …` — the buyer's AA payment channels (party B).
+ * State lives in `$OBBYX_HOME/channels-<network>.db`.
+ */
+export function channelStorePath(network, env = process.env) {
+    return join(obbyxHome(env), `channels-${network.name}.db`);
+}
+export async function channelCommand(args, ctx) {
+    const store = new ClientChannelStore(channelStorePath(ctx.network));
+    const opts = {
+        client: ctx.client,
+        network: ctx.network,
+        privateKey: ctx.privateKey,
+        store,
+        logger: ctx.logger,
+        ...(ctx.composer ? { composer: ctx.composer } : {}),
+    };
+    const { out } = ctx;
+    const gbyte = (v) => `${toDisplay(v, 9)} GBYTE`;
+    try {
+        switch (args.sub) {
+            case 'open': {
+                if (args.target === undefined)
+                    throw new ObbyxError('usage', 'channel open <seller address> --deposit <GBYTE>');
+                if (args.deposit === undefined)
+                    throw new ObbyxError('usage', 'channel open needs --deposit <GBYTE>');
+                const timeout = Number(args.timeout ?? 86_400);
+                if (!Number.isInteger(timeout) || timeout < 60)
+                    throw new ObbyxError('usage', '--window must be ≥ 60 seconds');
+                const { aa, unit } = await openChannel(opts, {
+                    payTo: args.target,
+                    deposit: fromDisplay(args.deposit, 9),
+                    timeout,
+                });
+                out(`Channel ${aa} opened to ${args.target}`);
+                out(`  deposit: ${args.deposit} GBYTE, dispute window: ${timeout} s`);
+                out(`  unit: ${unit}\n  ${explorerUnitUrl(ctx.network, unit)}`);
+                out('Usable once the deposit is stable (minutes under load, up to ~2 h when the network is quiet): obbyx channel status ' +
+                    aa);
+                return 0;
+            }
+            case 'deposit': {
+                const ch = need(store, args.target);
+                if (args.amount === undefined)
+                    throw new ObbyxError('usage', 'channel deposit <aa> --amount <GBYTE>');
+                const unit = await deposit(opts, ch.aa, fromDisplay(args.amount, 9));
+                out(`Deposited ${args.amount} GBYTE to ${ch.aa}: ${unit}`);
+                return 0;
+            }
+            case 'list': {
+                const all = store.list().filter((c) => c.network === ctx.network.caip2);
+                if (all.length === 0)
+                    out('No channels. Open one with: obbyx channel open <seller> --deposit <GBYTE>');
+                for (const c of all) {
+                    out(`${c.aa}  seller ${c.payTo}  period ${c.period}  spent ${gbyte(c.committed)}${c.pending ? '  (voucher pending)' : ''}`);
+                }
+                return 0;
+            }
+            case 'status': {
+                const ch = need(store, args.target);
+                const vars = await hubCall(() => ctx.client.api.getAaStateVars({ address: ch.aa }), 15_000);
+                if (vars.kind !== 'ok')
+                    throw new ObbyxError('ledger_unavailable', vars.error);
+                const v = vars.value;
+                out(`Channel ${ch.aa} → seller ${ch.payTo}`);
+                out(`  on-chain: period ${v['period'] ?? '-'}, deposit ${gbyte(BigInt(Number(v['balanceB'] ?? 0)))}` +
+                    (v['close_initiated_by']
+                        ? `, CLOSING (initiated by ${v['close_initiated_by'] === 'A' ? 'seller' : 'you'})`
+                        : ''));
+                out(`  local:    period ${ch.period}, spent ${gbyte(ch.committed)}${ch.pending ? `, pending voucher ${ch.pending.amountSpent}` : ''}`);
+                if (v['period'] === undefined)
+                    out('  The deposit is not credited yet (waiting for stability).');
+                return 0;
+            }
+            case 'close': {
+                const ch = need(store, args.target);
+                if (ch.pending) {
+                    throw new ObbyxError('payment_pending', 'A voucher has an unknown outcome; retry that request before closing');
+                }
+                const unit = await closeChannel(opts, ch.aa, ch.period, ch.committed);
+                out(`Close requested for period ${ch.period}, declaring ${gbyte(ch.committed)} spent: ${unit}`);
+                out(`The seller confirms at once if this is right; otherwise run \`obbyx channel confirm ${ch.aa}\` after ${ch.timeout} s.`);
+                return 0;
+            }
+            case 'confirm': {
+                const ch = need(store, args.target);
+                const unit = await confirmClose(opts, ch.aa, ch.period);
+                out(`Close confirmed for period ${ch.period}: ${unit}`);
+                return 0;
+            }
+            default:
+                throw new ObbyxError('usage', 'channel open|deposit|list|status|close|confirm');
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+function need(store, aa) {
+    if (aa === undefined)
+        throw new ObbyxError('usage', 'channel address required');
+    const ch = store.get(aa);
+    if (ch === undefined)
+        throw new ObbyxError('no_channel', `Unknown channel ${aa} (see: obbyx channel list)`);
+    return ch;
+}
+//# sourceMappingURL=channels.js.map

package/dist/lib/channels.js.map

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

package/dist/lib/doctor.d.ts

@@ -0,0 +1,7 @@
+import { type ObyteNetwork } from '@obbyx/obyte';
+export declare function doctor(network: ObyteNetwork, opts: {
+    hub?: string;
+    facilitator?: string;
+    out: (s: string) => void;
+}): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,cAAc,CAAC;AAW5D,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACrE,OAAO,CAAC,MAAM,CAAC,CAmHjB"}