@obbyx/x402-obyte 0.0.0-stage → 0.2.0

package/dist/exact/store.js

@@ -0,0 +1,217 @@
+import { DatabaseSync } from 'node:sqlite';
+import { ObbyxError } from '@obbyx/obyte';
+export const TERMINAL_STATES = new Set([
+    'stable_good',
+    'final_bad',
+    'rejected',
+    'expired',
+]);
+export class StoreLockedError extends ObbyxError {
+    constructor(path, cause) {
+        super('store_locked', `Database ${path} is in use by another facilitator process (one instance per database file)`, { cause, details: { path } });
+    }
+}
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS exact_settlements (
+  key TEXT PRIMARY KEY,
+  network TEXT NOT NULL,
+  unit_hash TEXT NOT NULL,
+  binding TEXT NOT NULL,
+  payer TEXT NOT NULL,
+  pay_to TEXT NOT NULL,
+  asset TEXT NOT NULL,
+  amount TEXT NOT NULL,
+  state TEXT NOT NULL,
+  unit_json TEXT,
+  publish_deadline INTEGER NOT NULL,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  last_error TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+) STRICT;
+CREATE INDEX IF NOT EXISTS exact_settlements_active ON exact_settlements(state)
+  WHERE state IN ('claimed', 'broadcasting', 'accepted');
+CREATE TABLE IF NOT EXISTS events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts INTEGER NOT NULL,
+  key TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  from_state TEXT,
+  to_state TEXT,
+  data TEXT
+) STRICT;
+CREATE INDEX IF NOT EXISTS events_key ON events(key);
+`;
+export class SqliteSettlementStore {
+    db;
+    now;
+    /**
+     * @param path SQLite file, or `:memory:` for tests.
+     * @param now  Clock in unix seconds (injectable for tests).
+     */
+    constructor(path, now = () => Math.floor(Date.now() / 1000)) {
+        this.now = now;
+        this.db = new DatabaseSync(path);
+        try {
+            this.db.exec('PRAGMA busy_timeout = 0');
+            this.db.exec('PRAGMA journal_mode = WAL');
+            this.db.exec('PRAGMA synchronous = FULL');
+            // Exclusive lock for the lifetime of the connection: a second process
+            // fails on its first write instead of racing us.
+            this.db.exec('PRAGMA locking_mode = EXCLUSIVE');
+            this.db.exec('BEGIN IMMEDIATE');
+            this.db.exec(SCHEMA);
+            this.db.exec('COMMIT');
+        }
+        catch (err) {
+            this.db.close();
+            if (isBusy(err))
+                throw new StoreLockedError(path, err);
+            throw err;
+        }
+    }
+    async close() {
+        this.db.close();
+    }
+    /** The exclusive connection, shared with other facilitator stores (e.g. BatchStore). */
+    get database() {
+        return this.db;
+    }
+    async get(key) {
+        return this.getSync(key);
+    }
+    getSync(key) {
+        const row = this.db.prepare('SELECT * FROM exact_settlements WHERE key = ?').get(key);
+        return row === undefined ? undefined : toRecord(row);
+    }
+    /**
+     * Inserts a new settlement in state `claimed` unless the key exists.
+     * Returns the stored record and whether this call created it.
+     */
+    async claim(input) {
+        return this.tx(() => {
+            const existing = this.getSync(input.key);
+            if (existing !== undefined)
+                return { created: false, record: existing };
+            const ts = this.now();
+            this.db
+                .prepare(`INSERT INTO exact_settlements
+            (key, network, unit_hash, binding, payer, pay_to, asset, amount, state, unit_json,
+             publish_deadline, attempts, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'claimed', ?, ?, 0, ?, ?)`)
+                .run(input.key, input.network, input.unitHash, input.binding, input.payer, input.payTo, input.asset, input.amount, input.unitJson, input.publishDeadline, ts, ts);
+            this.insertEvent({ key: input.key, kind: 'claimed', from: null, to: 'claimed' }, ts);
+            return { created: true, record: this.mustGet(input.key) };
+        });
+    }
+    /**
+     * Compare-and-set transition. Returns the new record, or `undefined` if the
+     * current state is not one of `from` (someone else moved it first).
+     */
+    async transition(key, from, to, patch = {}) {
+        return this.tx(() => {
+            const current = this.getSync(key);
+            if (current === undefined || !from.includes(current.state))
+                return undefined;
+            const ts = this.now();
+            this.db
+                .prepare(`UPDATE exact_settlements
+             SET state = ?, last_error = ?, attempts = attempts + ?, updated_at = ?
+           WHERE key = ? AND state = ?`)
+                .run(to, patch.lastError === undefined ? current.lastError : patch.lastError, patch.incrementAttempts === true ? 1 : 0, ts, key, current.state);
+            this.insertEvent({
+                key,
+                kind: 'transition',
+                from: current.state,
+                to,
+                ...(patch.data ? { data: patch.data } : {}),
+            }, ts);
+            return this.mustGet(key);
+        });
+    }
+    /** Records a non-transition event (e.g. a retry) in the payment journal. */
+    async event(event) {
+        this.insertEvent(event, this.now());
+    }
+    /** Non-terminal settlements, oldest first — resumed by the recovery worker. */
+    async touch(key) {
+        this.db
+            .prepare('UPDATE exact_settlements SET updated_at = ? WHERE key = ?')
+            .run(this.now(), key);
+    }
+    async listActive(limit = 100) {
+        const rows = this.db
+            .prepare(`SELECT * FROM exact_settlements
+          WHERE state IN ('claimed', 'broadcasting', 'accepted')
+          ORDER BY updated_at ASC LIMIT ?`)
+            .all(limit);
+        return rows.map(toRecord);
+    }
+    async events(key) {
+        const rows = this.db
+            .prepare('SELECT kind, from_state, to_state, data FROM events WHERE key = ? ORDER BY id')
+            .all(key);
+        return rows.map((r) => ({
+            kind: r.kind,
+            from: r.from_state,
+            to: r.to_state,
+            data: r.data === null ? null : JSON.parse(r.data),
+        }));
+    }
+    /** Drops signed unit bodies of terminal settlements older than `olderThan` (unix s). */
+    async pruneUnitBodies(olderThan) {
+        const res = this.db
+            .prepare(`UPDATE exact_settlements SET unit_json = NULL
+          WHERE unit_json IS NOT NULL AND updated_at < ?
+            AND state IN ('stable_good', 'final_bad', 'rejected', 'expired')`)
+            .run(olderThan);
+        return Number(res.changes);
+    }
+    insertEvent(event, ts) {
+        this.db
+            .prepare('INSERT INTO events (ts, key, kind, from_state, to_state, data) VALUES (?, ?, ?, ?, ?, ?)')
+            .run(ts, event.key, event.kind, event.from ?? null, event.to ?? null, event.data === undefined ? null : JSON.stringify(event.data));
+    }
+    mustGet(key) {
+        const record = this.getSync(key);
+        if (record === undefined)
+            throw new ObbyxError('store_inconsistent', `Missing settlement ${key}`);
+        return record;
+    }
+    tx(fn) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const result = fn();
+            this.db.exec('COMMIT');
+            return result;
+        }
+        catch (err) {
+            this.db.exec('ROLLBACK');
+            throw err;
+        }
+    }
+}
+function toRecord(row) {
+    return {
+        key: row.key,
+        network: row.network,
+        unitHash: row.unit_hash,
+        binding: row.binding,
+        payer: row.payer,
+        payTo: row.pay_to,
+        asset: row.asset,
+        amount: row.amount,
+        state: row.state,
+        unitJson: row.unit_json,
+        publishDeadline: row.publish_deadline,
+        attempts: row.attempts,
+        lastError: row.last_error,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function isBusy(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return /database is locked|SQLITE_BUSY/i.test(message);
+}
+//# sourceMappingURL=store.js.map

package/dist/exact/store.js.map

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

package/dist/hub/heartbeat.d.ts

@@ -0,0 +1,12 @@
+import type obyte from 'obyte';
+/**
+ * Keeps an obyte.js hub connection alive. obyte.js does not schedule
+ * heartbeats itself: the application must call `client.api.heartbeat()`
+ * periodically (its WSClient then skips the call if traffic was recent,
+ * and closes a connection whose heartbeat goes unanswered, letting
+ * `reconnect: true` re-establish it). Hubs drop idle peers without this.
+ *
+ * Returns a function that stops the timer.
+ */
+export declare function startHeartbeat(client: obyte.Client, intervalMs?: number): () => void;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/hub/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/hub/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,GAAG,MAAM,IAAI,CAMpF"}

package/dist/hub/heartbeat.js

@@ -0,0 +1,17 @@
+/**
+ * Keeps an obyte.js hub connection alive. obyte.js does not schedule
+ * heartbeats itself: the application must call `client.api.heartbeat()`
+ * periodically (its WSClient then skips the call if traffic was recent,
+ * and closes a connection whose heartbeat goes unanswered, letting
+ * `reconnect: true` re-establish it). Hubs drop idle peers without this.
+ *
+ * Returns a function that stops the timer.
+ */
+export function startHeartbeat(client, intervalMs = 10_000) {
+    const timer = setInterval(() => {
+        client.api.heartbeat().catch(() => undefined); // closed/reconnecting: the next tick retries
+    }, intervalMs);
+    timer.unref();
+    return () => clearInterval(timer);
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/hub/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/hub/heartbeat.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,UAAU,GAAG,MAAM;IACtE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,6CAA6C;IAC9F,CAAC,EAAE,UAAU,CAAC,CAAC;IACf,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/hub/hub-call.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Outcome of one obyte.js hub request (ADR-0006, invariant I7).
+ *
+ * obyte.js requests have no timeout. It rejects with the hub's error value
+ * (usually a string) for definite hub errors, and with an `Error` for transport
+ * failures. A timeout or transport failure is an UNKNOWN outcome — for
+ * `postJoint` the unit may have been accepted.
+ */
+export type HubOutcome<T> = {
+    readonly kind: 'ok';
+    readonly value: T;
+} | {
+    readonly kind: 'hub_error';
+    readonly error: string;
+} | {
+    readonly kind: 'unknown';
+    readonly error: string;
+};
+export declare function hubCall<T>(request: () => Promise<T>, timeoutMs: number): Promise<HubOutcome<T>>;
+//# sourceMappingURL=hub-call.d.ts.map

package/dist/hub/hub-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-call.d.ts","sourceRoot":"","sources":["../../src/hub/hub-call.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,wBAAsB,OAAO,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAqBxB"}

package/dist/hub/hub-call.js

@@ -0,0 +1,30 @@
+export async function hubCall(request, timeoutMs) {
+    let timer;
+    try {
+        const value = await Promise.race([
+            request(),
+            new Promise((_, rejectTimeout) => {
+                timer = setTimeout(() => rejectTimeout(new Error(`hub request timed out after ${timeoutMs} ms`)), timeoutMs);
+            }),
+        ]);
+        return { kind: 'ok', value };
+    }
+    catch (err) {
+        if (err instanceof Error || err === null || err === undefined) {
+            return { kind: 'unknown', error: err instanceof Error ? err.message : 'no error value' };
+        }
+        return { kind: 'hub_error', error: typeof err === 'string' ? err : safeJson(err) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function safeJson(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=hub-call.js.map

package/dist/hub/hub-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-call.js","sourceRoot":"","sources":["../../src/hub/hub-call.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAyB,EACzB,SAAiB;IAEjB,IAAI,KAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC/B,OAAO,EAAE;YACT,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE;gBACtC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,+BAA+B,SAAS,KAAK,CAAC,CAAC,EAC7E,SAAS,CACV,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC9D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC3F,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IACrF,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/hub/schemas.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { HistoryJoint } from '../coins/index.js';
+export declare const paymentPayloadSchema: z.ZodObject<{
+    asset: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        unit: z.ZodOptional<z.ZodString>;
+        message_index: z.ZodOptional<z.ZodNumber>;
+        output_index: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>>;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        amount: z.ZodNumber;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export declare const ledgerUnitSchema: z.ZodObject<{
+    unit: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    main_chain_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+    }, z.core.$loose>>>;
+    messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        app: z.ZodString;
+        payload: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type LedgerUnit = HistoryJoint['unit'];
+/** A unit from `get_joint` (undefined when malformed). */
+export declare function parseLedgerUnit(raw: unknown): LedgerUnit | undefined;
+export interface ProofchainBall {
+    readonly unit: string;
+    readonly is_nonserial?: boolean | undefined;
+}
+/** `light/get_history` (undefined when malformed). */
+export declare function parseHistory(raw: unknown): {
+    joints: HistoryJoint[];
+    proofchainBalls: ProofchainBall[];
+} | undefined;
+/** `light/get_aa_state_vars`: a plain record (undefined when malformed). */
+export declare function parseStateVars(raw: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/hub/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/hub/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAStD,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAgBvB,CAAC;AAYX,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAQnB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAa9C,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAGpE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,GACX;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,GAAG,SAAS,CAO3E;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGhF"}

package/dist/hub/schemas.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+/**
+ * Shapes of the hub (light vendor) answers we rely on. The hub is trusted for
+ * ledger reads (ADR-0001), but a malformed or unexpected answer must fail
+ * closed ("ledger unavailable"), never crash or be half-read.
+ */
+const safeAmount = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+export const paymentPayloadSchema = z
+    .object({
+    asset: z.string().optional(),
+    inputs: z
+        .array(z
+        .object({
+        unit: z.string().optional(),
+        message_index: z.number().int().optional(),
+        output_index: z.number().int().optional(),
+    })
+        .loose())
+        .optional(),
+    outputs: z.array(z.object({ address: z.string(), amount: safeAmount }).loose()).optional(),
+})
+    .loose();
+/** A message; payment payloads are validated (positions of messages/outputs are kept). */
+const messageSchema = z
+    .object({ app: z.string(), payload: z.unknown().optional() })
+    .loose()
+    .superRefine((m, ctx) => {
+    if (m.app === 'payment' && !paymentPayloadSchema.safeParse(m.payload).success) {
+        ctx.addIssue({ code: 'custom', message: 'malformed payment payload' });
+    }
+});
+export const ledgerUnitSchema = z
+    .object({
+    unit: z.string(),
+    timestamp: z.number().optional(),
+    main_chain_index: z.number().nullable().optional(),
+    authors: z.array(z.object({ address: z.string() }).loose()).optional(),
+    messages: z.array(messageSchema).default([]),
+})
+    .loose();
+const historySchema = z
+    .object({
+    joints: z
+        .array(z.object({ unit: ledgerUnitSchema, ball: z.string().optional() }).loose())
+        .default([]),
+    proofchain_balls: z
+        .array(z.object({ unit: z.string(), is_nonserial: z.boolean().optional() }).loose())
+        .default([]),
+})
+    .loose();
+/** A unit from `get_joint` (undefined when malformed). */
+export function parseLedgerUnit(raw) {
+    const parsed = ledgerUnitSchema.safeParse(raw);
+    return parsed.success ? parsed.data : undefined;
+}
+/** `light/get_history` (undefined when malformed). */
+export function parseHistory(raw) {
+    const parsed = historySchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    return {
+        joints: parsed.data.joints,
+        proofchainBalls: parsed.data.proofchain_balls,
+    };
+}
+/** `light/get_aa_state_vars`: a plain record (undefined when malformed). */
+export function parseStateVars(raw) {
+    const parsed = z.record(z.string(), z.unknown()).safeParse(raw);
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/hub/schemas.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { type HubOutcome, hubCall } from './hub/hub-call.js';
+export { EXACT_SCHEME, type ExactExtra, type ParsedExactRequirements, acceptedMatches, canonical, exactExtraSchema, parseExactRequirements, } from './exact/requirements.js';
+export { type NewSettlement, type SettlementEvent, type SettlementRecord, type SettlementState, type SettlementStore, SqliteSettlementStore, type TransitionPatch, StoreLockedError, TERMINAL_STATES, } from './exact/store.js';
+export { EXACT_SETTLE_REASONS, HISTORY_PROBE_ADDRESS, ExactObyteFacilitator, type ExactObyteFacilitatorOptions, type FinalityPolicy, } from './exact/facilitator.js';
+export { ExactObyteClient, type ExactObyteClientOptions } from './exact/client.js';
+export { type WatcherGateway, type WatcherHealth } from './batch/gateway.js';
+export { BATCH_REASONS, BATCH_SCHEME, type BatchExtra, type ParsedBatchRequirements, type VoucherMessage, batchExtraSchema, parseBatchRequirements, voucherMessageSchema, } from './batch/requirements.js';
+export { type AppendInput, type AppendResult, type BatchStore, SqliteBatchStore, type ChannelRow, type CommitmentRow, type CommitmentState, } from './batch/store.js';
+export { BatchObyteFacilitator, type BatchObyteFacilitatorOptions } from './batch/facilitator.js';
+export { type ClientMessage, type CommitmentMessage, type ServerMessage, WATCHER_LOGIN_PURPOSE, clientMessageSchema, commitmentMessageSchema, loginMessage, serverMessageSchema, verifyWatcherLogin, } from './batch/watcher-protocol.js';
+export { startHeartbeat } from './hub/heartbeat.js';
+export { ClientChannelStore, type ClientChannel, type PendingVoucher, } from './batch/client-store.js';
+export { BatchObyteClient, type BatchClientOptions, MIN_DEPOSIT, TRIGGER_FEE, addressOfKey, closeChannel, confirmClose, deposit, openChannel, } from './batch/client.js';
+export { CoinReservations, type HistoryJoint, type ReservationRow, ReservingComposer, type ReservingComposerOptions, type Utxo, inputKey, selectCoins, unspentOutputs, } from './coins/index.js';
+export { type BindingInput, bindingsEqual, computeBinding, newQuoteId, sha256Hex, } from './binding/binding.js';
+export { ExactObyteFacilitatorV1, type PaymentPayloadV1, type PaymentRequirementsV1, requirementsV1ToV2, requirementsV2ToV1, } from './exact/facilitator-v1.js';
+export { type LedgerUnit, type ProofchainBall, parseHistory, parseLedgerUnit, parseStateVars, } from './hub/schemas.js';
+export { KeyedQueue } from './util/keyed-queue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,IAAI,EACT,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,YAAY,EACjB,aAAa,EACb,cAAc,EACd,UAAU,EACV,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export { hubCall } from './hub/hub-call.js';
+export { EXACT_SCHEME, acceptedMatches, canonical, exactExtraSchema, parseExactRequirements, } from './exact/requirements.js';
+export { SqliteSettlementStore, StoreLockedError, TERMINAL_STATES, } from './exact/store.js';
+export { EXACT_SETTLE_REASONS, HISTORY_PROBE_ADDRESS, ExactObyteFacilitator, } from './exact/facilitator.js';
+export { ExactObyteClient } from './exact/client.js';
+export {} from './batch/gateway.js';
+export { BATCH_REASONS, BATCH_SCHEME, batchExtraSchema, parseBatchRequirements, voucherMessageSchema, } from './batch/requirements.js';
+export { SqliteBatchStore, } from './batch/store.js';
+export { BatchObyteFacilitator } from './batch/facilitator.js';
+export { WATCHER_LOGIN_PURPOSE, clientMessageSchema, commitmentMessageSchema, loginMessage, serverMessageSchema, verifyWatcherLogin, } from './batch/watcher-protocol.js';
+export { startHeartbeat } from './hub/heartbeat.js';
+export { ClientChannelStore, } from './batch/client-store.js';
+export { BatchObyteClient, MIN_DEPOSIT, TRIGGER_FEE, addressOfKey, closeChannel, confirmClose, deposit, openChannel, } from './batch/client.js';
+export { CoinReservations, ReservingComposer, inputKey, selectCoins, unspentOutputs, } from './coins/index.js';
+export { bindingsEqual, computeBinding, newQuoteId, sha256Hex, } from './binding/binding.js';
+export { ExactObyteFacilitatorV1, requirementsV1ToV2, requirementsV2ToV1, } from './exact/facilitator-v1.js';
+export { parseHistory, parseLedgerUnit, parseStateVars, } from './hub/schemas.js';
+export { KeyedQueue } from './util/keyed-queue.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,YAAY,EAGZ,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAML,qBAAqB,EAErB,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GAGtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAgC,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAA2C,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,YAAY,EAIZ,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,gBAAgB,GAIjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAqC,MAAM,wBAAwB,CAAC;AAClG,OAAO,EAIL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,kBAAkB,GAGnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAEhB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAGhB,iBAAiB,EAGjB,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,aAAa,EACb,cAAc,EACd,UAAU,EACV,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EAGvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/util/keyed-queue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs tasks one at a time per key, in arrival order; different keys run in
+ * parallel. A failing task never blocks the ones queued after it. Used where
+ * check-then-act must not interleave within one process: per channel in the
+ * batch facilitator and in the seller watcher.
+ */
+export declare class KeyedQueue {
+    private readonly tails;
+    run<T>(key: string, task: () => Promise<T>): Promise<T>;
+    /** Keys with queued or running tasks (for tests and diagnostics). */
+    get size(): number;
+}
+//# sourceMappingURL=keyed-queue.d.ts.map

package/dist/util/keyed-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-queue.d.ts","sourceRoot":"","sources":["../../src/util/keyed-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAWvD,qEAAqE;IACrE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/util/keyed-queue.js

@@ -0,0 +1,25 @@
+/**
+ * Runs tasks one at a time per key, in arrival order; different keys run in
+ * parallel. A failing task never blocks the ones queued after it. Used where
+ * check-then-act must not interleave within one process: per channel in the
+ * batch facilitator and in the seller watcher.
+ */
+export class KeyedQueue {
+    tails = new Map();
+    run(key, task) {
+        const previous = this.tails.get(key) ?? Promise.resolve();
+        const result = previous.then(task, task);
+        const tail = result.catch(() => undefined);
+        this.tails.set(key, tail);
+        void tail.then(() => {
+            if (this.tails.get(key) === tail)
+                this.tails.delete(key);
+        });
+        return result;
+    }
+    /** Keys with queued or running tasks (for tests and diagnostics). */
+    get size() {
+        return this.tails.size;
+    }
+}
+//# sourceMappingURL=keyed-queue.js.map

package/dist/util/keyed-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-queue.js","sourceRoot":"","sources":["../../src/util/keyed-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACJ,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE7D,GAAG,CAAI,GAAW,EAAE,IAAsB;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qEAAqE;IACrE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@obbyx/x402-obyte",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "x402 payment mechanisms for the Obyte network: exact (on-chain unit) and batch-settlement (AA payment channels)",
+  "keywords": [
+    "x402",
+    "obyte",
+    "payments",
+    "micropayments",
+    "payment-channels",
+    "http-402"
+  ],
+  "license": "MIT",
+  "author": "Alexander Ponomarev",
+  "homepage": "https://github.com/Taump/obbyx/tree/master/packages/x402-obyte#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Taump/obbyx.git",
+    "directory": "packages/x402-obyte"
+  },
+  "bugs": {
+    "url": "https://github.com/Taump/obbyx/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@obbyx/obyte": "^0.1.0",
+    "@x402/core": "^2.29.0",
+    "obyte": "0.2.1",
+    "zod": "^4.6.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }