@obbyx/x402-obyte 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Ponomarev
+
+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

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# @obbyx/x402-obyte
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[x402](https://x402.org) payment mechanisms for the [Obyte](https://obyte.org)
+network, for the official `@x402/*` packages and for obbyx.
+
+- **`exact`** — the client signs one Obyte unit per request; the facilitator verifies and broadcasts it.
+- **`batch-settlement`** — instant, fee-free per call over Obyte AA payment channels (cumulative vouchers).
+
+Networks: `obyte:livenet`, `obyte:testnet` (v1: `obyte-livenet`, `obyte-testnet`).
+
+```sh
+npm i @obbyx/x402-obyte obyte @x402/fetch
+```
+
+## Pay with the official `@x402/fetch`
+
+```ts
+import obyte from 'obyte';
+import { wrapFetchWithPayment, x402Client } from '@x402/fetch';
+import { ExactObyteClient } from '@obbyx/x402-obyte';
+import { createLogger } from '@obbyx/obyte/logger';
+import { loadWallet } from '@obbyx/obyte/wallet';
+import { OBYTE_NETWORKS } from '@obbyx/obyte';
+
+const network = OBYTE_NETWORKS.testnet;
+const wallet = loadWallet(network); // ~/.obbyx/wallet-testnet.json (create it with `obbyx init`)
+const client = new obyte.Client(network.defaultHubUrl, { testnet: true, reconnect: true });
+
+const paidFetch = wrapFetchWithPayment(
+  fetch,
+  new x402Client()
+    // GBYTE is not a default USD asset: allow it explicitly, with a cap per payment
+    .setSpendControls({
+      allowedAssets: [{ network: 'obyte:testnet', asset: 'base', maxAmountPerPayment: '50000' }],
+    })
+    .register(
+      'obyte:testnet',
+      new ExactObyteClient({
+        client,
+        network: 'obyte:testnet',
+        privateKey: wallet.privateKey,
+        logger: createLogger(),
+      }),
+    ),
+);
+const res = await paidFetch('https://api.example/paid');
+```
+
+Add a `ReservingComposer` (`composer` option) when one wallet pays concurrently:
+it guarantees two payments never pick the same coins.
+
+## What is inside
+
+| Export                                                                      | Role                                                     |
+| --------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `ExactObyteClient`, `BatchObyteClient`                                      | x402 client mechanisms (`SchemeNetworkClient`)           |
+| `ExactObyteFacilitator`, `ExactObyteFacilitatorV1`, `BatchObyteFacilitator` | facilitator mechanisms (`SchemeNetworkFacilitator`)      |
+| `SettlementStore`, `BatchStore`, `WatcherGateway`                           | storage / watcher ports (+ node:sqlite reference stores) |
+| `ReservingComposer`, `CoinReservations`                                     | coin reservation for concurrent payments                 |
+| `computeBinding`, `bindingsEqual`                                           | binding of a payment to one request                      |
+| `hubCall`, `startHeartbeat`, `parseHistory`, …                              | hub access with timeouts and validated answers           |
+
+Scheme specs, the facilitator, the seller SDK and the CLI:
+[github.com/Taump/obbyx](https://github.com/Taump/obbyx).
+
+Node.js ≥ 24. MIT.

package/dist/batch/client-store.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Buyer-side channel state (node:sqlite, lightweight; used by the SDK/CLI).
+ *
+ * Per channel: the AA params, the current period, the last amount the
+ * facilitator confirmed (`committed`) and at most ONE pending voucher whose
+ * outcome is unknown. While a voucher is pending, no new voucher is signed
+ * (invariant I7); retrying the same operation resends the same voucher.
+ */
+export interface ClientChannel {
+    readonly network: string;
+    readonly aa: string;
+    readonly payTo: string;
+    readonly asset: string;
+    readonly timeout: number;
+    readonly salt: string;
+    readonly period: number;
+    readonly committed: bigint;
+    readonly pending: PendingVoucher | null;
+    readonly openedUnit: string | null;
+}
+export interface PendingVoucher {
+    readonly binding: string;
+    readonly period: number;
+    readonly amountSpent: string;
+    readonly signedPackage: Record<string, unknown>;
+}
+export declare class ClientChannelStore {
+    private readonly db;
+    constructor(path: string);
+    close(): void;
+    add(c: Omit<ClientChannel, 'pending' | 'committed' | 'period'> & {
+        period?: number;
+    }): void;
+    get(aa: string): ClientChannel | undefined;
+    /** The newest channel to `payTo` in `asset` on `network`. */
+    find(network: string, payTo: string, asset: string): ClientChannel | undefined;
+    list(): ClientChannel[];
+    /** Records a signed voucher BEFORE it is sent (compare-and-set: fails if one is pending). */
+    setPending(aa: string, pending: PendingVoucher): boolean;
+    /** The facilitator confirmed `amountSpent` for `period`. */
+    confirm(aa: string, period: number, amountSpent: bigint): void;
+    /** The voucher was definitely refused; optionally resync to the facilitator's committed amount. */
+    dropPending(aa: string, resync?: {
+        period: number;
+        committed: bigint;
+    }): void;
+    /** A new period started on-chain (the channel was closed and reopened). */
+    newPeriod(aa: string, period: number): void;
+}
+//# sourceMappingURL=client-store.d.ts.map

package/dist/batch/client-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-store.d.ts","sourceRoot":"","sources":["../../src/batch/client-store.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAeD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,IAAI,EAAE,MAAM;IAsBxB,KAAK,IAAI,IAAI;IAIb,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAmB3F,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAM1C,6DAA6D;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAS9E,IAAI,IAAI,aAAa,EAAE;IAMvB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO;IAOxD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ9D,mGAAmG;IACnG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY7E,2EAA2E;IAC3E,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAO5C"}

package/dist/batch/client-store.js

@@ -0,0 +1,93 @@
+import { DatabaseSync } from 'node:sqlite';
+export class ClientChannelStore {
+    db;
+    constructor(path) {
+        this.db = new DatabaseSync(path);
+        this.db.exec(`
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = FULL;
+      PRAGMA busy_timeout = 5000;
+      CREATE TABLE IF NOT EXISTS client_channels (
+        aa TEXT PRIMARY KEY,
+        network TEXT NOT NULL,
+        pay_to TEXT NOT NULL,
+        asset TEXT NOT NULL,
+        timeout INTEGER NOT NULL,
+        salt TEXT NOT NULL,
+        period INTEGER NOT NULL,
+        committed TEXT NOT NULL,
+        pending_json TEXT,
+        opened_unit TEXT,
+        created_at INTEGER NOT NULL
+      ) STRICT;
+    `);
+    }
+    close() {
+        this.db.close();
+    }
+    add(c) {
+        this.db
+            .prepare(`INSERT INTO client_channels (aa, network, pay_to, asset, timeout, salt, period, committed, opened_unit, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, '0', ?, ?) ON CONFLICT(aa) DO NOTHING`)
+            .run(c.aa, c.network, c.payTo, c.asset, c.timeout, c.salt, c.period ?? 1, c.openedUnit, Math.floor(Date.now() / 1000));
+    }
+    get(aa) {
+        const row = this.db.prepare('SELECT * FROM client_channels WHERE aa = ?').get(aa);
+        return row === undefined ? undefined : toChannel(row);
+    }
+    /** The newest channel to `payTo` in `asset` on `network`. */
+    find(network, payTo, asset) {
+        const row = this.db
+            .prepare('SELECT * FROM client_channels WHERE network = ? AND pay_to = ? AND asset = ? ORDER BY created_at DESC LIMIT 1')
+            .get(network, payTo, asset);
+        return row === undefined ? undefined : toChannel(row);
+    }
+    list() {
+        return this.db.prepare('SELECT * FROM client_channels ORDER BY created_at').all().map(toChannel);
+    }
+    /** Records a signed voucher BEFORE it is sent (compare-and-set: fails if one is pending). */
+    setPending(aa, pending) {
+        const res = this.db
+            .prepare('UPDATE client_channels SET pending_json = ? WHERE aa = ? AND pending_json IS NULL')
+            .run(JSON.stringify(pending), aa);
+        return Number(res.changes) === 1;
+    }
+    /** The facilitator confirmed `amountSpent` for `period`. */
+    confirm(aa, period, amountSpent) {
+        this.db
+            .prepare('UPDATE client_channels SET period = ?, committed = ?, pending_json = NULL WHERE aa = ?')
+            .run(period, amountSpent.toString(), aa);
+    }
+    /** The voucher was definitely refused; optionally resync to the facilitator's committed amount. */
+    dropPending(aa, resync) {
+        if (resync === undefined) {
+            this.db.prepare('UPDATE client_channels SET pending_json = NULL WHERE aa = ?').run(aa);
+        }
+        else {
+            this.db
+                .prepare('UPDATE client_channels SET pending_json = NULL, period = ?, committed = ? WHERE aa = ?')
+                .run(resync.period, resync.committed.toString(), aa);
+        }
+    }
+    /** A new period started on-chain (the channel was closed and reopened). */
+    newPeriod(aa, period) {
+        this.db
+            .prepare("UPDATE client_channels SET period = ?, committed = '0', pending_json = NULL WHERE aa = ? AND period < ?")
+            .run(period, aa, period);
+    }
+}
+function toChannel(r) {
+    return {
+        network: r.network,
+        aa: r.aa,
+        payTo: r.pay_to,
+        asset: r.asset,
+        timeout: r.timeout,
+        salt: r.salt,
+        period: r.period,
+        committed: BigInt(r.committed),
+        pending: r.pending_json === null ? null : JSON.parse(r.pending_json),
+        openedUnit: r.opened_unit,
+    };
+}
+//# sourceMappingURL=client-store.js.map

package/dist/batch/client-store.js.map

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

package/dist/batch/client.d.ts

@@ -0,0 +1,63 @@
+import type { PaymentPayloadResult, PaymentRequirements, SchemeNetworkClient, SettleResponse } from '@x402/core/types';
+import { type ChannelParams, type ObyteNetwork } from '@obbyx/obyte';
+import { type Logger } from '@obbyx/obyte/logger';
+import obyte from 'obyte';
+import type { ReservingComposer } from '../coins/index.js';
+import type { ClientChannelStore } from './client-store.js';
+/**
+ * Buyer side of `batch-settlement` on Obyte (party B of an AA channel).
+ * obyte.js is used directly: `compose.message` + `api.postJoint` for on-chain
+ * actions, `utils.signMessage` for vouchers, `api.getAaStateVars` for state.
+ */
+export declare const MIN_DEPOSIT = 10001n;
+export declare const TRIGGER_FEE = 10000;
+export interface BatchClientOptions {
+    readonly client: obyte.Client;
+    readonly network: ObyteNetwork;
+    readonly privateKey: Uint8Array;
+    readonly store: ClientChannelStore;
+    readonly logger: Logger;
+    readonly hubTimeoutMs?: number;
+    /** Refuse prices above this per call (atomic units per asset). */
+    readonly maxAmount?: ReadonlyMap<string, bigint>;
+    /** Reserves inputs for on-chain actions (open, deposit, close). */
+    readonly composer?: ReservingComposer;
+}
+/** My address (party B) from the key, via obyte.js public API. */
+export declare function addressOfKey(privateKey: Uint8Array, network: ObyteNetwork): string;
+/**
+ * Opens a channel to `payTo`: publishes the parameterized AA definition and the
+ * first deposit in ONE unit (as aa-channels-lib does). The deposit is credited
+ * by the AA once the unit is stable.
+ */
+export declare function openChannel(options: BatchClientOptions, input: {
+    payTo: string;
+    deposit: bigint;
+    timeout: number;
+    asset?: string;
+}): Promise<{
+    aa: string;
+    unit: string;
+    params: ChannelParams;
+}>;
+export declare function deposit(options: BatchClientOptions, aa: string, amount: bigint): Promise<string>;
+/**
+ * The client (B) starts closing: declares what it spent (the last confirmed
+ * cumulative amount). The seller's watcher confirms at once if honest, or
+ * answers with a fraud proof if B under-declares.
+ */
+export declare function closeChannel(options: BatchClientOptions, aa: string, period: number, spent: bigint): Promise<string>;
+/** Confirms our own close after the dispute window. */
+export declare function confirmClose(options: BatchClientOptions, aa: string, period: number): Promise<string>;
+export declare class BatchObyteClient implements SchemeNetworkClient {
+    private readonly options;
+    readonly scheme = "batch-settlement";
+    private readonly log;
+    constructor(options: BatchClientOptions);
+    /** Is there a usable channel for these requirements? */
+    hasChannel(req: PaymentRequirements): boolean;
+    createPaymentPayload(x402Version: number, requirements: PaymentRequirements): Promise<PaymentPayloadResult>;
+    /** Updates local state from the seller's PAYMENT-RESPONSE (settlement result). */
+    onSettled(requirements: PaymentRequirements, settle: SettleResponse | undefined): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/batch/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/batch/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,YAAY,EAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,mBAAmB,CAAC;AAG5E;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAU,CAAC;AACnC,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAUlF;AAsBD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAmC9D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,qBAAa,gBAAiB,YAAW,mBAAmB;IAI9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,MAAM,sBAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEA,OAAO,EAAE,kBAAkB;IAIxD,wDAAwD;IACxD,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO;IAIvC,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,oBAAoB,CAAC;IA0FhC,kFAAkF;IAClF,SAAS,CAAC,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;CA+CvF"}

package/dist/batch/client.js

@@ -0,0 +1,222 @@
+import { randomBytes } from 'node:crypto';
+import { ObbyxError, channelAddress, channelDefinition, toSafeNumber, } from '@obbyx/obyte';
+import { moduleLogger } from '@obbyx/obyte/logger';
+import obyte from 'obyte';
+import { hubCall } from '../hub/hub-call.js';
+import { parseStateVars } from '../hub/schemas.js';
+import { BATCH_REASONS, BATCH_SCHEME, parseBatchRequirements } from './requirements.js';
+/**
+ * Buyer side of `batch-settlement` on Obyte (party B of an AA channel).
+ * obyte.js is used directly: `compose.message` + `api.postJoint` for on-chain
+ * actions, `utils.signMessage` for vouchers, `api.getAaStateVars` for state.
+ */
+export const MIN_DEPOSIT = 10001n; // the AA treats ≤ 10000 bytes as a bounce-fee-only trigger
+export const TRIGGER_FEE = 10_000;
+/** My address (party B) from the key, via obyte.js public API. */
+export function addressOfKey(privateKey, network) {
+    const signed = obyte.utils.signMessage('obbyx', {
+        privateKey,
+        testnet: network.testnet,
+    });
+    const address = signed.authors[0]?.address;
+    if (address === undefined)
+        throw new ObbyxError('bad_key', 'Cannot derive address');
+    return address;
+}
+async function broadcast(options, messages) {
+    const compose = () => options.client.compose.message('multi', messages, {
+        privateKey: options.privateKey,
+        testnet: options.network.testnet,
+    });
+    const unit = await (options.composer ? options.composer.compose(compose) : compose());
+    const res = await hubCall(() => options.client.api.postJoint({ unit }), options.hubTimeoutMs ?? 15_000);
+    if (res.kind === 'hub_error')
+        throw new ObbyxError('broadcast_rejected', `Hub rejected the unit: ${res.error}`);
+    // ok or unknown: the unit hash identifies it either way; callers can check it later.
+    return String(unit['unit']);
+}
+/**
+ * Opens a channel to `payTo`: publishes the parameterized AA definition and the
+ * first deposit in ONE unit (as aa-channels-lib does). The deposit is credited
+ * by the AA once the unit is stable.
+ */
+export async function openChannel(options, input) {
+    const asset = input.asset ?? 'base';
+    if (asset !== 'base')
+        throw new ObbyxError('unsupported', 'Only bytes channels are supported by the CLI for now');
+    if (input.deposit < MIN_DEPOSIT)
+        throw new ObbyxError('deposit_too_small', `Deposit must be at least ${MIN_DEPOSIT} bytes`);
+    const params = {
+        addressA: input.payTo,
+        addressB: addressOfKey(options.privateKey, options.network),
+        asset,
+        salt: randomBytes(12).toString('hex'),
+        timeout: input.timeout,
+    };
+    const aa = channelAddress(params);
+    const unit = await broadcast(options, [
+        { app: 'definition', payload: { address: aa, definition: channelDefinition(params) } },
+        {
+            app: 'payment',
+            payload: { outputs: [{ address: aa, amount: toSafeNumber(input.deposit) }] },
+        },
+    ]);
+    options.store.add({
+        network: options.network.caip2,
+        aa,
+        payTo: input.payTo,
+        asset,
+        timeout: input.timeout,
+        salt: params.salt ?? '',
+        openedUnit: unit,
+    });
+    moduleLogger(options.logger, 'x402.batch.client').info({ aa, unit, deposit: input.deposit.toString() }, 'channel opened');
+    return { aa, unit, params };
+}
+export function deposit(options, aa, amount) {
+    if (amount < MIN_DEPOSIT)
+        throw new ObbyxError('deposit_too_small', `Deposit must be at least ${MIN_DEPOSIT} bytes`);
+    return broadcast(options, [
+        { app: 'payment', payload: { outputs: [{ address: aa, amount: toSafeNumber(amount) }] } },
+    ]);
+}
+/**
+ * The client (B) starts closing: declares what it spent (the last confirmed
+ * cumulative amount). The seller's watcher confirms at once if honest, or
+ * answers with a fraud proof if B under-declares.
+ */
+export function closeChannel(options, aa, period, spent) {
+    return broadcast(options, [
+        { app: 'payment', payload: { outputs: [{ address: aa, amount: TRIGGER_FEE }] } },
+        { app: 'data', payload: { close: 1, period, transferredFromMe: toSafeNumber(spent) } },
+    ]);
+}
+/** Confirms our own close after the dispute window. */
+export function confirmClose(options, aa, period) {
+    return broadcast(options, [
+        { app: 'payment', payload: { outputs: [{ address: aa, amount: TRIGGER_FEE }] } },
+        { app: 'data', payload: { confirm: 1, period } },
+    ]);
+}
+export class BatchObyteClient {
+    options;
+    scheme = BATCH_SCHEME;
+    log;
+    constructor(options) {
+        this.options = options;
+        this.log = moduleLogger(options.logger, 'x402.batch.client');
+    }
+    /** Is there a usable channel for these requirements? */
+    hasChannel(req) {
+        return this.options.store.find(req.network, req.payTo, req.asset) !== undefined;
+    }
+    async createPaymentPayload(x402Version, requirements) {
+        if (x402Version !== 2)
+            throw new ObbyxError('invalid_x402_version', 'Only x402 v2 is supported');
+        const parsed = parseBatchRequirements(requirements);
+        if (!parsed.ok)
+            throw new ObbyxError(parsed.reason, parsed.message);
+        const req = parsed.value;
+        const cap = this.options.maxAmount?.get(req.asset);
+        if (cap !== undefined && req.amount > cap) {
+            throw new ObbyxError('amount_over_limit', `Price ${req.amount} exceeds the limit ${cap}`);
+        }
+        const store = this.options.store;
+        const channel = store.find(req.network.caip2, req.payTo, req.asset);
+        if (channel === undefined) {
+            throw new ObbyxError('no_channel', `No channel to ${req.payTo}; open one with: obbyx channel open ${req.payTo}`);
+        }
+        if (channel.timeout < req.extra.minTimeout) {
+            throw new ObbyxError('channel_timeout', `The seller requires a channel timeout ≥ ${req.extra.minTimeout} s`);
+        }
+        // Same operation retried: resend the same voucher (never sign a second one).
+        if (channel.pending !== null) {
+            if (channel.pending.binding === req.extra.binding)
+                return { x402Version: 2, payload: { signedPackage: channel.pending.signedPackage } };
+            throw new ObbyxError('payment_pending', `A previous voucher on channel ${channel.aa} has an unknown outcome; retry that request first`);
+        }
+        const vars = await hubCall(() => this.options.client.api.getAaStateVars({ address: channel.aa }), this.options.hubTimeoutMs ?? 15_000);
+        if (vars.kind !== 'ok')
+            throw new ObbyxError('ledger_unavailable', `Cannot read channel state: ${vars.error}`);
+        const state = parseStateVars(vars.value);
+        if (state === undefined)
+            throw new ObbyxError('ledger_unavailable', 'Cannot read channel state: malformed hub answer');
+        const period = typeof state['period'] === 'number' ? state['period'] : undefined;
+        if (period === undefined)
+            throw new ObbyxError('channel_not_funded', 'The channel has no confirmed deposit yet (wait until stable)');
+        if (state['close_initiated_by'] !== undefined)
+            throw new ObbyxError('channel_closing', 'The channel is being closed');
+        if (period > channel.period)
+            store.newPeriod(channel.aa, period);
+        const committed = period > channel.period ? 0n : channel.committed;
+        const amountSpent = committed + req.amount;
+        const balance = BigInt(typeof state['balanceB'] === 'number' ? state['balanceB'] : 0);
+        if (amountSpent > balance) {
+            throw new ObbyxError('channel_exhausted', `Channel balance ${balance} is not enough; deposit more with: obbyx channel deposit ${channel.aa}`);
+        }
+        const message = {
+            aa_address: channel.aa,
+            period,
+            amount_spent: toSafeNumber(amountSpent),
+            payment_amount: toSafeNumber(req.amount),
+            binding: req.extra.binding,
+        };
+        const signedPackage = obyte.utils.signMessage(message, {
+            privateKey: this.options.privateKey,
+            testnet: this.options.network.testnet,
+        });
+        const pending = {
+            binding: req.extra.binding,
+            period,
+            amountSpent: amountSpent.toString(),
+            signedPackage,
+        };
+        if (!store.setPending(channel.aa, pending)) {
+            throw new ObbyxError('payment_pending', 'Another voucher on this channel is in flight');
+        }
+        this.log.info({ aa: channel.aa, period, amountSpent: amountSpent.toString(), binding: req.extra.binding }, 'voucher signed');
+        return { x402Version: 2, payload: { signedPackage } };
+    }
+    /** Updates local state from the seller's PAYMENT-RESPONSE (settlement result). */
+    onSettled(requirements, settle) {
+        const channel = this.options.store.find(requirements.network, requirements.payTo, requirements.asset);
+        const pending = channel?.pending;
+        if (channel === undefined || pending == null)
+            return;
+        if (settle?.success === true) {
+            this.options.store.confirm(channel.aa, pending.period, BigInt(pending.amountSpent));
+            return;
+        }
+        const reason = settle?.errorReason;
+        const charged = settle?.extra
+            ?.chargedCumulativeAmount;
+        if (reason === BATCH_REASONS.cumulative &&
+            typeof charged === 'string' &&
+            /^\d+$/.test(charged)) {
+            // PAYMENT-RESPONSE is NOT authenticated: never raise our committed amount
+            // to an arbitrary value (a malicious seller could make us sign a voucher
+            // for the whole deposit). Accept only:
+            //  - exactly the amount of the voucher WE signed (it was committed earlier), or
+            //  - a lower amount (signing less than before cannot hurt us).
+            const claimed = BigInt(charged);
+            if (claimed === BigInt(pending.amountSpent)) {
+                this.options.store.confirm(channel.aa, pending.period, claimed);
+            }
+            else if (pending.period === channel.period && claimed <= channel.committed) {
+                this.options.store.dropPending(channel.aa, { period: pending.period, committed: claimed });
+            }
+            else {
+                this.options.store.dropPending(channel.aa);
+                this.log.error({ aa: channel.aa, claimed: charged, local: channel.committed.toString() }, 'seller claimed a committed amount we never signed; refusing to resync');
+            }
+        }
+        else if (reason !== undefined &&
+            reason !== 'settlement_pending' &&
+            reason !== BATCH_REASONS.busy) {
+            // Definitely refused (incl. watcher_unavailable at verification): nothing was stored.
+            this.options.store.dropPending(channel.aa);
+        }
+        // settlement_pending / busy / no answer: keep the voucher pending; retry the same operation.
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/batch/client.js.map

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

package/dist/batch/facilitator.d.ts

@@ -0,0 +1,73 @@
+import type { Network, PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse, VerifyResponse } from '@x402/core/types';
+import { type Logger } from '@obbyx/obyte/logger';
+import type obyte from 'obyte';
+import type { WatcherGateway } from './gateway.js';
+import type { SettlementEvent } from '../exact/store.js';
+import type { BatchStore } from './store.js';
+/**
+ * x402 `batch-settlement` facilitator for Obyte AA payment channels
+ * (ADR-0003, facilitator-managed vouchers).
+ *
+ * The client (party B) signs cumulative vouchers `amount_spent` for the
+ * channel AA with the seller (party A = payTo). `/settle` stores the voucher;
+ * it succeeds only after the SELLER'S WATCHER has durably stored it (sync ack),
+ * so the component that defends the channel always holds the latest proof.
+ * No value moves on-chain here; the watcher closes channels later.
+ *
+ * MVP rules: unidirectional channel, one in-flight voucher per channel,
+ * `amount_spent == committed + price`, `payment_amount == price`.
+ */
+export interface BatchObyteFacilitatorOptions {
+    readonly clients: ReadonlyMap<string, obyte.Client>;
+    readonly store: BatchStore;
+    readonly gateway: WatcherGateway;
+    readonly logger: Logger;
+    readonly allowedAssets: ReadonlyMap<string, ReadonlySet<string>>;
+    /** Lowest channel timeout accepted (also advertised in /supported). */
+    readonly minChannelTimeoutSeconds: number;
+    readonly hubTimeoutMs?: number;
+    readonly ackTimeoutMs?: number;
+    /** Payment event journal (logging stream 2); e.g. the facilitator's `events` table. */
+    readonly events?: (event: SettlementEvent) => Promise<void>;
+    readonly now?: () => number;
+}
+export declare class BatchObyteFacilitator implements SchemeNetworkFacilitator {
+    private readonly options;
+    readonly scheme = "batch-settlement";
+    readonly caipFamily: "obyte:*";
+    private readonly log;
+    private readonly hubTimeoutMs;
+    private readonly ackTimeoutMs;
+    private readonly now;
+    /** Channel definitions are immutable: cache them. */
+    private readonly definitions;
+    /** One settle at a time per channel inside this process. */
+    private readonly locks;
+    constructor(options: BatchObyteFacilitatorOptions);
+    getExtra(network: Network): Record<string, unknown>;
+    /** The facilitator never signs channel triggers (ADR-0001). */
+    getSigners(): string[];
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    private newVoucherChecks;
+    private settleLocked;
+    private success;
+    /** Stateless checks: shape, signature, binding, price, the channel's on-chain parameters. */
+    private authenticate;
+    /**
+     * Checks that depend on time and live state: offer validity, channel period,
+     * closing flag, confirmed deposit, the seller's watcher. Applied only to a
+     * NEW voucher: one already stored is re-delivered regardless, because its
+     * outcome is decided by the watcher's ack (refusing it now would report a
+     * definite failure for a voucher the seller may still redeem).
+     */
+    private liveChecks;
+    /** Full verification of a new voucher. */
+    private check;
+    private channelParams;
+    /** The journal must never break a payment: failures are logged, not thrown. */
+    private emit;
+    private channelKey;
+    private withChannelLock;
+}
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/batch/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../src/batch/facilitator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACf,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,KAAK,MAAM,EAAgC,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AASnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,uEAAuE;IACvE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAoBD,qBAAa,qBAAsB,YAAW,wBAAwB;IAYxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,QAAQ,CAAC,MAAM,sBAAgB;IAC/B,QAAQ,CAAC,UAAU,YAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAEhC,OAAO,EAAE,4BAA4B;IAOlE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQnD,+DAA+D;IAC/D,UAAU,IAAI,MAAM,EAAE;IAIhB,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAiCpB,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;YAyBZ,gBAAgB;YAKhB,YAAY;IA2G1B,OAAO,CAAC,OAAO;IA0Bf,6FAA6F;YAC/E,YAAY;IA2D1B;;;;;;OAMG;YACW,UAAU;IA8BxB,0CAA0C;YAC5B,KAAK;YAWL,aAAa;IAa3B,+EAA+E;YACjE,IAAI;IAQlB,OAAO,CAAC,UAAU;YAIJ,eAAe;CAW9B"}