@obbyx/x402-obyte 0.0.0-stage → 0.1.0

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,18 @@
+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';
+//# 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"}

package/dist/index.js

@@ -0,0 +1,18 @@
+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';
+//# 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"}

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.1.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"
+  }
 }

package/src/batch/client-store.ts

@@ -0,0 +1,167 @@
+import { DatabaseSync } from 'node:sqlite';
+
+/**
+ * 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>;
+}
+
+interface Row {
+  network: string;
+  aa: string;
+  pay_to: string;
+  asset: string;
+  timeout: number;
+  salt: string;
+  period: number;
+  committed: string;
+  pending_json: string | null;
+  opened_unit: string | null;
+}
+
+export class ClientChannelStore {
+  private readonly db: DatabaseSync;
+
+  constructor(path: string) {
+    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(): void {
+    this.db.close();
+  }
+
+  add(c: Omit<ClientChannel, 'pending' | 'committed' | 'period'> & { period?: number }): void {
+    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: string): ClientChannel | undefined {
+    const row = this.db.prepare('SELECT * FROM client_channels WHERE aa = ?').get(aa) as
+      Row | undefined;
+    return row === undefined ? undefined : toChannel(row);
+  }
+
+  /** The newest channel to `payTo` in `asset` on `network`. */
+  find(network: string, payTo: string, asset: string): ClientChannel | undefined {
+    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) as Row | undefined;
+    return row === undefined ? undefined : toChannel(row);
+  }
+
+  list(): ClientChannel[] {
+    return (
+      this.db.prepare('SELECT * FROM client_channels ORDER BY created_at').all() as unknown as Row[]
+    ).map(toChannel);
+  }
+
+  /** Records a signed voucher BEFORE it is sent (compare-and-set: fails if one is pending). */
+  setPending(aa: string, pending: PendingVoucher): boolean {
+    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: string, period: number, amountSpent: bigint): void {
+    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: string, resync?: { period: number; committed: bigint }): void {
+    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: string, period: number): void {
+    this.db
+      .prepare(
+        "UPDATE client_channels SET period = ?, committed = '0', pending_json = NULL WHERE aa = ? AND period < ?",
+      )
+      .run(period, aa, period);
+  }
+}
+
+function toChannel(r: Row): ClientChannel {
+  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) as PendingVoucher),
+    openedUnit: r.opened_unit,
+  };
+}