@obbyx/x402-obyte 0.0.0-stage → 0.2.0

package/dist/coins/composer.js

@@ -0,0 +1,102 @@
+import { ObbyxError } from '@obbyx/obyte';
+import { moduleLogger } from '@obbyx/obyte/logger';
+import { hubCall } from '../hub/hub-call.js';
+import { parseHistory } from '../hub/schemas.js';
+import { inputKey, selectCoins, unspentOutputs } from './selection.js';
+/**
+ * Installs the reserving coin picker on an obyte.js client and serializes
+ * composes for the wallet. Use `compose(fn)` around every `client.compose.*`.
+ */
+export class ReservingComposer {
+    options;
+    queue = Promise.resolve();
+    lastPick = [];
+    log;
+    now;
+    constructor(options) {
+        this.options = options;
+        this.log = moduleLogger(options.logger, 'x402.coins', { address: options.address });
+        this.now = options.now ?? (() => Math.floor(Date.now() / 1000));
+        const api = options.client.api;
+        api['pickDivisibleCoinsForAmount'] = (params) => this.pick(params);
+    }
+    /** Runs `fn` (which composes exactly one unit) with reservations; returns its unit. */
+    compose(fn, opts = {}) {
+        const run = this.queue.then(async () => {
+            await this.sweep();
+            this.lastPick = [];
+            try {
+                const unit = await fn();
+                const hash = typeof unit.unit === 'string' ? unit.unit : undefined;
+                if (hash === undefined)
+                    throw new ObbyxError('compose_failed', 'Composed unit has no hash');
+                this.options.reservations.bind(this.options.network, this.lastPick, hash, opts.holdUntil);
+                this.log.debug({ unit: hash, inputs: this.lastPick.length }, 'inputs reserved for unit');
+                return unit;
+            }
+            catch (err) {
+                this.options.reservations.releaseUnbound(this.options.network, this.lastPick);
+                throw err;
+            }
+            finally {
+                this.lastPick = [];
+            }
+        });
+        this.queue = run.catch(() => undefined);
+        return run;
+    }
+    /** Releases the inputs of a unit that was composed but provably never sent anywhere. */
+    discard(unit) {
+        this.options.reservations.endUnit(this.options.network, unit);
+    }
+    /** Ends reservations of units now known to the hub, or provably expired. */
+    async sweep() {
+        const { reservations, network, client } = this.options;
+        const releaseAfter = this.options.releaseAfterSeconds ?? 1200;
+        reservations.dropStaleUnbound(network, this.now() - 600);
+        for (const { unit, reservedAt, holdUntil } of reservations.boundUnits(network)) {
+            const res = await hubCall(() => client.api.getJoint(unit), this.options.hubTimeoutMs ?? 15_000);
+            if (res.kind !== 'ok')
+                return; // unknown: keep everything reserved (fail-safe)
+            if (res.value.joint !== undefined) {
+                reservations.endUnit(network, unit); // the hub knows the spend now
+            }
+            else if (this.now() - reservedAt > releaseAfter && this.now() > (holdUntil ?? 0)) {
+                reservations.endUnit(network, unit);
+                this.log.info({ unit }, 'unit was never published; inputs released');
+            }
+        }
+    }
+    async pick(params) {
+        const { client, network, address, reservations } = this.options;
+        if (params.addresses.length !== 1 || params.addresses[0] !== address) {
+            throw new ObbyxError('coins_wrong_address', 'The reserving picker serves a single address');
+        }
+        const asset = params.asset ?? 'base';
+        const t = this.options.hubTimeoutMs ?? 15_000;
+        const history = await hubCall(() => client.api
+            .getWitnesses()
+            .then((witnesses) => client.api.getHistory({ witnesses, addresses: [address] })), t);
+        if (history.kind !== 'ok')
+            throw new ObbyxError('ledger_unavailable', `history: ${history.error}`);
+        const parsedHistory = parseHistory(history.value);
+        if (parsedHistory === undefined)
+            throw new ObbyxError('ledger_unavailable', 'history: malformed hub answer');
+        const joints = parsedHistory.joints;
+        const reserved = reservations.reservedKeys(network);
+        const free = unspentOutputs(joints, address, params.last_ball_mci).filter((u) => !reserved.has(inputKey(network, u)));
+        const picked = selectCoins(free, asset, BigInt(params.amount));
+        if (picked === undefined) {
+            throw new ObbyxError('insufficient_funds', `Not enough unreserved ${asset} (some coins may be reserved by pending payments)`);
+        }
+        reservations.reserve(network, address, picked);
+        this.lastPick.push(...picked);
+        return {
+            inputs_with_proofs: picked.map((u) => ({
+                input: { unit: u.unit, message_index: u.messageIndex, output_index: u.outputIndex },
+            })),
+            total_amount: Number(picked.reduce((s, u) => s + u.amount, 0n)),
+        };
+    }
+}
+//# sourceMappingURL=composer.js.map

package/dist/coins/composer.js.map

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

package/dist/coins/index.d.ts

@@ -0,0 +1,4 @@
+export { type ReservationRow, CoinReservations } from './reservations.js';
+export { type HistoryJoint, type Utxo, inputKey, selectCoins, unspentOutputs, } from './selection.js';
+export { ReservingComposer, type ReservingComposerOptions } from './composer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/coins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/coins/index.js

@@ -0,0 +1,4 @@
+export { CoinReservations } from './reservations.js';
+export { inputKey, selectCoins, unspentOutputs, } from './selection.js';
+export { ReservingComposer } from './composer.js';
+//# sourceMappingURL=index.js.map

package/dist/coins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAGL,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAiC,MAAM,eAAe,CAAC"}

package/dist/coins/reservations.d.ts

@@ -0,0 +1,37 @@
+import { type Utxo } from './selection.js';
+/** Durable (SQLite) reservations of the wallet's coins, bound to the unit that spends them. */
+export interface ReservationRow {
+    input_key: string;
+    network: string;
+    payment_unit: string | null;
+    reserved_at: number;
+}
+export declare class CoinReservations {
+    private readonly now;
+    private readonly db;
+    constructor(path: string, now?: () => number);
+    close(): void;
+    reservedKeys(network: string): Set<string>;
+    /** Reserves all inputs atomically; fails if any is already reserved. */
+    reserve(network: string, address: string, inputs: readonly Utxo[]): void;
+    /**
+     * Binds the inputs reserved for a compose to the resulting unit hash.
+     * `holdUntil`: the unit may still be published until then (offer validity +
+     * the facilitator's publication window), so its inputs are never released earlier.
+     */
+    bind(network: string, inputs: readonly Utxo[], unit: string, holdUntil?: number): void;
+    /** Releases inputs whose compose failed (no unit was produced). */
+    releaseUnbound(network: string, inputs: readonly Utxo[]): void;
+    /** Units with live reservations, oldest first. */
+    boundUnits(network: string): {
+        unit: string;
+        reservedAt: number;
+        holdUntil: number | null;
+    }[];
+    /** Ends all reservations of a unit (seen on the ledger, or provably never published). */
+    endUnit(network: string, unit: string): number;
+    /** Drops reservations of composes that crashed before producing a unit. */
+    dropStaleUnbound(network: string, olderThan: number): number;
+    rows(): ReservationRow[];
+}
+//# sourceMappingURL=reservations.d.ts.map

package/dist/coins/reservations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservations.d.ts","sourceRoot":"","sources":["../../src/coins/reservations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,IAAI,EAAY,MAAM,gBAAgB,CAAC;AAErD,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAGhC,IAAI,EAAE,MAAM,EACK,GAAG,GAAE,MAAM,MAA4C;IAyB1E,KAAK,IAAI,IAAI;IAIb,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAS1C,wEAAwE;IACxE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI;IAiBxE;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAOtF,mEAAmE;IACnE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI;IAO9D,kDAAkD;IAClD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE;IAmB7F,yFAAyF;IACzF,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ9C,2EAA2E;IAC3E,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAU5D,IAAI,IAAI,cAAc,EAAE;CAKzB"}

package/dist/coins/reservations.js

