xrpjson 0.1.0

package/dist/fp/factories/offer-create.js

@@ -0,0 +1,230 @@
+import { isAccount, isAmount, isFlagEnabled, isHex, isIssuedCurrencyAmount, isMPTAmount, isNumber, isRecord, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// OfferCreate flag bits (per xrpl-dev-portal offercreate.md and
+// xrpl.js OfferCreateFlags enum).
+const TF_PASSIVE = 0x00010000;
+const TF_IMMEDIATE_OR_CANCEL = 0x00020000;
+const TF_FILL_OR_KILL = 0x00040000;
+const TF_SELL = 0x00080000;
+const TF_HYBRID = 0x00100000;
+// UInt32 bounds (per xrpl-dev-portal offercreate.md Fields table).
+const UINT32_MIN = 0;
+const UINT32_MAX = 0xffffffff;
+// Currency code shapes (per xrpl.org generic Amount spec).
+const CURRENCY_ASCII_LENGTH = 3;
+const CURRENCY_HEX_LENGTH = 40;
+// MPT issuance IDs are 192-bit, hex-encoded (≤ 48 chars). We accept
+// 24–48 to leave slack for future widenings / leading-zero encoders.
+// (XLS-0033; matches the policy used by ammCreate and vaultClawback.)
+const MPT_ISSUANCE_ID_MIN = 24;
+const MPT_ISSUANCE_ID_MAX = 48;
+// DomainID is a 64-char hex (UInt256).
+const DOMAIN_ID_LENGTH = 64;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * XRPLNumber: a non-negative base-10 integer string. Matches the policy
+ * used across other factories (loanSet, ammCreate, vaultCreate,
+ * vaultClawback).
+ */
+function isXrplNumber(value) {
+    return isString(value) && /^[0-9]+$/u.test(value);
+}
+/**
+ * True iff the given Amount is a positive amount (currency string for
+ * XRP, IssuedCurrencyAmount, or MPTAmount).
+ */
+function isPositiveAmount(amount, path) {
+    if (!isAmount(amount)) {
+        throw new ValidationError(`OfferCreate: ${path} must be a valid Amount (XRP string, IOU, or MPT form)`);
+    }
+    // XRP path: positive base-10 integer string.
+    if (isString(amount)) {
+        if (!isXrplNumber(amount)) {
+            throw new ValidationError(`OfferCreate: ${path} (XRP) must be a non-negative base-10 integer string`);
+        }
+        if (amount === '0') {
+            throw new ValidationError(`OfferCreate: ${path} must be a positive amount (got "0")`);
+        }
+        return;
+    }
+    // IOU path.
+    if (isIssuedCurrencyAmount(amount)) {
+        const ccy = amount.currency;
+        if (ccy.length !== CURRENCY_ASCII_LENGTH &&
+            ccy.length !== CURRENCY_HEX_LENGTH) {
+            throw new ValidationError(`OfferCreate: ${path}.currency must be ${CURRENCY_ASCII_LENGTH} ASCII characters or ${CURRENCY_HEX_LENGTH} hex characters (actual: ${ccy.length})`);
+        }
+        if (ccy.length === CURRENCY_HEX_LENGTH && !isHex(ccy)) {
+            throw new ValidationError(`OfferCreate: ${path}.currency (40-char form) must be hex`);
+        }
+        if (!isAccount(amount.issuer)) {
+            throw new ValidationError(`OfferCreate: ${path}.issuer must be a valid XRPL account address`);
+        }
+        if (!isXrplNumber(amount.value)) {
+            throw new ValidationError(`OfferCreate: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        if (amount.value === '0') {
+            throw new ValidationError(`OfferCreate: ${path} must be a positive amount (got "0")`);
+        }
+        return;
+    }
+    // MPT path.
+    if (isMPTAmount(amount)) {
+        const mptid = amount.mpt_issuance_id;
+        if (mptid.length < MPT_ISSUANCE_ID_MIN ||
+            mptid.length > MPT_ISSUANCE_ID_MAX ||
+            !isHex(mptid)) {
+            throw new ValidationError(`OfferCreate: ${path}.mpt_issuance_id must be a ${MPT_ISSUANCE_ID_MIN}-${MPT_ISSUANCE_ID_MAX} character hex string`);
+        }
+        if (!isXrplNumber(amount.value)) {
+            throw new ValidationError(`OfferCreate: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        if (amount.value === '0') {
+            throw new ValidationError(`OfferCreate: ${path} must be a positive amount (got "0")`);
+        }
+        return;
+    }
+    // Unreachable — defensive.
+    throw new ValidationError(`OfferCreate: ${path} must be a valid Amount (XRP string, IOU, or MPT form)`);
+}
+/**
+ * True if the two amounts trade the same currency. Used to reject
+ * XRP-for-XRP and same-IOU-for-same-IOU offers.
+ */
+function isSameCurrency(a, b) {
+    // XRP-for-XRP.
+    if (isString(a) && isString(b))
+        return true;
+    // IOU-for-IOU with matching currency and issuer.
+    if (isIssuedCurrencyAmount(a) && isIssuedCurrencyAmount(b)) {
+        return a.currency === b.currency && a.issuer === b.issuer;
+    }
+    // MPT-for-MPT with matching mpt_issuance_id.
+    if (isMPTAmount(a) && isMPTAmount(b)) {
+        return a.mpt_issuance_id === b.mpt_issuance_id;
+    }
+    // Mixed forms (XRP/IOU/MPT) are different currencies.
+    return false;
+}
+/**
+ * Decode the bit-set for a numeric Flags value, returning the names of
+ * each known tfHybrid / tfFillOrKill / tfImmediateOrCancel / tfPassive /
+ * tfSell bit. Unknown bits are ignored — rippled will reject them, but
+ * we don't second-guess the flag schema here.
+ */
+function decodeOfferCreateFlags(flags) {
+    return {
+        hybrid: isFlagEnabled(flags, TF_HYBRID),
+        fillOrKill: isFlagEnabled(flags, TF_FILL_OR_KILL),
+        immediateOrCancel: isFlagEnabled(flags, TF_IMMEDIATE_OR_CANCEL),
+        passive: isFlagEnabled(flags, TF_PASSIVE),
+        sell: isFlagEnabled(flags, TF_SELL),
+    };
+}
+/**
+ * Decode the bit-set for a FlagsInterface object. Returns the same
+ * shape as `decodeOfferCreateFlags` for uniform downstream checks.
+ */
+function decodeOfferCreateFlagsInterface(flags) {
+    return {
+        hybrid: flags.tfHybrid === true,
+        fillOrKill: flags.tfFillOrKill === true,
+        immediateOrCancel: flags.tfImmediateOrCancel === true,
+        passive: flags.tfPassive === true,
+        sell: flags.tfSell === true,
+    };
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function offerCreate(props) {
+    // ── Account ── required, must be a valid XRPL classic / X-address.
+    require(props.Account, 'OfferCreate: Account is required', isAccount);
+    // ── TakerGets / TakerPays ── required, must be a strictly positive Amount.
+    isPositiveAmount(props.TakerGets, 'TakerGets');
+    isPositiveAmount(props.TakerPays, 'TakerPays');
+    // ── Cross-field: must not trade the same currency for itself.
+    // (xrpl-dev-portal offercreate.md Error Cases: temBAD_OFFER
+    // "The offer tries to trade XRP for XRP" + temREDUNDANT
+    // "The transaction would trade a token for the same token".)
+    if (isSameCurrency(props.TakerGets, props.TakerPays)) {
+        throw new ValidationError('OfferCreate: TakerGets and TakerPays must not be the same currency');
+    }
+    // ── Expiration ── optional UInt32.
+    if (props.Expiration !== undefined) {
+        if (!isNumber(props.Expiration) ||
+            !Number.isInteger(props.Expiration) ||
+            props.Expiration < UINT32_MIN ||
+            props.Expiration > UINT32_MAX) {
+            throw new ValidationError(`OfferCreate: Expiration must be a UInt32 in [${UINT32_MIN}, ${UINT32_MAX}] (seconds since the Ripple Epoch)`);
+        }
+    }
+    // ── OfferSequence ── optional UInt32, must be ≤ Sequence.
+    if (props.OfferSequence !== undefined) {
+        if (!isNumber(props.OfferSequence) ||
+            !Number.isInteger(props.OfferSequence) ||
+            props.OfferSequence < UINT32_MIN ||
+            props.OfferSequence > UINT32_MAX) {
+            throw new ValidationError(`OfferCreate: OfferSequence must be a UInt32 in [${UINT32_MIN}, ${UINT32_MAX}]`);
+        }
+        if (props.Sequence !== undefined &&
+            isNumber(props.Sequence) &&
+            props.OfferSequence > props.Sequence) {
+            throw new ValidationError('OfferCreate: OfferSequence must not be greater than the transaction Sequence');
+        }
+    }
+    // ── DomainID ── optional 64-char hex.
+    if (props.DomainID !== undefined) {
+        if (!isString(props.DomainID) ||
+            !isHex(props.DomainID) ||
+            props.DomainID.length !== DOMAIN_ID_LENGTH) {
+            throw new ValidationError(`OfferCreate: DomainID must be a ${DOMAIN_ID_LENGTH}-character hex string`);
+        }
+    }
+    // ── Flags ── decode, then enforce spec invariants.
+    let decoded = null;
+    if (props.Flags !== undefined) {
+        if (typeof props.Flags === 'number') {
+            if (!Number.isInteger(props.Flags) || props.Flags < 0) {
+                throw new ValidationError('OfferCreate: Flags must be a non-negative integer');
+            }
+            decoded = decodeOfferCreateFlags(props.Flags);
+        }
+        else if (isRecord(props.Flags)) {
+            decoded = decodeOfferCreateFlagsInterface(props.Flags);
+        }
+        else {
+            throw new ValidationError('OfferCreate: Flags must be a number or OfferCreateFlagsInterface object');
+        }
+    }
+    if (decoded !== null) {
+        // tfImmediateOrCancel and tfFillOrKill are mutually exclusive.
+        if (decoded.immediateOrCancel && decoded.fillOrKill) {
+            throw new ValidationError('OfferCreate: tfImmediateOrCancel and tfFillOrKill cannot both be set');
+        }
+        // tfHybrid requires DomainID.
+        if (decoded.hybrid && props.DomainID === undefined) {
+            throw new ValidationError('OfferCreate: tfHybrid requires DomainID');
+        }
+    }
+    return buildFrozenTx('OfferCreate', props, {
+        validate() {
+            // Validated at construction.
+        },
+        toJSON() {
+            const json = {};
+            for (const k of Object.keys(this)) {
+                if (k === 'validate' || k === 'toJSON' || k === 'with')
+                    continue;
+                const v = this[k];
+                if (v !== undefined)
+                    json[k] = v;
+            }
+            return json;
+        },
+        with(overrides) {
+            return offerCreate(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=offer-create.js.map

package/dist/fp/factories/offer-create.js.map

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

package/dist/fp/factories/oracle-delete.d.ts

@@ -0,0 +1,21 @@
+export interface OracleDeleteProps {
+    /** The owner of the PriceOracle (must equal `PriceOracle.Owner`). */
+    Account: string;
+    /**
+     * The unique identifier of the price oracle for `Account`.
+     * UInt32 — integer in [0, 0xFFFFFFFF].
+     */
+    OracleDocumentID: number;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface OracleDelete extends Readonly<OracleDeleteProps> {
+    readonly TransactionType: 'OracleDelete';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<OracleDeleteProps>): OracleDelete;
+}
+export declare function oracleDelete(props: OracleDeleteProps): OracleDelete;
+//# sourceMappingURL=oracle-delete.d.ts.map

package/dist/fp/factories/oracle-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-delete.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/oracle-delete.ts"],"names":[],"mappings":"AA0EA,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IAC/D,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;IACzC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC;CAC3D;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA4CnE"}

package/dist/fp/factories/oracle-delete.js

@@ -0,0 +1,101 @@
+/**
+ * Functional OracleDelete factory — frozen-object style.
+ *
+ * Deletes a `PriceOracle` ledger entry. Only the owner of the oracle can
+ * send this transaction. Validation happens at construction; there is no
+ * way to construct an invalid tx.
+ *
+ *   import { oracleDelete } from 'xrplt/fp';
+ *   const tx = oracleDelete({ Account, OracleDocumentID: 34 });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Fee: '15' });
+ *
+ * Affected amendments:
+ *   - `PriceOracle` — base OracleDelete.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/oracledelete
+ * @see XLS-0047 (Price Oracles) §"Transaction for deleting Oracle instance"
+ *      in `~/.mavis/docs.local/xrpl-standards/repo/XLS-0047-PriceOracles/README.md`
+ *      (lines 191–223).
+ *
+ * ## Divergences
+ *
+ * The class-based API at `src/transactions/oracle-delete.ts` and xrpl.js's
+ * `validateOracleDelete` both skip two rules that the canonical sources
+ * require. The factory fills them:
+ *
+ *   1. `OracleDocumentID` must be an unsigned 32-bit integer.
+ *      The class and xrpl.js only check `typeof === 'number'` (the class
+ *      uses the local `isNumber`, xrpl.js's `isNumber` is identical).
+ *      That allows NaN, ±Infinity, fractional values, negative numbers,
+ *      and values > 2^32 − 1 to pass. XLS-0047 and the on-ledger codec
+ *      both require `UINT32` (an integer in [0, 0xFFFFFFFF]).
+ *      The factory rejects anything that fails that range/integer check.
+ *      Source: XLS-0047 §"Transaction for deleting Oracle instance"
+ *              (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0047-PriceOracles/README.md`)
+ *              line 209 (`UINT32` Internal Type for `OracleDocumentID`).
+ *      Source: xrpl.js `validateOracleDelete`
+ *              (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/oracleDelete.ts`)
+ *              lines 28–32 — `validateRequiredField(tx, 'OracleDocumentID', isNumber)`
+ *              with `isNumber = (n) => typeof n === 'number'` (common.ts
+ *              line 209). No integer/range check.
+ *      Source: ripple-binary-codec `definitions.json`
+ *              (`~/.mavis/docs.local/xrpl.js/repo/packages/ripple-binary-codec/src/enums/definitions.json`)
+ *              line 4722 (OracleDelete field declaration) — `OracleDocumentID`
+ *              is a `UInt32` STInteger.
+ *
+ *   2. `Account` must be a valid XRPL classic or X-address.
+ *      The class does not validate `Account` at all (it relies on the
+ *      base `Transaction.validate()`). The factory validates it via
+ *      `isAccount`, consistent with every other fp factory. The on-ledger
+ *      `temINVALID_ACCOUNT` check would otherwise only fire at submit
+ *      time.
+ *      Source: XLS-0047 §"Transaction for deleting Oracle instance"
+ *              (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0047-PriceOracles/README.md`)
+ *              line 208 (`ACCOUNTID` Internal Type for `Account`) and
+ *              line 220 ("The `Account` account doesn't exist").
+ *      Source: xrpl.org `oracledelete.md`
+ *              (`~/.mavis/docs.local/xrpl-dev-portal/repo/docs/references/protocol/transactions/types/oracledelete.md`)
+ *              line 13 ("Only the owner of the price oracle can send
+ *              this transaction") — implying the Account must be a
+ *              valid XRPL account.
+ */
+import { isAccount, isNumber } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// OracleDocumentID is a UInt32 per XLS-0047 §"Transaction for deleting
+// Oracle instance" (line 209: `UINT32` Internal Type).
+const MAX_UINT32 = 0xffffffff;
+// ─── Factory ─────────────────────────────────────────────────────────
+export function oracleDelete(props) {
+    // ── Account ── required, must be a valid XRPL classic or X-address.
+    require(props.Account, 'OracleDelete: Account is required', isAccount);
+    // ── OracleDocumentID ── required, UInt32 (integer in [0, 0xFFFFFFFF]).
+    if (!isNumber(props.OracleDocumentID) ||
+        !Number.isInteger(props.OracleDocumentID) ||
+        props.OracleDocumentID < 0 ||
+        props.OracleDocumentID > MAX_UINT32) {
+        throw new ValidationError(`OracleDelete: OracleDocumentID must be an integer in [0, ${MAX_UINT32}] (UInt32)`);
+    }
+    return buildFrozenTx('OracleDelete', props, {
+        validate() {
+            // Validated at construction.
+        },
+        toJSON() {
+            const json = {};
+            for (const k of Object.keys(this)) {
+                if (k === 'validate' || k === 'toJSON' || k === 'with')
+                    continue;
+                const v = this[k];
+                if (v !== undefined)
+                    json[k] = v;
+            }
+            return json;
+        },
+        with(overrides) {
+            return oracleDelete(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=oracle-delete.js.map

package/dist/fp/factories/oracle-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-delete.js","sourceRoot":"","sources":["../../../src/fp/factories/oracle-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnE,wEAAwE;AAExE,uEAAuE;AACvE,uDAAuD;AACvD,MAAM,UAAU,GAAG,UAAU,CAAC;AAyB9B,wEAAwE;AAExE,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,qEAAqE;IACrE,OAAO,CACL,KAAK,CAAC,OAAO,EACb,mCAAmC,EACnC,SAAS,CACV,CAAC;IAEF,wEAAwE;IACxE,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACjC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACzC,KAAK,CAAC,gBAAgB,GAAG,CAAC;QAC1B,KAAK,CAAC,gBAAgB,GAAG,UAAU,EACnC,CAAC;QACD,MAAM,IAAI,eAAe,CACvB,4DAA4D,UAAU,YAAY,CACnF,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAClB,cAAc,EACd,KAAK,EACL;QACE,QAAQ;YACN,6BAA6B;QAC/B,CAAC;QACD,MAAM;YACJ,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,MAAM;oBAAE,SAAS;gBACjE,MAAM,CAAC,GAAI,IAA2C,CAAC,CAAC,CAAC,CAAC;gBAC1D,IAAI,CAAC,KAAK,SAAS;oBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAEF,SAAqC;YAErC,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACrD,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/fp/factories/oracle-set.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A single `PriceDataSeries` element. Per XLS-47 / xrpl.js 5.3.0,
+ * each element wraps the inner object under a `PriceData` key.
+ */
+export interface PriceData {
+    readonly PriceData: {
+        readonly BaseAsset: string;
+        readonly QuoteAsset: string;
+        readonly AssetPrice?: string | number;
+        readonly Scale?: number;
+    };
+}
+export interface OracleSetProps {
+    /** The XRPL account with create/update/delete privileges on the oracle. */
+    Account: string;
+    /** Unique identifier of the price oracle for the Account. UINT32. */
+    OracleDocumentID: number;
+    /** Unix time (seconds) when the data was last updated. UINT32. */
+    LastUpdateTime: number;
+    /** Up to 10 PriceData objects, each describing a token-pair quote. */
+    PriceDataSeries: PriceData[];
+    /** Oracle Provider identifier, hex-encoded ASCII (0x20-0x7E), ≤256 bytes. */
+    Provider?: string | undefined;
+    /** Off-chain URI reference, hex-encoded, ≤256 bytes. */
+    URI?: string | undefined;
+    /** Asset type, hex-encoded ASCII (0x20-0x7E), ≤16 bytes. */
+    AssetClass?: string | undefined;
+    /** Bit-flags for this transaction. OracleSet has no defined flags. */
+    Flags?: number | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface OracleSet extends Readonly<OracleSetProps> {
+    readonly TransactionType: 'OracleSet';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<OracleSetProps>): OracleSet;
+}
+export declare function oracleSet(props: OracleSetProps): OracleSet;
+//# sourceMappingURL=oracle-set.d.ts.map

package/dist/fp/factories/oracle-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-set.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/oracle-set.ts"],"names":[],"mappings":"AA0HA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ,CAAC,cAAc,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC;IACtC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAwHD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAuF1D"}