warthog-ts 0.1.21

package/dist/src/types/Funds.js

@@ -0,0 +1,329 @@
+export const MAX_U64 = 0xffffffffffffffffn;
+/**
+ * Represents token's number of decimal place).
+ * Valid range: 0-18. WART uses 8 decimal places.
+ */
+export class TokenDecimals {
+    /**
+     * Create a TokenDecimals instance.
+     * @param decimals - Number of decimal places (0-18)
+     * @throws Error if decimals is out of range
+     */
+    constructor(decimals) {
+        this.decimals = decimals;
+        if (decimals < 0 || decimals > 18) {
+            throw new Error("Invalid decimals");
+        }
+    }
+}
+/** Pre-configured WART decimals (8 decimals) */
+TokenDecimals.WART = new TokenDecimals(8);
+/** Pre-configured Liquidity decimals (8 decimals) */
+TokenDecimals.LIQUIDITY = new TokenDecimals(8);
+/**
+ * Represents a parsed decimal string as a 64-bit integer with decimal place info.
+ * Used internally for parsing currency strings.
+ */
+export class ParsedFunds {
+    constructor(val, decimalPlaces) {
+        this.val = val;
+        this.decimalPlaces = decimalPlaces;
+    }
+    /**
+     * Parse a decimal string into a ParsedFunds.
+     * @param s - Decimal string (e.g., "123.45")
+     * @returns ParsedFunds or null if invalid
+     */
+    static parse(s) {
+        const MAX_DIGITS = 20;
+        let str = "";
+        let digitsAfterDot = 0;
+        let dotFound = false;
+        for (const char of s) {
+            if (char >= "0" && char <= "9") {
+                if (str.length >= MAX_DIGITS) {
+                    return null;
+                }
+                str += char;
+                if (dotFound) {
+                    digitsAfterDot++;
+                }
+            }
+            else if (char === ".") {
+                if (dotFound) {
+                    return null;
+                }
+                dotFound = true;
+            }
+            else {
+                return null;
+            }
+        }
+        if (str.length === 0) {
+            return null;
+        }
+        const val = BigInt(str);
+        if (val > MAX_U64) {
+            return null;
+        }
+        return new ParsedFunds(val, digitsAfterDot);
+    }
+}
+/**
+ * Convert ParsedFunds to a value for the given number of decimal places.
+ * @param fd - Parsed funds to convert
+ * @param decimals - Target decimal places
+ * @returns Value as bigint or null if invalid
+ */
+function valueFrom(fd, decimals) {
+    if (fd.decimalPlaces > decimals) {
+        return null;
+    }
+    const zeros = decimals - fd.decimalPlaces;
+    let value = fd.val;
+    for (let i = 0; i < zeros; i++) {
+        if (MAX_U64 / 10n < value) {
+            return null;
+        }
+        value *= 10n;
+    }
+    return value;
+}
+/**
+ * Represents token amounts with specific number of decimals.
+ */
+export class Funds {
+    constructor(amount) {
+        this.amount = amount;
+    }
+    /**
+     * Parse a decimal string to Funds.
+     * @param string - Decimal string (e.g., "123.45")
+     * @param decimals - Token decimals
+     * @returns Funds or null if invalid
+     */
+    static parse(string, decimals) {
+        const fd = ParsedFunds.parse(string);
+        if (fd === null)
+            return null;
+        return Funds.fromParsedFunds(fd, decimals);
+    }
+    /**
+     * Convert ParsedFunds to Funds with specific number of decimals.
+     * @param fd - Parsed funds
+     * @param decimals - Token decimals
+     * @returns Funds or null if invalid
+     */
+    static fromParsedFunds(fd, decimals) {
+        const value = valueFrom(fd, decimals.decimals);
+        if (value === null)
+            return null;
+        return new Funds(value);
+    }
+}
+/**
+ * Represents Warthog's native token (WART) with 8 decimal places.
+ */
+export class Wart {
+    constructor(E8) {
+        this.E8 = E8;
+    }
+    /**
+     * Parse a decimal string to Wart.
+     * @param string - Decimal string (e.g., "1.5")
+     * @returns Wart or null if invalid
+     */
+    static parse(string) {
+        const fd = ParsedFunds.parse(string);
+        if (fd === null)
+            return null;
+        return Wart.fromParsedFunds(fd);
+    }
+    /**
+     * Convert ParsedFunds to Wart.
+     * @param fd - Parsed funds
+     * @returns Wart or null if invalid
+     */
+    static fromParsedFunds(fd) {
+        const value = valueFrom(fd, TokenDecimals.WART.decimals);
+        if (value === null)
+            return null;
+        return new Wart(value);
+    }
+    /**
+     * Create Wart from E8 value.
+     * @param E8 - Amount in E8 (1 WART = 100,000,000 E8)
+     * @returns Wart or null if invalid (exceeds MAX_U64)
+     */
+    static fromE8(E8) {
+        if (E8 > MAX_U64) {
+            return null;
+        }
+        return new Wart(E8);
+    }
+    /**
+     * Convert to rounded fee.
+     * @param ceil - If true, round up; otherwise round down
+     * @returns RoundedFee
+     */
+    roundedFee(ceil) {
+        return RoundedFee.fromWart(this, ceil);
+    }
+}
+/**
+ * Represents liquidity pool tokens with 8 decimal places.
+ * Used for liquidity deposit/withdrawal transactions.
+ */
+export class Liquidity {
+    constructor(E8) {
+        this.E8 = E8;
+    }
+    /**
+     * Parse a decimal string to Liquidity.
+     * @param string - Decimal string (e.g., "1.5")
+     * @returns Liquidity or null if invalid
+     */
+    static parse(string) {
+        const fd = ParsedFunds.parse(string);
+        if (fd === null)
+            return null;
+        return Liquidity.fromParsedFunds(fd);
+    }
+    /**
+     * Convert ParsedFunds to Liquidity.
+     * @param fd - Parsed funds
+     * @returns Liquidity or null if invalid
+     */
+    static fromParsedFunds(fd) {
+        const value = valueFrom(fd, TokenDecimals.LIQUIDITY.decimals);
+        if (value === null)
+            return null;
+        return new Liquidity(value);
+    }
+    /**
+     * Create Liquidity from E8 value.
+     * @param E8 - Amount in E8 (1 liquidity = 100,000,000 E8)
+     * @returns Liquidity or null if invalid (exceeds MAX_U64)
+     */
+    static fromE8(E8) {
+        if (E8 > MAX_U64) {
+            return null;
+        }
+        return new Liquidity(E8);
+    }
+}
+/**
+ * Transaction fee in rounded WART format.
+ *
+ * This is NOT the 16-bit compact representation itself. Instead, it is the result of:
+ * 1. Converting WART to 16-bit compact format (CompactFee)
+ * 2. Converting back to WART scale
+ *
+ * This is a lossy operation - the original WART value cannot be restored from RoundedFee.
+ * Warthog nodes require rounded values on the 64-bit WART scale in API calls, not the
+ * raw 16-bit compact representation.
+ */
+export class RoundedFee {
+    constructor(E8) {
+        this.E8 = E8;
+    }
+    /**
+     * Create RoundedFee from Wart.
+     * @param wart - Wart amount
+     * @param ceil - If true, round up; otherwise round down
+     * @returns RoundedFee
+     */
+    static fromWart(wart, ceil) {
+        const compactFee = CompactFee.fromWart(wart, ceil);
+        const roundedWart = compactFee.toWart();
+        return new RoundedFee(roundedWart.E8);
+    }
+    /**
+     * Create RoundedFee from E8 value.
+     * @param E8 - Fee in E8
+     * @param ceil - If true, round up; otherwise round down
+     * @returns RoundedFee or null if invalid
+     */
+    static fromE8(E8, ceil) {
+        const wart = Wart.fromE8(E8);
+        if (wart === null)
+            return null;
+        return RoundedFee.fromWart(wart, ceil);
+    }
+    /**
+     * Get minimum possible fee (0.00000001 WART = 1 E8).
+     * @returns Minimum RoundedFee
+     */
+    static min() {
+        return RoundedFee.fromE8(0n, false);
+    }
+    /**
+     * Convert to Wart.
+     * @returns Wart representation
+     */
+    toWart() {
+        return Wart.fromE8(this.E8);
+    }
+}
+/**
+ * Warthog's internal 16-bit compact fee representation.
+ * Used for compact storage and transmission of transaction fees within the protocol.
+ * Note: This is NOT used in transaction submission API - use RoundedFee instead.
+ */
+export class CompactFee {
+    constructor(exponent, mantissa) {
+        this.exponent = exponent;
+        this.mantissa = mantissa;
+    }
+    /**
+     * Create CompactFee from Wart amount.
+     * @param wart - Wart amount
+     * @param ceil - If true, round up; otherwise round down
+     * @returns CompactFee
+     */
+    static fromWart(wart, ceil) {
+        if (wart.E8 === 0n) {
+            // ignore ceil and return smallest fee which corresponds to
+            // 0.00000001 WART
+            return new CompactFee(0, 0);
+        }
+        let e = 10;
+        const threshold = 0x07ffn;
+        let e8 = wart.E8;
+        let exact = true;
+        while (e8 > threshold) {
+            e += 1;
+            if (ceil && ((e8 & 1n) !== 0n)) {
+                exact = false;
+            }
+            e8 >>= 1n;
+        }
+        if (ceil && exact === false) {
+            e8 += 1n;
+            if (e8 > threshold) {
+                e8 >>= 1n;
+                e += 1;
+                if (e > 53)
+                    return new CompactFee(15, 1023);
+            }
+        }
+        while (e8 < 0x0400n) {
+            e -= 1;
+            e8 <<= 1n;
+        }
+        return new CompactFee(e, Number(e8 - 0x0400n));
+    }
+    /**
+     * Convert CompactFee to Wart.
+     * @returns Wart representation
+     */
+    toWart() {
+        if (this.exponent < 10) {
+            return Wart.fromE8(BigInt(1024 + this.mantissa) >> BigInt(10 - this.exponent));
+        }
+        else {
+            return Wart.fromE8(BigInt(1024 + this.mantissa) << BigInt(this.exponent - 10));
+        }
+    }
+}
+//# sourceMappingURL=Funds.js.map