@@ -0,0 +1,102 @@
+import { DatabaseSync } from 'node:sqlite';
+import { ObbyxError } from '@obbyx/obyte';
+import { inputKey } from './selection.js';
+export class CoinReservations {
+    now;
+    db;
+    constructor(path, now = () => Math.floor(Date.now() / 1000)) {
+        this.now = now;
+        this.db = new DatabaseSync(path);
+        this.db.exec(`
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = FULL;
+      PRAGMA busy_timeout = 5000;
+      CREATE TABLE IF NOT EXISTS coin_reservations (
+        input_key TEXT PRIMARY KEY,
+        network TEXT NOT NULL,
+        address TEXT NOT NULL,
+        payment_unit TEXT,
+        reserved_at INTEGER NOT NULL,
+        hold_until INTEGER
+      ) STRICT;
+    `);
+        // Databases created before hold_until existed.
+        const columns = this.db.prepare('PRAGMA table_info(coin_reservations)').all();
+        if (!columns.some((c) => c.name === 'hold_until')) {
+            this.db.exec('ALTER TABLE coin_reservations ADD COLUMN hold_until INTEGER');
+        }
+    }
+    close() {
+        this.db.close();
+    }
+    reservedKeys(network) {
+        const rows = this.db
+            .prepare('SELECT input_key FROM coin_reservations WHERE network = ?')
+            .all(network);
+        return new Set(rows.map((r) => r.input_key));
+    }
+    /** Reserves all inputs atomically; fails if any is already reserved. */
+    reserve(network, address, inputs) {
+        const ts = this.now();
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const insert = this.db.prepare('INSERT INTO coin_reservations (input_key, network, address, payment_unit, reserved_at) VALUES (?, ?, ?, NULL, ?)');
+            for (const u of inputs)
+                insert.run(inputKey(network, u), network, address, ts);
+            this.db.exec('COMMIT');
+        }
+        catch (err) {
+            this.db.exec('ROLLBACK');
+            throw new ObbyxError('coins_reserved', 'An input is already reserved by another payment', {
+                cause: err,
+            });
+        }
+    }
+    /**
+     * Binds the inputs reserved for a compose to the resulting unit hash.
+     * `holdUntil`: the unit may still be published until then (offer validity +
+     * the facilitator's publication window), so its inputs are never released earlier.
+     */
+    bind(network, inputs, unit, holdUntil) {
+        const update = this.db.prepare('UPDATE coin_reservations SET payment_unit = ?, hold_until = ? WHERE input_key = ? AND payment_unit IS NULL');
+        for (const u of inputs)
+            update.run(unit, holdUntil ?? null, inputKey(network, u));
+    }
+    /** Releases inputs whose compose failed (no unit was produced). */
+    releaseUnbound(network, inputs) {
+        const del = this.db.prepare('DELETE FROM coin_reservations WHERE input_key = ? AND payment_unit IS NULL');
+        for (const u of inputs)
+            del.run(inputKey(network, u));
+    }
+    /** Units with live reservations, oldest first. */
+    boundUnits(network) {
+        const rows = this.db
+            .prepare(`SELECT payment_unit, MIN(reserved_at) AS reserved_at, MAX(hold_until) AS hold_until
+           FROM coin_reservations
+          WHERE network = ? AND payment_unit IS NOT NULL GROUP BY payment_unit ORDER BY reserved_at`)
+            .all(network);
+        return rows.map((r) => ({
+            unit: r.payment_unit,
+            reservedAt: r.reserved_at,
+            holdUntil: r.hold_until,
+        }));
+    }
+    /** Ends all reservations of a unit (seen on the ledger, or provably never published). */
+    endUnit(network, unit) {
+        return Number(this.db
+            .prepare('DELETE FROM coin_reservations WHERE network = ? AND payment_unit = ?')
+            .run(network, unit).changes);
+    }
+    /** Drops reservations of composes that crashed before producing a unit. */
+    dropStaleUnbound(network, olderThan) {
+        return Number(this.db
+            .prepare('DELETE FROM coin_reservations WHERE network = ? AND payment_unit IS NULL AND reserved_at < ?')
+            .run(network, olderThan).changes);
+    }
+    rows() {
+        return this.db
+            .prepare('SELECT input_key, network, payment_unit, reserved_at FROM coin_reservations')
+            .all();
+    }
+}
+//# sourceMappingURL=reservations.js.map

package/dist/coins/reservations.js.map

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

package/dist/coins/selection.d.ts

