@ickb/sdk 1000.0.43 → 1000.0.71

package/dist/cjs/sdk.js

@@ -0,0 +1,362 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IckbSdk = void 0;
+const core_1 = require("@ckb-ccc/core");
+const utils_1 = require("@ickb/utils");
+const core_2 = require("@ickb/core");
+const order_1 = require("@ickb/order");
+const constants_js_1 = require("./constants.js");
+const codec_js_1 = require("./codec.js");
+/**
+ * SDK for managing iCKB operations.
+ */
+class IckbSdk {
+    /**
+     * Creates an instance of IckbSdk.
+     *
+     * @param ownedOwner - The manager for owned owner operations.
+     * @param ickbLogic - The manager for iCKB logic operations.
+     * @param order - The manager for order operations.
+     * @param capacity - The capacity manager instance.
+     * @param bots - An array of bot lock scripts.
+     */
+    constructor(ownedOwner, ickbLogic, order, capacity, bots) {
+        this.ownedOwner = ownedOwner;
+        this.ickbLogic = ickbLogic;
+        this.order = order;
+        this.capacity = capacity;
+        this.bots = bots;
+    }
+    /**
+     * Creates an instance of IckbSdk from script dependencies.
+     *
+     * @param args - Parameters matching those of getConfig.
+     * @returns A new instance of IckbSdk.
+     */
+    static from(...args) {
+        const { managers: { ownedOwner, ickbLogic, order, capacity }, bots, } = (0, constants_js_1.getConfig)(...args);
+        return new IckbSdk(ownedOwner, ickbLogic, order, capacity, bots);
+    }
+    /**
+     * Previews the conversion between CKB and UDT.
+     *
+     * This method calculates a conversion preview using an exchange ratio midpoint.
+     * Optionally, a fee may be applied that influences the effective conversion rate,
+     * scaling the converted amount by (feeBase - fee) / feeBase.
+     *
+     * @param isCkb2Udt - Indicates the conversion direction:
+     *                    - true: Convert CKB to UDT.
+     *                    - false: Convert UDT to CKB.
+     * @param amounts - An object containing value components (amounts for CKB and UDT).
+     * @param system - The current system state containing exchange ratio, fee rate, tip, and order-related information.
+     * @param options - Optional parameters for fee and matching:
+     *    - fee: The fee to apply in integer terms (defaults to 1n for 0.001% fee).
+     *    - feeBase: The base used for fee scaling (defaults to 100000n).
+     *
+     * @returns An object with:
+     *   - convertedAmount: The estimated converted amount as a FixedPoint.
+     *   - ckbFee: The fee (or gain) in CKB, as a FixedPoint.
+     *   - info: Additional conversion metadata.
+     *   - maturity: Optional maturity information (as ccc.Num) if meets criteria.
+     */
+    static estimate(isCkb2Udt, amounts, system, options) {
+        // Apply a 0.001% default fee if none provided.
+        options = {
+            fee: 1n,
+            feeBase: 100000n,
+            ...options,
+        };
+        const { convertedAmount, ckbFee, info } = order_1.OrderManager.convert(isCkb2Udt, system.exchangeRatio, amounts, options);
+        // If the fee meets a threshold, calculate the order maturity; otherwise, maturity is undefined.
+        const maturity = ckbFee >= 10n * system.feeRate
+            ? IckbSdk.maturity({ info, amounts }, system)
+            : undefined;
+        return { convertedAmount, ckbFee, info, maturity };
+    }
+    /**
+     * Estimates the maturity for an order formatted as a Unix timestamp.
+     *
+     * Depending on the order type and amount remaining, the method calculates an estimated timestamp
+     * when the order (or part thereof) might be fulfilled.
+     *
+     * @param o - Either an OrderCell or an object containing order Info and value components.
+     * @param system - The current system state.
+     * @returns The Unix timestamp of estimated maturity as a bigint (in milliseconds) or undefined if not applicable.
+     */
+    static maturity(o, system) {
+        const info = "info" in o ? o.info : o.data.info;
+        const amounts = "amounts" in o
+            ? o.amounts
+            : { ckbValue: o.ckbUnoccupied, udtValue: o.udtValue };
+        // Dual-ratio orders have no fixed maturity.
+        if (info.isDualRatio()) {
+            return;
+        }
+        const isCkb2Udt = info.isCkb2Udt();
+        const amount = isCkb2Udt ? amounts.ckbValue : amounts.udtValue;
+        const ratio = isCkb2Udt ? info.ckbToUdt : info.udtToCkb;
+        // If order is already fulfilled.
+        if (amount === 0n) {
+            return 0n;
+        }
+        const { tip, exchangeRatio, orderPool, ckbAvailable, ckbMaturing } = system;
+        // Create a reference ratio instance for comparison.
+        const b = new order_1.Info(ratio, ratio, 1);
+        let ckb = isCkb2Udt ? amount : 0n;
+        let udt = isCkb2Udt ? 0n : amount;
+        for (const o of orderPool) {
+            const a = o.data.info;
+            if (a.isCkb2Udt()) {
+                // If not isCkb2Udt or a worse ratio, add available CKB.
+                if (!isCkb2Udt || a.ckb2UdtCompare(b) < 0) {
+                    ckb += o.ckbUnoccupied;
+                }
+            }
+            else {
+                // Conversely for UDT to CKB orders.
+                if (isCkb2Udt || a.udt2CkbCompare(b) < 0) {
+                    udt += o.udtValue;
+                }
+            }
+        }
+        // Adjust ckb by the converted UDT amount.
+        ckb -= (0, core_2.convert)(false, udt, exchangeRatio);
+        // Minimum maturity of 10 minutes (in milliseconds).
+        let maturity = 10n * 60n * 1000n;
+        if (isCkb2Udt) {
+            // For CKB to UDT orders, extend maturity based on the CKB amount.
+            if (ckb > 0n) {
+                maturity *= 1n + ckb / core_1.ccc.fixedPointFrom("200000");
+            }
+            return maturity + ("info" in o ? BigInt(Date.now()) : tip.timestamp);
+        }
+        // For UDT to CKB orders, add available CKB.
+        ckb += ckbAvailable;
+        if (ckb >= 0) {
+            return maturity + ("info" in o ? BigInt(Date.now()) : tip.timestamp);
+        }
+        // Find the earliest maturity in the ckbMaturing array that satisfies the required CKB.
+        const ckbNeeded = -ckb;
+        const i = (0, utils_1.binarySearch)(ckbMaturing.length, 
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        (n) => ckbMaturing[n].ckbCumulative >= ckbNeeded);
+        return ckbMaturing[i]?.maturity;
+    }
+    /**
+     * Mints a new order cell and appends it to the transaction.
+     *
+     * The method performs the following operations:
+     * - Creates order cell data using provided amounts and order information.
+     * - Adds required cell dependencies and UDT handlers to the transaction.
+     * - Appends the order cell to the transaction outputs.
+     *
+     * @param tx - The smart transaction to which the order cell is added.
+     * @param user - The user, represented either as a Signer or a Script.
+     * @param info - The order information meta data (usually computed via OrderManager.convert).
+     * @param amounts - The value components for the order, including:
+     *    - ckbValue: The CKB amount (may include an internal surplus).
+     *    - udtValue: The UDT amount.
+     *
+     * @returns A Promise resolving to void.
+     */
+    async request(tx, user, info, amounts) {
+        // If the user is provided as a Signer, extract the recommended lock script.
+        user =
+            "codeHash" in user
+                ? user
+                : (await user.getRecommendedAddressObj()).script;
+        this.order.mint(tx, user, info, amounts);
+    }
+    /**
+     * Melts (cancels) the specified order groups.
+     *
+     * For each order group, if the option is set to process fulfilled orders only,
+     * it filters accordingly. Then, for every valid group, the master and order cells are added
+     * as inputs to the transaction.
+     *
+     * @param tx - The smart transaction to which the inputs are added.
+     * @param groups - An array of order groups to be melted.
+     * @param options - Optional parameters:
+     *    - isFulfilledOnly: If true, only order groups with fully or partially fulfilled orders are processed.
+     *
+     * @returns void
+     */
+    collect(tx, groups, options) {
+        this.order.melt(tx, groups, options);
+    }
+    /**
+     * Retrieves the L1 state from the blockchain.
+     *
+     * The method performs the following:
+     * - Obtains the current block tip and calculates the exchange ratio.
+     * - Fetches available CKB and the maturing CKB based on bot capacities and deposit snapshots.
+     * - Filters orders into user-owned and system orders based on the provided locks.
+     * - Estimates user-owned orders maturity.
+     *
+     * @param client - The blockchain client interface.
+     * @param locks - An array of lock scripts used to filter user cells.
+     * @returns A promise that resolves to an object containing:
+     *   - system: The system state (fee rate, tip header, exchange ratio, order pool, etc.).
+     *   - user: The user's orders grouped as an array of OrderGroup.
+     */
+    async getL1State(client, locks) {
+        const tip = await client.getTipHeader();
+        const exchangeRatio = order_1.Ratio.from((0, core_2.ickbExchangeRatio)(tip));
+        // Parallel fetching of system components.
+        const [{ ckbAvailable, ckbMaturing }, orders, feeRate] = await Promise.all([
+            this.getCkb(client, tip),
+            (0, utils_1.collect)(this.order.findOrders(client)),
+            client.getFeeRate(),
+        ]);
+        const midInfo = new order_1.Info(exchangeRatio, exchangeRatio, 1);
+        const userOrders = [];
+        const systemOrders = [];
+        for (const group of orders) {
+            if (group.isOwner(...locks)) {
+                userOrders.push(group);
+            }
+            const { order } = group;
+            const info = order.data.info;
+            if ((order.isCkb2UdtMatchable() && info.ckb2UdtCompare(midInfo) < 0) ||
+                (order.isUdt2CkbMatchable() && info.udt2CkbCompare(midInfo) < 0)) {
+                systemOrders.push(order);
+            }
+        }
+        const system = {
+            feeRate,
+            tip,
+            exchangeRatio,
+            orderPool: systemOrders,
+            ckbAvailable,
+            ckbMaturing,
+        };
+        // Estimates user orders maturity.
+        for (const { order } of userOrders) {
+            order.maturity = IckbSdk.maturity(order, system);
+        }
+        return {
+            system,
+            user: {
+                orders: userOrders,
+            },
+        };
+    }
+    /**
+     * Retrieves available CKB and maturing CKB values from the blockchain.
+     *
+     * This method:
+     * - Fetches bot withdrawal requests and deposit snapshots.
+     * - Aggregates available CKB balances from bot capacities.
+     * - Calculates maturing CKB values (with their expected maturity timestamps)
+     *   based on deposit pool snapshots or via direct deposit cell lookups.
+     * - Sorts and cumulatively sums the maturing values for later lookup.
+     *
+     * @param client - The blockchain client used for fetching data.
+     * @param tip - The current block tip header.
+     * @returns A Promise that resolves with:
+     *   - ckbAvailable: The total available CKB (as a FixedPoint).
+     *   - ckbMaturing: An array of maturing CKB objects containing the cumulative CKB
+     *                  and the associated maturity timestamp.
+     */
+    async getCkb(client, tip) {
+        const opts = {
+            onChain: true,
+            tip,
+        };
+        // Start fetching bot iCKB withdrawal requests.
+        const promiseBotWithdrawals = (0, utils_1.collect)(this.ownedOwner.findWithdrawalGroups(client, this.bots, opts));
+        // Initialize deposit pool snapshot.
+        let poolSnapshotHex = "0x";
+        let poolSnapshotEpoch = utils_1.Epoch.from([0n, 0n, 1n]);
+        // Map to track each bot's available CKB (minus a reserved amount for internal operations).
+        const bot2Ckb = new Map();
+        const reserved = -core_1.ccc.fixedPointFrom("2000");
+        for await (const c of this.capacity.findCapacities(client, this.bots, opts)) {
+            const key = (0, utils_1.hexFrom)(c.cell.cellOutput.lock);
+            const ckb = (bot2Ckb.get(key) ?? reserved) + c.ckbValue;
+            bot2Ckb.set(key, ckb);
+            // Find the most recent deposit pool snapshot from bot cell output data.
+            const outputData = c.cell.outputData;
+            if (outputData.length % 256 === 2) {
+                const h = await (0, utils_1.getHeader)(client, {
+                    type: "txHash",
+                    value: c.cell.outPoint.txHash,
+                });
+                const e = utils_1.Epoch.from(h.epoch);
+                if (poolSnapshotEpoch.compare(e) < 0) {
+                    poolSnapshotHex = outputData;
+                    poolSnapshotEpoch = e;
+                }
+            }
+        }
+        const ckbMaturing = new Array();
+        for (const wr of await promiseBotWithdrawals) {
+            if (wr.owned.isReady) {
+                // Update the bot's CKB based on withdrawal if the bot is ready.
+                const key = (0, utils_1.hexFrom)(wr.owner.cell.cellOutput.lock);
+                const ckb = (bot2Ckb.get(key) ?? reserved) + wr.ckbValue;
+                bot2Ckb.set(key, ckb);
+                continue;
+            }
+            // Otherwise, add to maturing amounts.
+            ckbMaturing.push({
+                ckbValue: wr.ckbValue,
+                maturity: wr.owned.maturity.toUnix(tip),
+            });
+        }
+        // Sum available CKB across all bot lock scripts.
+        let ckbAvailable = 0n;
+        for (const ckb of bot2Ckb.values()) {
+            if (ckb > 0n) {
+                ckbAvailable += ckb;
+            }
+        }
+        // Estimate available CKB from deposit pool snapshot.
+        const tipEpoch = utils_1.Epoch.from(tip.epoch);
+        const oneCycle = utils_1.Epoch.from([180n, 0n, 1n]);
+        if (poolSnapshotHex !== "0x") {
+            const eNumber = tip.epoch[0];
+            let start = utils_1.Epoch.from([eNumber - (eNumber % 180n), 0n, 1n]);
+            const step = utils_1.Epoch.from([0n, 180n, 1024n]);
+            const depositSize = (0, core_2.convert)(false, core_2.ICKB_DEPOSIT_CAP, tip);
+            for (const binAmount of codec_js_1.PoolSnapshot.decode(poolSnapshotHex)) {
+                const end = start.add(step);
+                if (binAmount > 0) {
+                    ckbMaturing.push({
+                        ckbValue: BigInt(binAmount) * depositSize,
+                        maturity: tipEpoch.compare(tipEpoch) < 0
+                            ? // If the bin has already started, assume worst-case timing.
+                                end.add(oneCycle).toUnix(tip)
+                            : // Otherwise, use the bin end as the maturity.
+                                end.toUnix(tip),
+                    });
+                }
+                start = end;
+            }
+        }
+        else {
+            // Without snapshot data, fetch deposits directly.
+            for await (const d of this.ickbLogic.findDeposits(client, opts)) {
+                ckbMaturing.push({
+                    ckbValue: d.ckbValue,
+                    maturity: d.maturity.toUnix(tip),
+                });
+            }
+        }
+        // Sort maturing CKB entries by their maturity timestamp.
+        ckbMaturing.sort((a, b) => Number(a.maturity - b.maturity));
+        // Calculate cumulative maturing CKB values.
+        let cumulative = 0n;
+        const ckbCumulativeMaturing = [];
+        for (const { ckbValue, maturity } of ckbMaturing) {
+            cumulative += ckbValue;
+            ckbCumulativeMaturing.push({ ckbCumulative: cumulative, maturity });
+        }
+        return {
+            ckbAvailable,
+            ckbMaturing: ckbCumulativeMaturing,
+        };
+    }
+}
+exports.IckbSdk = IckbSdk;
+//# sourceMappingURL=sdk.js.map

package/dist/cjs/sdk.js.map

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

package/dist/esm/codec.d.ts

@@ -0,0 +1,14 @@
+import { mol } from "@ckb-ccc/core";
+/**
+ * Codec for encoding and decoding a pool snapshot.
+ *
+ * The PoolSnapshotCodec encodes an array of 1024 numbers representing event counts for bins,
+ * where the number of bits used per bin is dynamically computed as the ceiling of log2(max + 1)
+ * across all bins. The codec provides methods to encode the array into a Uint8Array and decode
+ * a Uint8Array back to the original array of numbers.
+ *
+ * @remarks The total number of bits for encoding all the bins is computed as bitsPerBin * 1024. The codec
+ * does not have a fixed byteLength since it depends on the data.
+ */
+export declare const PoolSnapshot: mol.Codec<number[], number[]>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/esm/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,GAAG,EAAE,MAAM,eAAe,CAAC;AAKzC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,+BAkDvB,CAAC"}

package/dist/esm/codec.js

@@ -0,0 +1,122 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { max } from "@ickb/utils";
+const N = 1024;
+/**
+ * Codec for encoding and decoding a pool snapshot.
+ *
+ * The PoolSnapshotCodec encodes an array of 1024 numbers representing event counts for bins,
+ * where the number of bits used per bin is dynamically computed as the ceiling of log2(max + 1)
+ * across all bins. The codec provides methods to encode the array into a Uint8Array and decode
+ * a Uint8Array back to the original array of numbers.
+ *
+ * @remarks The total number of bits for encoding all the bins is computed as bitsPerBin * 1024. The codec
+ * does not have a fixed byteLength since it depends on the data.
+ */
+export const PoolSnapshot = mol.Codec.from({
+    /**
+     * Encodes an array of 1024 bin counts into a Uint8Array.
+     *
+     * @param bins - An array of 1024 numbers. Each number represents the event count for a bin.
+     * @returns A Uint8Array containing the packed bit representation of the bin counts.
+     * @throws Error if the input array does not contain exactly 1024 elements.
+     */
+    encode: (bins) => {
+        if (bins.length !== N) {
+            throw new Error("Expected 1024 bins");
+        }
+        const bitsPerBin = computeBits(bins);
+        const buffer = new Uint8Array((bitsPerBin * N) >> 3);
+        let bitOffset = 0;
+        for (const count of bins) {
+            packBits(buffer, bitOffset, bitsPerBin, count);
+            bitOffset += bitsPerBin;
+        }
+        return buffer;
+    },
+    /**
+     * Decodes a buffer into an array of 1024 bin counts.
+     *
+     * The function automatically computes the number of bits per bin from the buffer length,
+     * expecting that the total number of bits in the buffer is a multiple of 1024.
+     *
+     * @param bufferLike - The input that can be converted into a Uint8Array.
+     * @returns An array of 1024 numbers representing the decoded bin counts.
+     * @throws Error if the buffer length is invalid (i.e., its total bit count is not divisible by 1024).
+     */
+    decode: (bufferLike) => {
+        const buffer = ccc.bytesFrom(bufferLike);
+        // Determine bitsPerBin from the fixed structure (totalBits divided by N).
+        const bitsPerBin = (buffer.byteLength * 8) / N;
+        if (!Number.isInteger(bitsPerBin)) {
+            throw new Error("Invalid buffer length for 1024 bins");
+        }
+        const bins = new Array(N);
+        let bitOffset = 0;
+        for (let i = 0; i < N; i++) {
+            bins[i] = unpackBits(buffer, bitOffset, bitsPerBin);
+            bitOffset += bitsPerBin;
+        }
+        return bins;
+    },
+    // Note: The byteLength is not fixed as it depends on the data (i.e., the maximum bin count).
+});
+/**
+ * Computes the minimal number of bits required to represent the maximum number in the bins.
+ *
+ * Given an array of numbers that represent counts for each bin, this function calculates
+ * the number of bits required to represent the maximum bin count. A minimum of 1 bit is
+ * always returned.
+ *
+ * @param bins - An array of numbers, each representing a bin's value.
+ * @returns The minimal number of bits required to represent the highest value among the bins.
+ */
+function computeBits(bins) {
+    return Math.ceil(Math.log2(1 + max(1, ...bins)));
+}
+/**
+ * Packs a given numeric value into a Uint8Array (bit array) at the specified bit offset and width.
+ *
+ * The function encodes the given number into the provided buffer, using the specified number of bits (width)
+ * starting from the specified bit offset. Each bit of the value is written into the buffer.
+ *
+ * @param buffer - The Uint8Array into which the value will be packed.
+ * @param bitOffset - The starting bit index in the array where the value should be packed.
+ * @param width - The number of bits to use for packing the value.
+ * @param value - The numeric value to pack.
+ */
+function packBits(buffer, bitOffset, width, value) {
+    let offset = bitOffset;
+    for (let i = 0; i < width; i++) {
+        const byteIndex = offset >> 3;
+        const bitInByte = offset % 8;
+        const bit = (value >> i) & 1;
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        buffer[byteIndex] |= bit << bitInByte;
+        offset++;
+    }
+}
+/**
+ * Unpacks a numeric value from a Uint8Array (bit array) starting at a given bit offset with a specified width.
+ *
+ * The function reads bits from the buffer starting at the bit offset and reconstructs a numeric value
+ * using the specified number of bits (width).
+ *
+ * @param buffer - The Uint8Array from which the value will be unpacked.
+ * @param bitOffset - The starting bit index in the buffer.
+ * @param width - The number of bits to read for unpacking the value.
+ * @returns The numeric value resulting from decoding the specified bits.
+ */
+function unpackBits(buffer, bitOffset, width) {
+    let value = 0;
+    let offset = bitOffset;
+    for (let i = 0; i < width; i++) {
+        const byteIndex = offset >> 3;
+        const bitInByte = offset % 8;
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const bit = (buffer[byteIndex] >> bitInByte) & 1;
+        value |= bit << i;
+        offset++;
+    }
+    return value;
+}
+//# sourceMappingURL=codec.js.map

package/dist/esm/codec.js.map

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

package/dist/esm/constants.d.ts

@@ -0,0 +1,49 @@
+import { ccc } from "@ckb-ccc/core";
+import { IckbUdtManager, LogicManager, OwnedOwnerManager } from "@ickb/core";
+import { DaoManager } from "@ickb/dao";
+import { OrderManager } from "@ickb/order";
+import { CapacityManager, type ScriptDeps } from "@ickb/utils";
+/**
+ * The iCKB UDT name.
+ */
+export declare const UDT_NAME = "iCKB";
+/**
+ * The iCKB UDT symbol.
+ */
+export declare const UDT_SYMBOL = "iCKB";
+/**
+ * The iCKB UDT number of decimals.
+ */
+export declare const UDT_DECIMALS = 8;
+/**
+ * Retrieves the configuration for the given deployment environment.
+ *
+ * Accepts either a string identifier ("mainnet" or "testnet") or a custom configuration
+ * object containing script dependencies for a devnet.
+ *
+ * It sets up various managers (UDT, Logic, OwnedOwner, Order, Dao, Capacity) and also
+ * aggregates a unique list of known bot scripts.
+ *
+ * @param deps - Either a network identifier ("mainnet"/"testnet") or an object containing
+ *   explicit script dependencies for devnet.
+ * @param bots - An optional array of bot script-like objects to augment the list of known bots.
+ * @returns An object containing the instantiated managers and bots.
+ */
+export declare function getConfig(deps: "mainnet" | "testnet" | {
+    udt: ScriptDeps;
+    ickbLogic: ScriptDeps;
+    ownedOwner: ScriptDeps;
+    order: ScriptDeps;
+    dao: ScriptDeps;
+}, bots?: ccc.ScriptLike[]): {
+    managers: {
+        udt: IckbUdtManager;
+        ickbLogic: LogicManager;
+        ownedOwner: OwnedOwnerManager;
+        order: OrderManager;
+        dao: DaoManager;
+        capacity: CapacityManager;
+    };
+    bots: ccc.Script[];
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAU,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,QAAQ,SAAS,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,IAAI,EACA,SAAS,GACT,SAAS,GACT;IAEE,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;CACjB,EACL,IAAI,GAAE,GAAG,CAAC,UAAU,EAAO,GAC1B;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,cAAc,CAAC;QACpB,SAAS,EAAE,YAAY,CAAC;QACxB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,KAAK,EAAE,YAAY,CAAC;QACpB,GAAG,EAAE,UAAU,CAAC;QAChB,QAAQ,EAAE,eAAe,CAAC;KAC3B,CAAC;IACF,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;CACpB,CA6BA"}