package/dist/src/types/Funds.js.map

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

package/dist/src/types/HDWallet.d.ts

@@ -0,0 +1,29 @@
+import { Account } from "./Account";
+/**
+ * BIP-44 hierarchical deterministic wallet for Warthog.
+ * Uses derivation path m/44'/2070'/0 for Warthog accounts.
+ */
+export declare class HDWallet {
+    private rootNode;
+    private constructor();
+    /**
+     * Create an HDWallet from a BIP-39 mnemonic phrase.
+     * @param mnemonic - Space-separated list of BIP-39 words (12, 15, 18, 21, or 24 words)
+     * @returns HDWallet instance
+     */
+    static fromMnemonic(mnemonic: string): HDWallet;
+    /**
+     * Derive an account at a specific index.
+     * Uses path m/44'/2070'/0/{index}.
+     * @param index - Account index (non-negative integer)
+     * @returns Account derived at the given index
+     */
+    deriveAccountAtIndex(index: number): Account;
+    /**
+     * Derive an account from a custom BIP-44 path.
+     * @param path - BIP-44 derivation path (e.g., "0/0", "1/5")
+     * @returns Account derived from the path
+     */
+    deriveAccountFromPath(path: string): Account;
+}
+//# sourceMappingURL=HDWallet.d.ts.map