@@ -0,0 +1,42 @@
+/** Coin selection from a light history (pure functions). */
+export interface Utxo {
+    readonly unit: string;
+    readonly messageIndex: number;
+    readonly outputIndex: number;
+    readonly asset: string;
+    readonly amount: bigint;
+}
+export declare function inputKey(network: string, u: Pick<Utxo, 'unit' | 'messageIndex' | 'outputIndex'>): string;
+export interface HistoryJoint {
+    unit: {
+        unit: string;
+        main_chain_index?: number | null;
+        authors?: {
+            address: string;
+        }[];
+        messages?: {
+            app: string;
+            payload?: {
+                asset?: string;
+                inputs?: {
+                    unit?: string;
+                    message_index?: number;
+                    output_index?: number;
+                }[];
+                outputs?: {
+                    address: string;
+                    amount: number;
+                }[];
+            };
+        }[];
+    };
+    ball?: string;
+}
+/**
+ * Unspent outputs of `address` from a `light/get_history` response.
+ * Others' outputs count only if stable and at or before `lastBallMci`.
+ */
+export declare function unspentOutputs(joints: readonly HistoryJoint[], address: string, lastBallMci: number): Utxo[];
+/** Largest-first selection until the target is covered. */
+export declare function selectCoins(utxos: readonly Utxo[], asset: string, target: bigint): Utxo[] | undefined;
+//# sourceMappingURL=selection.d.ts.map

package/dist/coins/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/coins/selection.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,aAAa,CAAC,GACrD,MAAM,CAER;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAChC,QAAQ,CAAC,EAAE;YACT,GAAG,EAAE,MAAM,CAAC;YACZ,OAAO,CAAC,EAAE;gBACR,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,MAAM,CAAC,EAAE;oBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;oBAAC,aAAa,CAAC,EAAE,MAAM,CAAC;oBAAC,YAAY,CAAC,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;gBAC5E,OAAO,CAAC,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAC;oBAAC,MAAM,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;aACjD,CAAC;SACH,EAAE,CAAC;KACL,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,IAAI,EAAE,CAgCR;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,GAAG,SAAS,CAYpB"}

package/dist/coins/selection.js

@@ -0,0 +1,60 @@
+export function inputKey(network, u) {
+    return `${network}:${u.unit}:${u.messageIndex}:${u.outputIndex}`;
+}
+/**
+ * Unspent outputs of `address` from a `light/get_history` response.
+ * Others' outputs count only if stable and at or before `lastBallMci`.
+ */
+export function unspentOutputs(joints, address, lastBallMci) {
+    const spent = new Set();
+    for (const j of joints) {
+        for (const m of j.unit.messages ?? []) {
+            if (m.app !== 'payment')
+                continue;
+            for (const i of m.payload?.inputs ?? []) {
+                if (i.unit !== undefined)
+                    spent.add(`${i.unit}:${i.message_index}:${i.output_index}`);
+            }
+        }
+    }
+    const utxos = [];
+    for (const j of joints) {
+        const own = j.unit.authors?.some((a) => a.address === address) === true;
+        const stable = j.ball !== undefined;
+        const mci = j.unit.main_chain_index;
+        if (!own && !(stable && typeof mci === 'number' && mci <= lastBallMci))
+            continue;
+        (j.unit.messages ?? []).forEach((m, messageIndex) => {
+            if (m.app !== 'payment')
+                return;
+            (m.payload?.outputs ?? []).forEach((o, outputIndex) => {
+                if (o.address !== address || spent.has(`${j.unit.unit}:${messageIndex}:${outputIndex}`))
+                    return;
+                utxos.push({
+                    unit: j.unit.unit,
+                    messageIndex,
+                    outputIndex,
+                    asset: m.payload?.asset ?? 'base',
+                    amount: BigInt(o.amount),
+                });
+            });
+        });
+    }
+    return utxos;
+}
+/** Largest-first selection until the target is covered. */
+export function selectCoins(utxos, asset, target) {
+    const candidates = utxos
+        .filter((u) => u.asset === asset)
+        .sort((a, b) => (a.amount > b.amount ? -1 : a.amount < b.amount ? 1 : 0));
+    const picked = [];
+    let total = 0n;
+    for (const u of candidates) {
+        if (total >= target)
+            break;
+        picked.push(u);
+        total += u.amount;
+    }
+    return total >= target ? picked : undefined;
+}
+//# sourceMappingURL=selection.js.map

package/dist/coins/selection.js.map

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

package/dist/exact/client.d.ts

