@obbyx/x402-obyte 0.0.0-stage → 0.2.0

package/dist/batch/facilitator.js

@@ -0,0 +1,341 @@
+import { createHash } from 'node:crypto';
+import { OBYTE_CAIP_FAMILY, getNetwork, networkKey, parseChannelDefinition, verifySignedPackage, } from '@obbyx/obyte';
+import { moduleLogger, withLogContext } from '@obbyx/obyte/logger';
+import { acceptedMatches, canonical } from '../exact/requirements.js';
+import { hubCall } from '../hub/hub-call.js';
+import { KeyedQueue } from '../util/keyed-queue.js';
+import { parseStateVars } from '../hub/schemas.js';
+import { BATCH_REASONS as R, BATCH_SCHEME, parseBatchRequirements, voucherMessageSchema, } from './requirements.js';
+const fail = (reason, message) => ({ ok: false, reason, message });
+export class BatchObyteFacilitator {
+    options;
+    scheme = BATCH_SCHEME;
+    caipFamily = OBYTE_CAIP_FAMILY;
+    log;
+    hubTimeoutMs;
+    ackTimeoutMs;
+    now;
+    /** Channel definitions are immutable: cache them. */
+    definitions = new Map();
+    /** One settle at a time per channel inside this process. */
+    /** One voucher at a time per channel inside this process (the DB enforces it across processes). */
+    channels = new KeyedQueue();
+    constructor(options) {
+        this.options = options;
+        this.log = moduleLogger(options.logger, 'x402.batch', { scheme: BATCH_SCHEME });
+        this.hubTimeoutMs = options.hubTimeoutMs ?? 15_000;
+        this.ackTimeoutMs = options.ackTimeoutMs ?? 5_000;
+        this.now = options.now ?? (() => Math.floor(Date.now() / 1000));
+    }
+    getExtra(network) {
+        return {
+            voucherManager: 'facilitator',
+            minTimeout: this.options.minChannelTimeoutSeconds,
+            assets: [...(this.options.allowedAssets.get(network) ?? [])],
+        };
+    }
+    /** The facilitator never signs channel triggers (ADR-0001). */
+    getSigners() {
+        return [];
+    }
+    async verify(payload, requirements) {
+        return withLogContext({ scheme: BATCH_SCHEME, network: requirements.network }, async () => {
+            const checked = await this.check(payload, requirements);
+            if (!checked.ok) {
+                this.log.info({ reason: checked.reason, detail: checked.message }, 'verify rejected');
+                return { isValid: false, invalidReason: checked.reason, invalidMessage: checked.message };
+            }
+            const c = checked.value;
+            const channelKey = this.channelKey(c.req.network.caip2, c.voucher.aa_address);
+            const existing = await this.options.store.commitmentByHash(c.packageHash);
+            if (existing === undefined) {
+                const channel = await this.options.store.channel(channelKey);
+                const committed = channel?.period === c.voucher.period ? channel.committed : 0n;
+                if (channel?.period === c.voucher.period && channel.pendingSeq !== null) {
+                    return {
+                        isValid: false,
+                        invalidReason: R.busy,
+                        invalidMessage: 'Another voucher is in flight',
+                    };
+                }
+                if (BigInt(c.voucher.amount_spent) !== committed + c.req.amount) {
+                    return {
+                        isValid: false,
+                        invalidReason: R.cumulative,
+                        invalidMessage: `Expected amount_spent ${committed + c.req.amount}`,
+                        extra: { chargedCumulativeAmount: committed.toString() },
+                    };
+                }
+            }
+            return { isValid: true, payer: c.payer, extra: { channel: c.voucher.aa_address } };
+        });
+    }
+    async settle(payload, requirements) {
+        return withLogContext({ scheme: BATCH_SCHEME, network: requirements.network }, async () => {
+            const network = requirements.network;
+            const auth = await this.authenticate(payload, requirements);
+            const stored = auth.ok
+                ? await this.options.store.commitmentByHash(auth.value.packageHash)
+                : undefined;
+            const checked = auth.ok && stored === undefined ? await this.newVoucherChecks(auth.value) : auth;
+            if (!checked.ok) {
+                await this.emit({
+                    key: `${requirements.network}:batch:${requirements.payTo}`,
+                    kind: 'voucher_refused',
+                    data: { reason: checked.reason, stage: 'verify' },
+                });
+                return failure(network, checked.reason, checked.message);
+            }
+            const c = checked.value;
+            const channelKey = this.channelKey(c.req.network.caip2, c.voucher.aa_address);
+            return withLogContext({ aa: c.voucher.aa_address, proofId: c.packageHash }, () => this.channels.run(channelKey, () => this.settleLocked(c, channelKey, network)));
+        });
+    }
+    async newVoucherChecks(a) {
+        const live = await this.liveChecks(a);
+        return live.ok ? { ok: true, value: { ...a, balance: live.value.balance } } : live;
+    }
+    async settleLocked(c, channelKey, network) {
+        const store = this.options.store;
+        let commitment = await store.commitmentByHash(c.packageHash);
+        if (commitment !== undefined && commitment.binding !== c.voucher.binding) {
+            return failure(network, 'invalid_payment_reused', 'This voucher is bound to another operation');
+        }
+        if (commitment === undefined) {
+            const appended = await store.appendPending({
+                channelKey,
+                network: c.req.network.caip2,
+                aa: c.voucher.aa_address,
+                payTo: c.req.payTo,
+                payer: c.payer,
+                asset: c.req.asset,
+                period: c.voucher.period,
+                amountSpent: BigInt(c.voucher.amount_spent),
+                paymentAmount: BigInt(c.voucher.payment_amount),
+                binding: c.voucher.binding,
+                packageHash: c.packageHash,
+                packageJson: c.packageJson,
+            });
+            if (!appended.ok) {
+                const reason = appended.reason === 'channel_busy'
+                    ? R.busy
+                    : appended.reason === 'period_mismatch'
+                        ? R.period
+                        : R.cumulative;
+                await this.emit({
+                    key: channelKey,
+                    kind: 'voucher_refused',
+                    data: {
+                        reason,
+                        amountSpent: c.voucher.amount_spent,
+                        committed: appended.committed.toString(),
+                    },
+                });
+                return {
+                    ...failure(network, reason, `Voucher rejected: ${appended.reason}`),
+                    extra: { chargedCumulativeAmount: appended.committed.toString() },
+                };
+            }
+            commitment = appended.commitment;
+            await this.emit({
+                key: channelKey,
+                kind: 'voucher_pending',
+                data: {
+                    seq: commitment.seq,
+                    period: commitment.period,
+                    amountSpent: commitment.amountSpent.toString(),
+                },
+            });
+            this.log.info({ seq: commitment.seq, amountSpent: commitment.amountSpent.toString() }, 'voucher pending');
+        }
+        if (commitment.state === 'pending') {
+            const delivered = await this.options.gateway.deliver(commitment, this.ackTimeoutMs);
+            if (delivered !== 'acked') {
+                // Stored here but not yet confirmed by the seller's watcher: the outcome
+                // is unknown to the client → settlement_pending (x402: non-empty
+                // transaction), retried with the SAME voucher. Distinct from the
+                // definite refusal `…_watcher_unavailable` at verification.
+                this.log.warn({ seq: commitment.seq }, 'watcher did not ack in time; voucher stays pending');
+                await this.emit({ key: channelKey, kind: 'ack_timeout', data: { seq: commitment.seq } });
+                return {
+                    success: false,
+                    errorReason: 'settlement_pending',
+                    errorMessage: "Waiting for the seller's watcher to store this voucher; retry with the same voucher",
+                    transaction: commitmentIdOf(network, commitment),
+                    network,
+                    payer: c.payer,
+                };
+            }
+            commitment =
+                (await store.commit(commitment.seq, {
+                    payTo: commitment.payTo,
+                    network: commitment.network,
+                })) ?? commitment;
+            this.log.info({ seq: commitment.seq }, 'voucher committed (watcher ack)');
+            await this.emit({
+                key: channelKey,
+                kind: 'voucher_committed',
+                data: {
+                    seq: commitment.seq,
+                    period: commitment.period,
+                    amountSpent: commitment.amountSpent.toString(),
+                },
+            });
+        }
+        return this.success(network, c, commitment);
+    }
+    success(network, c, commitment) {
+        return {
+            success: true,
+            payer: c.payer,
+            network,
+            transaction: '',
+            amount: '',
+            extra: {
+                chargedAmount: commitment.paymentAmount.toString(),
+                commitmentId: commitmentIdOf(network, commitment),
+                channelState: {
+                    channelId: commitment.aa,
+                    period: commitment.period,
+                    ...(c.balance === undefined ? {} : { balance: c.balance.toString() }),
+                    chargedCumulativeAmount: commitment.amountSpent.toString(),
+                },
+            },
+        };
+    }
+    // --- verification -----------------------------------------------------------
+    /** Stateless checks: shape, signature, binding, price, the channel's on-chain parameters. */
+    async authenticate(payload, requirements) {
+        if (payload.x402Version !== 2)
+            return fail('invalid_x402_version', 'Only x402 v2 is supported here');
+        if (!acceptedMatches(payload, requirements)) {
+            return fail('invalid_payment_requirements', 'Accepted requirements differ from the server requirements');
+        }
+        const parsed = parseBatchRequirements(requirements);
+        if (!parsed.ok)
+            return fail(parsed.reason, parsed.message);
+        const req = parsed.value;
+        if (!this.options.allowedAssets.get(req.network.caip2)?.has(req.asset)) {
+            return fail('invalid_batch_settlement_obyte_asset', 'Asset is not accepted');
+        }
+        const client = this.options.clients.get(req.network.caip2);
+        if (client === undefined)
+            return fail('invalid_network', 'Network is not served');
+        // Voucher signature (bound to the network) and content.
+        const pkg = payload.payload['signedPackage'];
+        const verified = verifySignedPackage(pkg, { network: req.network });
+        if (!verified.ok)
+            return fail(R.signature, verified.message);
+        const voucher = voucherMessageSchema.safeParse(verified.value.message);
+        if (!voucher.success)
+            return fail(R.payload, `Invalid voucher: ${voucher.error.issues[0]?.message}`);
+        const v = voucher.data;
+        if (v.binding !== req.extra.binding)
+            return fail(R.binding, 'Voucher is bound to another operation');
+        if (BigInt(v.payment_amount) !== req.amount)
+            return fail(R.amount, 'payment_amount must equal the price');
+        // Channel binding: on-chain definition → payTo is party A, signer is party B.
+        const params = await this.channelParams(client, v.aa_address);
+        if (!params.ok)
+            return params;
+        const p = params.value;
+        if (p.addressA !== req.payTo || p.addressB !== verified.value.signer || p.asset !== req.asset) {
+            return fail(R.channelParams, 'Channel does not connect this payer to payTo in this asset');
+        }
+        const minTimeout = Math.max(this.options.minChannelTimeoutSeconds, req.extra.minTimeout);
+        if (p.timeout < minTimeout)
+            return fail(R.timeout, `Channel timeout must be at least ${minTimeout} s`);
+        const packageJson = canonical(pkg);
+        return {
+            ok: true,
+            value: {
+                req,
+                voucher: v,
+                payer: verified.value.signer,
+                channel: p,
+                packageJson,
+                packageHash: createHash('sha256').update(packageJson).digest('hex'),
+            },
+        };
+    }
+    /**
+     * 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).
+     */
+    async liveChecks(c) {
+        const { req, voucher: v } = c;
+        if (req.extra.validUntil < this.now())
+            return fail(R.quoteExpired, 'The payment offer has expired');
+        const client = this.options.clients.get(req.network.caip2);
+        if (client === undefined)
+            return fail('invalid_network', 'Network is not served');
+        // Channel state: same period, not closing, enough confirmed deposit.
+        const vars = await hubCall(() => client.api.getAaStateVars({ address: v.aa_address }), this.hubTimeoutMs);
+        if (vars.kind !== 'ok')
+            return fail(R.ledger, `state vars: ${vars.error}`);
+        const state = parseStateVars(vars.value);
+        if (state === undefined)
+            return fail(R.ledger, 'state vars: malformed hub answer');
+        if (state['period'] !== v.period)
+            return fail(R.period, `Channel period is ${String(state['period'])}`);
+        if (state['close_initiated_by'] !== undefined)
+            return fail(R.closing, 'Channel is being closed');
+        const balance = BigInt(typeof state['balanceB'] === 'number' ? state['balanceB'] : 0);
+        if (BigInt(v.amount_spent) > balance)
+            return fail(R.balance, 'amount_spent exceeds the confirmed deposit');
+        // The seller's watcher must be able to defend the channel (fail-closed).
+        const health = this.options.gateway.health(req.payTo, req.network.caip2, v.aa_address);
+        if (!health.ok && health.closing === true)
+            return fail(R.closing, health.reason ?? 'The seller is closing this channel');
+        if (!health.ok)
+            return fail(R.watcher, health.reason ?? "The seller's watcher is not available");
+        return { ok: true, value: { balance } };
+    }
+    /** Full verification of a new voucher. */
+    async check(payload, requirements) {
+        const auth = await this.authenticate(payload, requirements);
+        if (!auth.ok)
+            return auth;
+        const live = await this.liveChecks(auth.value);
+        if (!live.ok)
+            return live;
+        return { ok: true, value: { ...auth.value, balance: live.value.balance } };
+    }
+    async channelParams(client, aa) {
+        const cached = this.definitions.get(aa);
+        if (cached !== undefined)
+            return { ok: true, value: cached };
+        const res = await hubCall(() => client.api.getDefinition(aa), this.hubTimeoutMs);
+        if (res.kind !== 'ok')
+            return fail(R.ledger, `definition: ${res.error}`);
+        if (res.value === null || res.value === undefined)
+            return fail(R.channel, 'Channel AA is not defined on the ledger');
+        const parsed = parseChannelDefinition(aa, res.value);
+        if (!parsed.ok)
+            return fail(R.channel, parsed.message);
+        this.definitions.set(aa, parsed.value);
+        return { ok: true, value: parsed.value };
+    }
+    /** The journal must never break a payment: failures are logged, not thrown. */
+    async emit(event) {
+        try {
+            await this.options.events?.(event);
+        }
+        catch (err) {
+            this.log.error({ err, kind: event.kind }, 'cannot write payment event');
+        }
+    }
+    channelKey(network, aa) {
+        return networkKey(getNetwork(network), 'aa', aa);
+    }
+}
+function commitmentIdOf(network, c) {
+    return `${network}:${c.aa}:${c.period}:${c.amountSpent}`;
+}
+function failure(network, reason, message) {
+    return { success: false, errorReason: reason, errorMessage: message, transaction: '', network };
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/batch/facilitator.js.map

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

package/dist/batch/gateway.d.ts

@@ -0,0 +1,21 @@
+import type { CommitmentRow } from './store.js';
+/**
+ * Port to the sellers' watchers (ADR-0003, synchronous durable ack).
+ *
+ * `deliver` resolves `acked` only after the seller's watcher confirmed it has
+ * durably stored the commitment; anything else is not an ack. The facilitator
+ * reports success to the resource server only after `acked` (fail-closed).
+ */
+export interface WatcherHealth {
+    readonly ok: boolean;
+    readonly reason?: string;
+    /** The seller announced it is closing this channel: refuse new vouchers for it. */
+    readonly closing?: boolean;
+}
+export interface WatcherGateway {
+    /** Is a watcher for this seller connected, recent and funded for defensive triggers? */
+    health(payTo: string, network: string, aa?: string): WatcherHealth;
+    /** Pushes a commitment and waits for the durable ack (or times out). */
+    deliver(commitment: CommitmentRow, timeoutMs: number): Promise<'acked' | 'timeout'>;
+}
+//# sourceMappingURL=gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/batch/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACnE,wEAAwE;IACxE,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CACrF"}

package/dist/batch/gateway.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gateway.js.map

package/dist/batch/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/batch/gateway.ts"],"names":[],"mappings":""}

package/dist/batch/requirements.d.ts

@@ -0,0 +1,52 @@
+import type { PaymentRequirements } from '@x402/core/types';
+import { type ObyteNetwork, type Verdict } from '@obbyx/obyte';
+import { z } from 'zod';
+export declare const BATCH_SCHEME = "batch-settlement";
+/** Error codes of the Obyte binding (`invalid_batch_settlement_obyte_*`). */
+export declare const BATCH_REASONS: {
+    readonly payload: "invalid_batch_settlement_obyte_payload";
+    readonly signature: "invalid_batch_settlement_obyte_voucher_signature";
+    readonly channel: "invalid_batch_settlement_obyte_channel_not_found";
+    readonly channelParams: "invalid_batch_settlement_obyte_channel_params";
+    readonly timeout: "invalid_batch_settlement_obyte_channel_timeout";
+    readonly period: "invalid_batch_settlement_obyte_period_mismatch";
+    readonly closing: "invalid_batch_settlement_obyte_channel_closing";
+    readonly balance: "invalid_batch_settlement_obyte_cumulative_exceeds_balance";
+    readonly cumulative: "invalid_batch_settlement_obyte_cumulative_amount_mismatch";
+    readonly amount: "invalid_batch_settlement_obyte_payment_amount_mismatch";
+    readonly binding: "invalid_batch_settlement_obyte_binding_mismatch";
+    readonly busy: "invalid_batch_settlement_obyte_channel_busy";
+    readonly watcher: "invalid_batch_settlement_obyte_watcher_unavailable";
+    readonly ledger: "invalid_batch_settlement_obyte_ledger_unavailable";
+    readonly quoteExpired: "invalid_batch_settlement_obyte_quote_expired";
+};
+export declare const batchExtraSchema: z.ZodObject<{
+    binding: z.ZodString;
+    quoteId: z.ZodString;
+    validUntil: z.ZodNumber;
+    baseAa: z.ZodLiteral<"4IRUGAUUCAQ6QRQLG4SNOLOE6VW2STWZ">;
+    minTimeout: z.ZodNumber;
+    paymentFlow: z.ZodOptional<z.ZodEnum<{
+        authorization: "authorization";
+        upfront: "upfront";
+    }>>;
+}, z.core.$strict>;
+export type BatchExtra = z.infer<typeof batchExtraSchema>;
+/** The voucher: a signed package as used by aa-channels-lib, plus our binding. */
+export declare const voucherMessageSchema: z.ZodObject<{
+    aa_address: z.ZodString;
+    period: z.ZodNumber;
+    amount_spent: z.ZodNumber;
+    payment_amount: z.ZodNumber;
+    binding: z.ZodString;
+}, z.core.$strict>;
+export type VoucherMessage = z.infer<typeof voucherMessageSchema>;
+export interface ParsedBatchRequirements {
+    readonly network: ObyteNetwork;
+    readonly asset: string;
+    readonly amount: bigint;
+    readonly payTo: string;
+    readonly extra: BatchExtra;
+}
+export declare function parseBatchRequirements(req: PaymentRequirements): Verdict<ParsedBatchRequirements>;
+//# sourceMappingURL=requirements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/batch/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,OAAO,EAQb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,qBAAqB,CAAC;AAE/C,6EAA6E;AAC7E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;CAgBhB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;kBAiBlB,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,kFAAkF;AAClF,eAAO,MAAM,oBAAoB;;;;;;kBAStB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4BjG"}

package/dist/batch/requirements.js

@@ -0,0 +1,80 @@
+import { CHANNEL_BASE_AA, accept, getNetwork, isAddress, isAssetId, isObyteNetwork, parseAmount, reject, } from '@obbyx/obyte';
+import { z } from 'zod';
+export const BATCH_SCHEME = 'batch-settlement';
+/** Error codes of the Obyte binding (`invalid_batch_settlement_obyte_*`). */
+export const BATCH_REASONS = {
+    payload: 'invalid_batch_settlement_obyte_payload',
+    signature: 'invalid_batch_settlement_obyte_voucher_signature',
+    channel: 'invalid_batch_settlement_obyte_channel_not_found',
+    channelParams: 'invalid_batch_settlement_obyte_channel_params',
+    timeout: 'invalid_batch_settlement_obyte_channel_timeout',
+    period: 'invalid_batch_settlement_obyte_period_mismatch',
+    closing: 'invalid_batch_settlement_obyte_channel_closing',
+    balance: 'invalid_batch_settlement_obyte_cumulative_exceeds_balance',
+    cumulative: 'invalid_batch_settlement_obyte_cumulative_amount_mismatch',
+    amount: 'invalid_batch_settlement_obyte_payment_amount_mismatch',
+    binding: 'invalid_batch_settlement_obyte_binding_mismatch',
+    busy: 'invalid_batch_settlement_obyte_channel_busy',
+    watcher: 'invalid_batch_settlement_obyte_watcher_unavailable',
+    ledger: 'invalid_batch_settlement_obyte_ledger_unavailable',
+    quoteExpired: 'invalid_batch_settlement_obyte_quote_expired',
+};
+export const batchExtraSchema = z
+    .object({
+    binding: z.string().regex(/^[0-9a-f]{64}$/),
+    quoteId: z
+        .string()
+        .min(8)
+        .max(64)
+        .regex(/^[A-Za-z0-9_-]+$/),
+    validUntil: z.number().int().positive(),
+    baseAa: z.literal(CHANNEL_BASE_AA),
+    /** Minimum channel dispute window the seller accepts (seconds). */
+    minTimeout: z.number().int().positive(),
+    // x402 §6.1: Obyte supports the `upfront` flow (settle, then serve) and the
+    // default `authorization` flow; `escrow` and any asset transfer method
+    // (there is none on Obyte: the payer signs the transfer itself) are refused.
+    paymentFlow: z.enum(['authorization', 'upfront']).optional(),
+})
+    .strict();
+/** The voucher: a signed package as used by aa-channels-lib, plus our binding. */
+export const voucherMessageSchema = z
+    .object({
+    aa_address: z.string(),
+    period: z.number().int().positive(),
+    // Safe integers only: a larger JSON number cannot be read back exactly.
+    amount_spent: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    payment_amount: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    binding: z.string().regex(/^[0-9a-f]{64}$/),
+})
+    .strict();
+export function parseBatchRequirements(req) {
+    if (req.scheme !== BATCH_SCHEME)
+        return reject('unsupported_scheme', 'Scheme is not batch-settlement');
+    if (!isObyteNetwork(req.network))
+        return reject('invalid_network', 'Not an Obyte network');
+    if (!isAssetId(req.asset) || !isAddress(req.payTo)) {
+        return reject('invalid_payment_requirements', 'Invalid asset or payTo');
+    }
+    let amount;
+    try {
+        amount = parseAmount(req.amount);
+    }
+    catch {
+        return reject('invalid_payment_requirements', 'Invalid amount');
+    }
+    if (amount <= 0n)
+        return reject('invalid_payment_requirements', 'Amount must be positive');
+    const extra = batchExtraSchema.safeParse(req.extra);
+    if (!extra.success) {
+        return reject('invalid_payment_requirements', `Invalid extra: ${extra.error.issues[0]?.message}`);
+    }
+    return accept({
+        network: getNetwork(req.network),
+        asset: req.asset,
+        amount,
+        payTo: req.payTo,
+        extra: extra.data,
+    });
+}
+//# sourceMappingURL=requirements.js.map

package/dist/batch/requirements.js.map

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