package/dist/src/types/HDWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HDWallet.d.ts","sourceRoot":"","sources":["../../../src/types/HDWallet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAsB;IAEtC,OAAO;IAIP;;;;OAIG;WACW,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAStD;;;;;OAKG;IACI,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInD;;;;OAIG;IACI,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKpD"}

package/dist/src/types/HDWallet.js

@@ -0,0 +1,40 @@
+import { ethers } from "ethers";
+import { Account } from "./Account";
+/**
+ * BIP-44 hierarchical deterministic wallet for Warthog.
+ * Uses derivation path m/44'/2070'/0 for Warthog accounts.
+ */
+export class HDWallet {
+    constructor(rootNode) {
+        this.rootNode = rootNode;
+    }
+    /**
+     * Create an HDWallet from a BIP-39 mnemonic phrase.
+     * @param mnemonic - Space-separated list of BIP-39 words (12, 15, 18, 21, or 24 words)
+     * @returns HDWallet instance
+     */
+    static fromMnemonic(mnemonic) {
+        const rootNode = ethers.HDNodeWallet.fromPhrase(mnemonic, "", "m/44'/2070'/0");
+        return new HDWallet(rootNode);
+    }
+    /**
+     * Derive an account at a specific index.
+     * Uses path m/44'/2070'/0/{index}.
+     * @param index - Account index (non-negative integer)
+     * @returns Account derived at the given index
+     */
+    deriveAccountAtIndex(index) {
+        return this.deriveAccountFromPath(`0/${index}`);
+    }
+    /**
+     * Derive an account from a custom BIP-44 path.
+     * @param path - BIP-44 derivation path (e.g., "0/0", "1/5")
+     * @returns Account derived from the path
+     */
+    deriveAccountFromPath(path) {
+        const childNode = this.rootNode.derivePath(path);
+        const privateKeyHex = childNode.privateKey.slice(2);
+        return Account.fromPrivateKeyHex(privateKeyHex);
+    }
+}
+//# sourceMappingURL=HDWallet.js.map

