@obbyx/obyte 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Ponomarev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# @obbyx/obyte
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Obyte primitives used by the obbyx x402 packages.
+
+| Entry                 | Contents                                                                                                                                                                      |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@obbyx/obyte`        | networks (`obyte:livenet`/`obyte:testnet`, v1 names), BigInt amounts, `validateExactUnit` (payment-unit profile), `verifySignedPackage`, channel AA definitions, `ObbyxError` |
+| `@obbyx/obyte/wallet` | single-address wallet file (`$OBBYX_HOME/wallet-<network>.json`, mode 0600), validated on load                                                                                |
+| `@obbyx/obyte/logger` | structured logger (pino) with redaction of keys, units and vouchers                                                                                                           |
+| `@obbyx/obyte/config` | zod-based environment configuration                                                                                                                                           |
+
+```sh
+npm i @obbyx/obyte obyte
+```
+
+Part of [obbyx](https://github.com/Taump/obbyx). Node.js ≥ 24. MIT.

package/dist/channel/definition.d.ts

@@ -0,0 +1,38 @@
+import { type Verdict } from '../core/result.js';
+/**
+ * AA payment channels (aa-channels-lib, base AA v1.1).
+ *
+ * Party A is the payee (seller, x402 `payTo`), party B the payer (client).
+ * A channel address is derived from its parameters, so binding a payment to a
+ * seller is a matter of recomputing the address (ADR-0003): parameters are
+ * taken from the on-chain definition, never trusted from a package alone.
+ */
+export declare const CHANNEL_BASE_AA = "4IRUGAUUCAQ6QRQLG4SNOLOE6VW2STWZ";
+export interface ChannelParams {
+    readonly addressA: string;
+    readonly addressB: string;
+    /** `'base'` for bytes, otherwise a 44-char asset id. */
+    readonly asset: string;
+    readonly salt?: string;
+    /** Dispute window in seconds. */
+    readonly timeout: number;
+}
+export type ChannelDefinition = readonly [
+    'autonomous agent',
+    {
+        readonly base_aa: string;
+        readonly params: ChannelParams;
+    }
+];
+/** obyte.js `isValidAddress` as a type guard; it also rejects non-strings. */
+export declare function isAddress(value: unknown): value is string;
+export declare function isAssetId(value: unknown): value is string;
+export declare function validateChannelParams(params: unknown): Verdict<ChannelParams>;
+export declare function channelDefinition(params: ChannelParams): ChannelDefinition;
+export declare function channelAddress(params: ChannelParams): string;
+/**
+ * Parses an on-chain AA definition and returns its channel parameters if it
+ * is an instance of the supported base AA whose address matches `address`.
+ */
+export declare function parseChannelDefinition(address: string, definition: unknown): Verdict<ChannelParams>;
+//# sourceMappingURL=definition.d.ts.map

package/dist/channel/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/channel/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,qCAAqC,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS;IACvC,kBAAkB;IAClB;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;KAAE;CAC7D,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA0B7E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAW1E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/channel/definition.js

@@ -0,0 +1,86 @@
+import obyte from 'obyte';
+import { accept, isPlainObject, reject } from '../core/result.js';
+/**
+ * AA payment channels (aa-channels-lib, base AA v1.1).
+ *
+ * Party A is the payee (seller, x402 `payTo`), party B the payer (client).
+ * A channel address is derived from its parameters, so binding a payment to a
+ * seller is a matter of recomputing the address (ADR-0003): parameters are
+ * taken from the on-chain definition, never trusted from a package alone.
+ */
+export const CHANNEL_BASE_AA = '4IRUGAUUCAQ6QRQLG4SNOLOE6VW2STWZ';
+/** obyte.js `isValidAddress` as a type guard; it also rejects non-strings. */
+export function isAddress(value) {
+    return typeof value === 'string' && obyte.utils.isValidAddress(value);
+}
+const ASSET_RE = /^[A-Za-z0-9+/]{43}=$/;
+export function isAssetId(value) {
+    return value === 'base' || (typeof value === 'string' && ASSET_RE.test(value));
+}
+export function validateChannelParams(params) {
+    if (!isPlainObject(params))
+        return reject('invalid_channel_params', 'Params must be an object');
+    const { addressA, addressB, asset, salt, timeout } = params;
+    const extra = Object.keys(params).filter((k) => !['addressA', 'addressB', 'asset', 'salt', 'timeout'].includes(k));
+    if (extra.length > 0)
+        return reject('invalid_channel_params', `Unexpected params: ${extra.join(', ')}`);
+    if (!isAddress(addressA) || !isAddress(addressB)) {
+        return reject('invalid_channel_params', 'addressA and addressB must be valid addresses');
+    }
+    if (addressA === addressB)
+        return reject('invalid_channel_params', 'Parties must differ');
+    if (!isAssetId(asset))
+        return reject('invalid_channel_params', 'Invalid asset');
+    if (salt !== undefined && (typeof salt !== 'string' || salt.length === 0 || salt.length > 100)) {
+        return reject('invalid_channel_params', 'Invalid salt');
+    }
+    if (!Number.isSafeInteger(timeout) || timeout <= 0) {
+        return reject('invalid_channel_params', 'timeout must be a positive integer (seconds)');
+    }
+    return accept({
+        addressA,
+        addressB,
+        asset,
+        ...(salt === undefined ? {} : { salt: salt }),
+        timeout: timeout,
+    });
+}
+export function channelDefinition(params) {
+    // Key order matters for nothing (JSON source string sorts keys) but is kept
+    // identical to aa-channels-lib for readability.
+    const p = {
+        addressA: params.addressA,
+        addressB: params.addressB,
+        asset: params.asset,
+        ...(params.salt === undefined ? {} : { salt: params.salt }),
+        timeout: params.timeout,
+    };
+    return ['autonomous agent', { base_aa: CHANNEL_BASE_AA, params: p }];
+}
+export function channelAddress(params) {
+    return obyte.utils.getChash160(channelDefinition(params));
+}
+/**
+ * Parses an on-chain AA definition and returns its channel parameters if it
+ * is an instance of the supported base AA whose address matches `address`.
+ */
+export function parseChannelDefinition(address, definition) {
+    if (!Array.isArray(definition) ||
+        definition.length !== 2 ||
+        definition[0] !== 'autonomous agent' ||
+        !isPlainObject(definition[1])) {
+        return reject('invalid_channel_definition', 'Not a parameterized AA definition');
+    }
+    const body = definition[1];
+    if (body['base_aa'] !== CHANNEL_BASE_AA) {
+        return reject('invalid_channel_definition', 'AA is not an instance of the supported channel base AA');
+    }
+    const params = validateChannelParams(body['params']);
+    if (!params.ok)
+        return params;
+    if (channelAddress(params.value) !== address) {
+        return reject('invalid_channel_definition', 'Definition does not match the channel address');
+    }
+    return params;
+}
+//# sourceMappingURL=definition.js.map

package/dist/channel/definition.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { ObbyxError } from '../core/errors.js';
+/**
+ * Configuration is validated with zod at startup; an invalid config stops the
+ * process with a list of *all* problems rather than failing later at runtime.
+ * The same schemas generate the configuration reference in the docs.
+ */
+export declare class ConfigError extends ObbyxError {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+export declare function loadConfig<S extends z.ZodType>(schema: S, source: unknown): z.output<S>;
+/** Reusable env-var helpers. */
+export declare const envBoolean: z.ZodPipe<z.ZodEnum<{
+    0: "0";
+    1: "1";
+    true: "true";
+    false: "false";
+    yes: "yes";
+    no: "no";
+}>, z.ZodTransform<boolean, "0" | "1" | "true" | "false" | "yes" | "no">>;
+export declare const envPort: z.ZodCoercedNumber<unknown>;
+export declare const logLevelSchema: z.ZodEnum<{
+    error: "error";
+    fatal: "fatal";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+    trace: "trace";
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE,SAAS,MAAM,EAAE;CAMtC;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAWvF;AAED,gCAAgC;AAChC,eAAO,MAAM,UAAU;;;;;;;yEAEsC,CAAC;AAE9D,eAAO,MAAM,OAAO,6BAA4C,CAAC;AAEjE,eAAO,MAAM,cAAc;;;;;;;EAA+D,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { ObbyxError } from '../core/errors.js';
+/**
+ * Configuration is validated with zod at startup; an invalid config stops the
+ * process with a list of *all* problems rather than failing later at runtime.
+ * The same schemas generate the configuration reference in the docs.
+ */
+export class ConfigError extends ObbyxError {
+    issues;
+    constructor(issues) {
+        super('invalid_config', `Invalid configuration:\n  - ${issues.join('\n  - ')}`, {
+            details: { issues },
+        });
+        this.issues = issues;
+    }
+}
+export function loadConfig(schema, source) {
+    const result = schema.safeParse(source);
+    if (!result.success) {
+        throw new ConfigError(result.error.issues.map((issue) => {
+            const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+            return `${path}: ${issue.message}`;
+        }));
+    }
+    return result.data;
+}
+/** Reusable env-var helpers. */
+export const envBoolean = z
+    .enum(['1', '0', 'true', 'false', 'yes', 'no'])
+    .transform((v) => v === '1' || v === 'true' || v === 'yes');
+export const envPort = z.coerce.number().int().min(1).max(65535);
+export const logLevelSchema = z.enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace']);
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IAChC,MAAM,CAAoB;IAEnC,YAAY,MAAyB;QACnC,KAAK,CAAC,gBAAgB,EAAE,+BAA+B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAC9E,OAAO,EAAE,EAAE,MAAM,EAAE;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAsB,MAAS,EAAE,MAAe;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CACnB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;KAC9C,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/core/amounts.d.ts

@@ -0,0 +1,35 @@
+import { ObbyxError } from './errors.js';
+/**
+ * Amounts are always integers in the asset's smallest units (invariant I5).
+ *
+ * - On the wire (x402 JSON) they are decimal strings.
+ * - Inside obbyx they are `bigint`.
+ * - They are converted to `number` only at the boundary with libraries that
+ *   require it (ocore, obyte.js, AA formulas), via {@link toSafeNumber}.
+ * - Prices are never computed with floating point.
+ */
+export type Amount = bigint;
+/** Largest amount accepted anywhere: every amount must round-trip through JS `number`. */
+export declare const MAX_AMOUNT: Amount;
+export declare class AmountError extends ObbyxError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/** Parses an atomic amount from its canonical decimal-string form ("0", "1500"). */
+export declare function parseAmount(input: string): Amount;
+/** Accepts a safe non-negative integer `number` (e.g. from ocore) and returns a bigint. */
+export declare function fromSafeNumber(input: number): Amount;
+/** Canonical wire form. */
+export declare function formatAmount(value: Amount): string;
+/** Converts for libraries that only accept `number`; throws instead of losing precision. */
+export declare function toSafeNumber(value: Amount): number;
+export declare function addAmounts(a: Amount, b: Amount): Amount;
+/** Subtraction that never goes below zero silently. */
+export declare function subAmounts(a: Amount, b: Amount): Amount;
+/**
+ * Converts a human-readable amount ("0.25") into atomic units.
+ * Rejects more fractional digits than the asset supports instead of rounding.
+ */
+export declare function fromDisplay(input: string, decimals: number): Amount;
+/** Converts atomic units into a human-readable string without floating point. */
+export declare function toDisplay(value: Amount, decimals: number): string;
+//# sourceMappingURL=amounts.d.ts.map

package/dist/core/amounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.d.ts","sourceRoot":"","sources":["../../src/core/amounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,MAAwC,CAAC;AAMlE,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG/D;AAeD,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBnE;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjE"}

package/dist/core/amounts.js

@@ -0,0 +1,94 @@
+import { ObbyxError } from './errors.js';
+/** Largest amount accepted anywhere: every amount must round-trip through JS `number`. */
+export const MAX_AMOUNT = BigInt(Number.MAX_SAFE_INTEGER);
+const AMOUNT_RE = /^(0|[1-9][0-9]*)$/;
+const DISPLAY_RE = /^(0|[1-9][0-9]*)(\.([0-9]+))?$/;
+const MAX_DECIMALS = 18;
+export class AmountError extends ObbyxError {
+    constructor(message, details) {
+        super('invalid_amount', message, details === undefined ? {} : { details });
+    }
+}
+function assertInRange(value, input) {
+    if (value < 0n || value > MAX_AMOUNT) {
+        throw new AmountError('Amount is out of range', { input: String(input) });
+    }
+    return value;
+}
+function assertDecimals(decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > MAX_DECIMALS) {
+        throw new AmountError('Invalid number of decimals', { decimals });
+    }
+}
+/** Parses an atomic amount from its canonical decimal-string form ("0", "1500"). */
+export function parseAmount(input) {
+    if (typeof input !== 'string' || !AMOUNT_RE.test(input)) {
+        throw new AmountError('Amount must be a non-negative integer string without leading zeros', {
+            input: String(input),
+        });
+    }
+    return assertInRange(BigInt(input), input);
+}
+/** Accepts a safe non-negative integer `number` (e.g. from ocore) and returns a bigint. */
+export function fromSafeNumber(input) {
+    if (!Number.isSafeInteger(input) || input < 0) {
+        throw new AmountError('Amount must be a non-negative safe integer', { input });
+    }
+    return BigInt(input);
+}
+/** Canonical wire form. */
+export function formatAmount(value) {
+    return assertInRange(value, value).toString();
+}
+/** Converts for libraries that only accept `number`; throws instead of losing precision. */
+export function toSafeNumber(value) {
+    return Number(assertInRange(value, value));
+}
+export function addAmounts(a, b) {
+    return assertInRange(a + b, `${a}+${b}`);
+}
+/** Subtraction that never goes below zero silently. */
+export function subAmounts(a, b) {
+    if (b > a) {
+        throw new AmountError('Amount subtraction would be negative', {
+            a: a.toString(),
+            b: b.toString(),
+        });
+    }
+    return a - b;
+}
+/**
+ * Converts a human-readable amount ("0.25") into atomic units.
+ * Rejects more fractional digits than the asset supports instead of rounding.
+ */
+export function fromDisplay(input, decimals) {
+    assertDecimals(decimals);
+    const match = typeof input === 'string' ? DISPLAY_RE.exec(input) : null;
+    if (!match) {
+        throw new AmountError('Display amount must look like "12" or "12.34"', {
+            input: String(input),
+        });
+    }
+    const whole = match[1] ?? '0';
+    const fraction = match[3] ?? '';
+    if (fraction.length > decimals) {
+        throw new AmountError('Display amount has more fractional digits than the asset allows', {
+            input,
+            decimals,
+        });
+    }
+    const atomic = BigInt(whole + fraction.padEnd(decimals, '0'));
+    return assertInRange(atomic, input);
+}
+/** Converts atomic units into a human-readable string without floating point. */
+export function toDisplay(value, decimals) {
+    assertDecimals(decimals);
+    const digits = formatAmount(value);
+    if (decimals === 0)
+        return digits;
+    const padded = digits.padStart(decimals + 1, '0');
+    const whole = padded.slice(0, -decimals);
+    const fraction = padded.slice(-decimals).replace(/0+$/, '');
+    return fraction.length > 0 ? `${whole}.${fraction}` : whole;
+}
+//# sourceMappingURL=amounts.js.map

package/dist/core/amounts.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Base error for all obbyx packages.
+ *
+ * `code` is a stable machine-readable identifier. Payment-related errors use
+ * x402 reason codes (e.g. `invalid_exact_obyte_payload_signature`) so they can
+ * be mapped 1:1 to `invalidReason` / `errorReason` in facilitator responses.
+ */
+export declare class ObbyxError extends Error {
+    readonly code: string;
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: string, message: string, options?: {
+        cause?: unknown;
+        details?: Record<string, unknown>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;gBAG9D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAO;CAOvE"}

package/dist/core/errors.js

@@ -0,0 +1,18 @@
+/**
+ * Base error for all obbyx packages.
+ *
+ * `code` is a stable machine-readable identifier. Payment-related errors use
+ * x402 reason codes (e.g. `invalid_exact_obyte_payload_signature`) so they can
+ * be mapped 1:1 to `invalidReason` / `errorReason` in facilitator responses.
+ */
+export class ObbyxError extends Error {
+    code;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = new.target.name;
+        this.code = code;
+        this.details = options.details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACb,OAAO,CAAgD;IAEhE,YACE,IAAY,EACZ,OAAe,EACf,UAAkE,EAAE;QAEpE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

package/dist/core/networks.d.ts

@@ -0,0 +1,34 @@
+import { ObbyxError } from './errors.js';
+/**
+ * Obyte networks and their identifiers.
+ *
+ * - x402 v2 uses CAIP-2 identifiers. No `obyte` namespace exists in
+ *   ChainAgnostic/namespaces yet, so `obyte:livenet` / `obyte:testnet` are
+ *   provisional until agreed upstream (see docs/adr/0004-network-identifiers.md).
+ * - x402 v1 uses plain strings, so each network also has a v1 name.
+ *
+ * Every storage, lock and dedup key must include the network (invariant I4);
+ * use {@link networkKey} to build such keys.
+ */
+export type ObyteNetworkName = 'livenet' | 'testnet';
+export type Caip2 = `${string}:${string}`;
+export interface ObyteNetwork {
+    readonly name: ObyteNetworkName;
+    readonly caip2: Caip2;
+    readonly v1Name: string;
+    readonly testnet: boolean;
+    readonly defaultHubUrl: string;
+    readonly explorerUrl: string;
+}
+export declare const OBYTE_CAIP_FAMILY: "obyte:*";
+export declare const OBYTE_NETWORKS: Readonly<Record<ObyteNetworkName, ObyteNetwork>>;
+export declare class UnsupportedNetworkError extends ObbyxError {
+    constructor(id: string);
+}
+/** Resolves a v2 CAIP-2 id or a v1 network name; throws for anything else. */
+export declare function getNetwork(id: string): ObyteNetwork;
+export declare function isObyteNetwork(id: string): boolean;
+/** Builds a key namespaced by network, e.g. `obyte:testnet:unit:<hash>`. */
+export declare function networkKey(network: ObyteNetwork, ...parts: readonly string[]): string;
+export declare function explorerUnitUrl(network: ObyteNetwork, unit: string): string;
+//# sourceMappingURL=networks.d.ts.map

package/dist/core/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../../src/core/networks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AACrD,MAAM,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,iBAAiB,EAAG,SAAkB,CAAC;AAEpD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAiB1E,CAAC;AASH,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,EAAE,EAAE,MAAM;CAGvB;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAInD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKrF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/core/networks.js

@@ -0,0 +1,50 @@
+import { ObbyxError } from './errors.js';
+export const OBYTE_CAIP_FAMILY = 'obyte:*';
+export const OBYTE_NETWORKS = Object.freeze({
+    livenet: Object.freeze({
+        name: 'livenet',
+        caip2: 'obyte:livenet',
+        v1Name: 'obyte-livenet',
+        testnet: false,
+        defaultHubUrl: 'wss://obyte.org/bb',
+        explorerUrl: 'https://explorer.obyte.org',
+    }),
+    testnet: Object.freeze({
+        name: 'testnet',
+        caip2: 'obyte:testnet',
+        v1Name: 'obyte-testnet',
+        testnet: true,
+        defaultHubUrl: 'wss://obyte.org/bb-test',
+        explorerUrl: 'https://testnetexplorer.obyte.org',
+    }),
+});
+const BY_ID = new Map(Object.values(OBYTE_NETWORKS).flatMap((n) => [
+    [n.caip2, n],
+    [n.v1Name, n],
+]));
+export class UnsupportedNetworkError extends ObbyxError {
+    constructor(id) {
+        super('invalid_network', `Unsupported Obyte network: ${id}`, { details: { network: id } });
+    }
+}
+/** Resolves a v2 CAIP-2 id or a v1 network name; throws for anything else. */
+export function getNetwork(id) {
+    const network = BY_ID.get(id);
+    if (!network)
+        throw new UnsupportedNetworkError(id);
+    return network;
+}
+export function isObyteNetwork(id) {
+    return BY_ID.has(id);
+}
+/** Builds a key namespaced by network, e.g. `obyte:testnet:unit:<hash>`. */
+export function networkKey(network, ...parts) {
+    if (parts.length === 0 || parts.some((p) => p.length === 0)) {
+        throw new ObbyxError('invalid_key', 'networkKey requires non-empty parts');
+    }
+    return [network.caip2, ...parts].join(':');
+}
+export function explorerUnitUrl(network, unit) {
+    return `${network.explorerUrl}/${encodeURIComponent(unit)}`;
+}
+//# sourceMappingURL=networks.js.map

package/dist/core/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../../src/core/networks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyBzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAqD,MAAM,CAAC,MAAM,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,oBAAoB;QACnC,WAAW,EAAE,4BAA4B;KAC1C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,yBAAyB;QACxC,WAAW,EAAE,mCAAmC;KACjD,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,KAAK,GAAsC,IAAI,GAAG,CACtD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;CACd,CAAC,CACH,CAAC;AAEF,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,EAAU;QACpB,KAAK,CAAC,iBAAiB,EAAE,8BAA8B,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,OAAqB,EAAE,GAAG,KAAwB;IAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,qCAAqC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAqB,EAAE,IAAY;IACjE,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/core/result.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Outcome of a check. Rejections carry a stable `reason` code (x402 style) and a
+ * human-readable message; they are expected outcomes, not exceptions.
+ */
+export type Verdict<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+    readonly message: string;
+};
+export declare function accept<T>(value: T): Verdict<T>;
+export declare function reject<T = never>(reason: string, message: string): Verdict<T>;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function hasOnlyKeys(obj: Record<string, unknown>, allowed: ReadonlySet<string>): boolean;
+//# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IACjB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE9C;AAED,wBAAgB,MAAM,CAAC,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAE/F"}

package/dist/core/result.js

@@ -0,0 +1,13 @@
+export function accept(value) {
+    return { ok: true, value };
+}
+export function reject(reason, message) {
+    return { ok: false, reason, message };
+}
+export function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function hasOnlyKeys(obj, allowed) {
+    return Object.keys(obj).every((k) => allowed.has(k));
+}
+//# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,MAAM,CAAI,KAAQ;IAChC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,MAAM,CAAY,MAAc,EAAE,OAAe;IAC/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAA4B,EAAE,OAA4B;IACpF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { ObbyxError } from './core/errors.js';
+export { type Verdict, accept, reject } from './core/result.js';
+export { type Amount, AmountError, MAX_AMOUNT, addAmounts, formatAmount, fromDisplay, fromSafeNumber, parseAmount, subAmounts, toDisplay, toSafeNumber, } from './core/amounts.js';
+export { type Caip2, type ObyteNetwork, type ObyteNetworkName, OBYTE_CAIP_FAMILY, OBYTE_NETWORKS, UnsupportedNetworkError, explorerUnitUrl, getNetwork, isObyteNetwork, networkKey, } from './core/networks.js';
+export { SIGNED_PACKAGE_VERSIONS, type SigDefinition, type SignedPackage, type VerifiedPackage, isSigDefinition, verifySignature, verifySignedPackage, } from './signing/signed-message.js';
+export { CHANNEL_BASE_AA, type ChannelDefinition, type ChannelParams, channelAddress, channelDefinition, isAddress, isAssetId, parseChannelDefinition, validateChannelParams, } from './channel/definition.js';
+export { DEFAULT_MAX_UNIT_BYTES, EXACT_REASONS, EXACT_UNIT_VERSIONS, type ExactExpectation, type ExactUnitFacts, type InputRef, compareOutputs, expectedCommissions, validateExactUnit, } from './unit/exact-unit.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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,KAAK,MAAM,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,cAAc,EACd,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { ObbyxError } from './core/errors.js';
+export { accept, reject } from './core/result.js';
+export { AmountError, MAX_AMOUNT, addAmounts, formatAmount, fromDisplay, fromSafeNumber, parseAmount, subAmounts, toDisplay, toSafeNumber, } from './core/amounts.js';
+export { OBYTE_CAIP_FAMILY, OBYTE_NETWORKS, UnsupportedNetworkError, explorerUnitUrl, getNetwork, isObyteNetwork, networkKey, } from './core/networks.js';
+export { SIGNED_PACKAGE_VERSIONS, isSigDefinition, verifySignature, verifySignedPackage, } from './signing/signed-message.js';
+export { CHANNEL_BASE_AA, channelAddress, channelDefinition, isAddress, isAssetId, parseChannelDefinition, validateChannelParams, } from './channel/definition.js';
+export { DEFAULT_MAX_UNIT_BYTES, EXACT_REASONS, EXACT_UNIT_VERSIONS, compareOutputs, expectedCommissions, validateExactUnit, } from './unit/exact-unit.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,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAgB,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAEL,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EAIvB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EAGf,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EAInB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}