@@ -0,0 +1,33 @@
+import type { PaymentPayloadContext, PaymentPayloadResult, PaymentRequirements, SchemeNetworkClient } from '@x402/core/types';
+import { type Logger } from '@obbyx/obyte/logger';
+import type obyte from 'obyte';
+import type { ReservingComposer } from '../coins/index.js';
+/**
+ * Client side of `exact` on Obyte: composes and signs (but does NOT
+ * broadcast) a unit paying `payTo` with the seller's binding in a data
+ * message — obyte.js `client.compose.message` used directly.
+ *
+ * With a `composer` (ReservingComposer) inputs are reserved per payment and
+ * composes are serialized, so concurrent payments never pick the same coins.
+ */
+export interface ExactObyteClientOptions {
+    /** obyte.js client connected to a hub of `network`. */
+    readonly client: obyte.Client;
+    readonly network: string;
+    readonly privateKey: Uint8Array;
+    readonly logger: Logger;
+    /** Refuse requirements above this amount (atomic units) per asset. */
+    readonly maxAmount?: ReadonlyMap<string, bigint>;
+    /** Reserves inputs and serializes composes (strongly recommended; see coins.ts). */
+    readonly composer?: ReservingComposer;
+    /** Refuse units whose network fees (headers + payload + tps) exceed this (bytes). */
+    readonly maxFee?: bigint;
+}
+export declare class ExactObyteClient implements SchemeNetworkClient {
+    private readonly options;
+    readonly scheme = "exact";
+    private readonly log;
+    constructor(options: ExactObyteClientOptions);
+    createPaymentPayload(x402Version: number, requirements: PaymentRequirements, context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exact/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,qFAAqF;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD,qBAAa,gBAAiB,YAAW,mBAAmB;IAI9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,MAAM,WAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEA,OAAO,EAAE,uBAAuB;IAIvD,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,mBAAmB,EACjC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;CAuFjC"}

package/dist/exact/client.js

@@ -0,0 +1,93 @@
+import { ObbyxError, toSafeNumber } from '@obbyx/obyte';
+import { moduleLogger } from '@obbyx/obyte/logger';
+import { requirementsV1ToV2 } from './facilitator-v1.js';
+import { EXACT_SCHEME, parseExactRequirements } from './requirements.js';
+/**
+ * Inputs of a signed unit stay reserved at least until the offer expires plus
+ * this margin (covers the facilitator's default publication window). An Obyte
+ * unit never expires, so any release is a heuristic; releasing too early can
+ * only make a LATER payment of ours fail (one of two units spending the same
+ * input becomes final-bad), it cannot pay twice.
+ */
+const PUBLICATION_MARGIN_SECONDS = 900;
+export class ExactObyteClient {
+    options;
+    scheme = EXACT_SCHEME;
+    log;
+    constructor(options) {
+        this.options = options;
+        this.log = moduleLogger(options.logger, 'x402.exact.client');
+    }
+    async createPaymentPayload(x402Version, requirements, context) {
+        if (x402Version !== 1 && x402Version !== 2) {
+            throw new ObbyxError('invalid_x402_version', 'Only x402 v1 and v2 are supported');
+        }
+        // v1 requirements (maxAmountRequired, plain network name) → v2 shape.
+        const v2 = x402Version === 1
+            ? requirementsV1ToV2(requirements)
+            : requirements;
+        const parsed = parseExactRequirements(v2);
+        if (!parsed.ok)
+            throw new ObbyxError(parsed.reason, parsed.message);
+        const req = parsed.value;
+        if (req.network.caip2 !== this.options.network) {
+            throw new ObbyxError('invalid_network', `This client pays on ${this.options.network}`);
+        }
+        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} for ${req.asset}`);
+        }
+        if (context?.maxAmountPerPayment !== undefined &&
+            req.amount > BigInt(context.maxAmountPerPayment)) {
+            throw new ObbyxError('amount_over_limit', 'Price exceeds maxAmountPerPayment');
+        }
+        if (req.extra.validUntil < Math.floor(Date.now() / 1000)) {
+            throw new ObbyxError('quote_expired', 'The payment offer has expired');
+        }
+        const output = { address: req.payTo, amount: toSafeNumber(req.amount) };
+        const payment = req.asset === 'base'
+            ? { app: 'payment', payload: { outputs: [output] } }
+            : { app: 'payment', payload: { asset: req.asset, outputs: [output] } };
+        const data = {
+            app: 'data',
+            payload: { x402: { binding: req.extra.binding, quoteId: req.extra.quoteId } },
+        };
+        const compose = () => this.options.client.compose.message('multi', [payment, data], {
+            privateKey: this.options.privateKey,
+            testnet: req.network.testnet,
+        });
+        // The signed unit stays publishable until the offer expires plus the
+        // facilitator's publication window: keep its inputs reserved that long.
+        const holdUntil = req.extra.validUntil + PUBLICATION_MARGIN_SECONDS;
+        const unit = await (this.options.composer
+            ? this.options.composer.compose(compose, { holdUntil })
+            : compose());
+        const fee = BigInt(Number(unit['headers_commission'] ?? 0)) +
+            BigInt(Number(unit['payload_commission'] ?? 0)) +
+            BigInt(Number(unit['tps_fee'] ?? 0)) +
+            BigInt(Number(unit['burn_fee'] ?? 0)); // same total the facilitator checks
+        if (this.options.maxFee !== undefined && fee > this.options.maxFee) {
+            // The unit was never sent anywhere: its inputs can be released at once.
+            this.options.composer?.discard(String(unit['unit']));
+            throw new ObbyxError('fee_over_limit', `Network fee ${fee} exceeds the limit ${this.options.maxFee} bytes`);
+        }
+        this.log.info({
+            proofId: unit['unit'],
+            payTo: req.payTo,
+            asset: req.asset,
+            amount: req.amount.toString(),
+            binding: req.extra.binding,
+        }, 'payment unit signed (not broadcast)');
+        // v1: the mechanism returns the complete payload (core passes it through as-is).
+        if (x402Version === 1) {
+            return {
+                x402Version: 1,
+                scheme: EXACT_SCHEME,
+                network: requirements.network,
+                payload: { unit },
+            };
+        }
+        return { x402Version, payload: { unit } };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/exact/client.js.map

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

package/dist/exact/facilitator-v1.d.ts

@@ -0,0 +1,48 @@
+import type { Network, PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse, VerifyResponse } from '@x402/core/types';
+import type { ExactObyteFacilitator } from './facilitator.js';
+/**
+ * x402 **v1** for the Obyte `exact` scheme.
+ *
+ * v1 differs in shape only: plain network names (`obyte-testnet`),
+ * `maxAmountRequired`, `resource`/`mimeType` inside the requirements, and a
+ * payload without `accepted`. This adapter converts to the v2 shapes and runs
+ * the SAME v2 mechanism with the SAME store: settlement keys use the CAIP-2 id,
+ * so a proof spent through v1 can never be spent again through v2 (and vice versa).
+ */
+export interface PaymentRequirementsV1 {
+    readonly scheme: string;
+    readonly network: string;
+    readonly maxAmountRequired: string;
+    readonly resource: string;
+    readonly description: string;
+    readonly mimeType: string;
+    readonly outputSchema?: Record<string, unknown>;
+    readonly payTo: string;
+    readonly maxTimeoutSeconds: number;
+    readonly asset: string;
+    readonly extra: Record<string, unknown>;
+}
+export interface PaymentPayloadV1 {
+    readonly x402Version: 1;
+    readonly scheme: string;
+    readonly network: string;
+    readonly payload: Record<string, unknown>;
+}
+export declare function requirementsV1ToV2(req: PaymentRequirementsV1): PaymentRequirements;
+export declare function requirementsV2ToV1(req: PaymentRequirements, resource: {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}): PaymentRequirementsV1;
+export declare class ExactObyteFacilitatorV1 implements SchemeNetworkFacilitator {
+    private readonly v2;
+    readonly scheme = "exact";
+    readonly caipFamily = "obyte-*";
+    constructor(v2: ExactObyteFacilitator);
+    getExtra(network: Network): Record<string, unknown> | undefined;
+    getSigners(): string[];
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    private convert;
+}
+//# sourceMappingURL=facilitator-v1.d.ts.map

package/dist/exact/facilitator-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator-v1.d.ts","sourceRoot":"","sources":["../../src/exact/facilitator-v1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,qBAAqB,GAAG,mBAAmB,CAUlF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,qBAAqB,CAcvB;AAED,qBAAa,uBAAwB,YAAW,wBAAwB;IAI1D,OAAO,CAAC,QAAQ,CAAC,EAAE;IAH/B,QAAQ,CAAC,MAAM,WAAgB;IAC/B,QAAQ,CAAC,UAAU,aAAa;gBAEH,EAAE,EAAE,qBAAqB;IAEtD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAI/D,UAAU,IAAI,MAAM,EAAE;IAIhB,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAMpB,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAS1B,OAAO,CAAC,OAAO;CA4BhB"}