package/dist/src/types/HDWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HDWallet.js","sourceRoot":"","sources":["../../../src/types/HDWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,OAAO,QAAQ;IAGnB,YAAoB,QAA6B;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAAC,QAAgB;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAC7C,QAAQ,EACR,EAAE,EACF,eAAe,CAChB,CAAC;QACF,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACI,oBAAoB,CAAC,KAAa;QACvC,OAAO,IAAI,CAAC,qBAAqB,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,qBAAqB,CAAC,IAAY;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/src/types/NonceId.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Transaction nonce (32-bit unsigned integer).
+ * Every transaction requires a unique nonce to prevent replay attacks.
+ */
+export declare class NonceId {
+    readonly value: number;
+    private constructor();
+    /**
+     * Validate that a number is a valid 32-bit unsigned integer.
+     * @param value - Number to validate
+     * @returns true if in range [0, 0xFFFFFFFF]
+     */
+    static validate(value: number): boolean;
+    /**
+     * Create a NonceId from a number.
+     * @param value - Nonce value (must be 32-bit unsigned integer)
+     * @returns NonceId instance if valid, null otherwise
+     */
+    static fromNumber(value: number): NonceId | null;
+    /**
+     * Generate a random nonce.
+     * @returns NonceId with random value in valid range
+     */
+    static random(): NonceId;
+}
+//# sourceMappingURL=NonceId.d.ts.map

package/dist/src/types/NonceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NonceId.d.ts","sourceRoot":"","sources":["../../../src/types/NonceId.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,OAAO;aACoB,KAAK,EAAE,MAAM;IAAjD,OAAO;IAEP;;;;OAIG;WACW,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;OAIG;WACW,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAOvD;;;OAGG;WACW,MAAM,IAAI,OAAO;CAGlC"}

package/dist/src/types/NonceId.js

@@ -0,0 +1,37 @@
+const MAX_U32 = 0xFFFFFFFF; // 4294967295
+/**
+ * Transaction nonce (32-bit unsigned integer).
+ * Every transaction requires a unique nonce to prevent replay attacks.
+ */
+export class NonceId {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * Validate that a number is a valid 32-bit unsigned integer.
+     * @param value - Number to validate
+     * @returns true if in range [0, 0xFFFFFFFF]
+     */
+    static validate(value) {
+        return value >= 0 && value <= MAX_U32;
+    }
+    /**
+     * Create a NonceId from a number.
+     * @param value - Nonce value (must be 32-bit unsigned integer)
+     * @returns NonceId instance if valid, null otherwise
+     */
+    static fromNumber(value) {
+        if (!NonceId.validate(value)) {
+            return null;
+        }
+        return new NonceId(value);
+    }
+    /**
+     * Generate a random nonce.
+     * @returns NonceId with random value in valid range
+     */
+    static random() {
+        return new NonceId(Math.floor(Math.random() * MAX_U32));
+    }
+}
+//# sourceMappingURL=NonceId.js.map

package/dist/src/types/NonceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NonceId.js","sourceRoot":"","sources":["../../../src/types/NonceId.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,aAAa;AAEzC;;;GAGG;AACH,MAAM,OAAO,OAAO;IAChB,YAAoC,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAErD;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAa;QAChC,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,KAAa;QAClC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,MAAM;QAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;CACJ"}

package/dist/src/types/Price.d.ts

@@ -0,0 +1,93 @@
+import { TokenDecimals } from './Funds';
+export { TokenDecimals };
+/**
+ * Represents a swap price in normalized mantissa/exponent format.
+ * - Mantissa: 16 bits, must be in range [0x8000, 0xFFFF] (high bit set for normalization)
+ * - Exponent: 8 bits, stored with offset +63 internally to map to range [0, 127]
+ * The price is interpreted as a qutient of the base and quote amount *integers*, i.e. when
+ * creating or printing this price representation, one must account for the number of
+ * decimals of the involved base asset traded.
+ *
+ * Used in limit swap transactions.
+ */
+export declare class Price {
+    readonly mantissa: number;
+    readonly exponent: number;
+    private constructor();
+    /**
+     * Check if a mantissa is valid (normalized, high bit set).
+     * @param m - Mantissa value to check
+     * @returns true if in range [0x8000, 0xFFFF]
+     */
+    private static isMantissa;
+    /**
+     * Check if a internal exponent representation is valid.
+     * @param e - Exponent value to check
+     * @returns true if in range [0, 127]
+     */
+    private static isExponent;
+    /**
+     * Get the maximum possible price.
+     * @returns Price with maximum mantissa (0xFFFF) and exponent (127)
+     */
+    static max(): Price;
+    /**
+     * Convert stored internal exponent to base-2 exponent.
+     * @returns Base-2 exponent (exponent - 63)
+     */
+    private exponentBase2;
+    /**
+     * Get the base-2 exponent if mantissa is not considered as
+     * a fraction but as an integer.
+     * @returns Base-2 exponent for mantissa
+     */
+    mantissaExponent2(): number;
+    /**
+     * Convert price to raw double (without decimals adjustment).
+     * @returns Price as double (mantissa * 2^exponent2)
+     */
+    toDoubleRaw(): number;
+    /**
+     * Convert price to double corrected for asset decimals. In Warthog, every
+     * market is with respect to WART as quote asset, which always has 8 decimals
+     * so we only need to pass the base, i.e. asset decimals.
+     * @param dec - Number decimal places of the traded asset
+     * @returns Price as double with decimal places adjustment applied
+     */
+    toDoubleAdjusted(dec: TokenDecimals): number;
+    /**
+     * Calculate base-10 exponent for decimals adjustment.
+     * @param dec - Number of decimals of the traded asset
+     * @returns Difference between WART decimals (8) and asset decimals
+     */
+    private base10_decimals_exponent;
+    /**
+     * Create Price from raw mantissa and exponent values.
+     * @param mantissa - 16-bit mantissa (must be normalized: 0x8000-0xFFFF)
+     * @param exponent - Raw exponent before +63 adjustment (0-127)
+     * @returns Price instance if valid, null otherwise
+     */
+    static fromMantissaExponent(mantissa: number, exponent: number): Price | null;
+    /**
+     * Create Price from a number and given decimals of the base asset.
+     * This is the recommended factory method for users.
+     * @param d - Price as decimal number
+     * @param baseDecimals - Number of decimals of the traded asset
+     * @param ceil - If true, round up; otherwise round down
+     * @returns Price instance if valid, null otherwise
+     */
+    static fromNumberDecimals(d: number, baseDecimals: TokenDecimals, ceil?: boolean): Price | null;
+    static fromDoubleInternal(d: number, ceil?: boolean): Price | null;
+    /**
+     * Convert price to 6-character hex string for transaction.
+     * @returns Hex string (4 chars mantissa + 2 chars exponent)
+     */
+    toHex(): string;
+    /**
+     * Parse price from 6-character hex string.
+     * @param hex - 6-character hex string (4 chars mantissa + 2 chars exponent)
+     * @returns Price instance if valid, null otherwise
+     */
+    static fromHex(hex: string): Price | null;
+}
+//# sourceMappingURL=Price.d.ts.map

package/dist/src/types/Price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Price.d.ts","sourceRoot":"","sources":["../../../src/types/Price.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;;;;GASG;AACH,qBAAa,KAAK;aAEM,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;IAFpC,OAAO;IAKP;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAKzB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB;;;OAGG;WACW,GAAG,IAAI,KAAK;IAK1B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;;OAGG;IACI,WAAW,IAAI,MAAM;IAK5B;;;;;;OAMG;IACI,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM;IAMnD;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;;;;OAKG;WACW,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAQpF;;;;;;;OAOG;WACW,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,GAAE,OAAe,GAAG,KAAK,GAAG,IAAI;WAW/F,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,OAAe,GAAG,KAAK,GAAG,IAAI;IAqBhF;;;OAGG;IACI,KAAK,IAAI,MAAM;IAMtB;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;CAmBnD"}