@getomnichain/omnichain 0.6.2 → 0.7.0

package/dist/esm/ton/ton_jetton_metadata.js

@@ -0,0 +1,103 @@
+import { createHash } from 'node:crypto';
+import { Dictionary } from '@ton/core';
+import { ChainErrorKinds } from "../errors.js";
+import { TonProviderError } from "./ton_provider.js";
+const TEP64_KEYS = ['uri', 'name', 'description', 'image', 'symbol', 'decimals'];
+const OFFCHAIN_FETCH_TIMEOUT_MS = 10_000;
+const OFFCHAIN_MAX_BYTES = 64 * 1024;
+const TEP64_DEFAULT_DECIMALS = 9;
+/**
+ * The fields of a jetton master's content cell (`get_jetton_data`, TEP-64):
+ * on-chain (prefix 0x00, a dictionary keyed by the SHA-256 of each field
+ * name, values snake or chunked), or off-chain (any other prefix, a snake
+ * URI — TEP-64's 0x01 and the older variants some jettons use).
+ */
+export function parseTonJettonContent(content) {
+    const slice = content.beginParse();
+    const prefix = slice.loadUint(8);
+    if (prefix !== 0x00)
+        return { fields: {}, uri: slice.loadStringTail() };
+    const dict = slice.loadDict(Dictionary.Keys.Buffer(32), Dictionary.Values.Cell());
+    const fields = {};
+    for (const key of TEP64_KEYS) {
+        const value = dict.get(createHash('sha256').update(key).digest());
+        if (value !== undefined)
+            fields[key] = contentDataOf(value.beginParse());
+    }
+    return { fields, uri: fields.uri ?? null };
+}
+/**
+ * A jetton's metadata from its content cell, filling what the content lacks
+ * from the off-chain JSON its URI names (https only).
+ *
+ * The decimals decide every amount, so they are never guessed: when the
+ * content names none and the off-chain JSON could not be read, this throws
+ * (retryably). A symbol that cannot be read is `null`.
+ */
+export async function readTonJettonMetadata(content, fetchJson = fetchOffchainJson) {
+    const { fields, uri } = parseTonJettonContent(content);
+    const merged = { ...fields };
+    let offchainRead = uri === null;
+    if (uri !== null && (merged.symbol === undefined || merged.decimals === undefined)) {
+        try {
+            const json = await fetchJson(uri);
+            if (json !== null && typeof json === 'object' && !Array.isArray(json)) {
+                for (const key of TEP64_KEYS) {
+                    const value = json[key];
+                    if (merged[key] === undefined && (typeof value === 'string' || typeof value === 'number'))
+                        merged[key] = String(value);
+                }
+                offchainRead = true;
+            }
+        }
+        catch {
+            offchainRead = false;
+        }
+    }
+    else {
+        offchainRead = true;
+    }
+    if (merged.decimals === undefined && !offchainRead) {
+        throw new TonProviderError(ChainErrorKinds.RpcError, `Could not read the jetton's decimals: its metadata at ${uri} did not load`, true);
+    }
+    return {
+        symbol: merged.symbol ?? null,
+        name: merged.name ?? null,
+        decimals: merged.decimals === undefined ? TEP64_DEFAULT_DECIMALS : decimalsOf(merged.decimals),
+        description: merged.description ?? null,
+        image: merged.image ?? null,
+        uri,
+    };
+}
+function decimalsOf(value) {
+    if (!/^\d{1,3}$/.test(value.trim()) || Number(value) > 255) {
+        throw new TonProviderError(ChainErrorKinds.InvalidTokenIdentifier, `A jetton's decimals must be 0 to 255, got ${JSON.stringify(value)}`, false);
+    }
+    return Number(value);
+}
+/** A TEP-64 content value: snake (0x00) or chunked (0x01, a dictionary of snake chunks). */
+function contentDataOf(slice) {
+    const prefix = slice.loadUint(8);
+    if (prefix === 0x00)
+        return slice.loadStringTail();
+    if (prefix === 0x01) {
+        const chunks = slice.loadDict(Dictionary.Keys.Uint(32), Dictionary.Values.Cell());
+        return [...chunks.keys()]
+            .sort((a, b) => a - b)
+            .map((index) => chunks.get(index).beginParse().loadStringTail())
+            .join('');
+    }
+    throw new TonProviderError(ChainErrorKinds.InvalidTokenIdentifier, `Unknown TEP-64 content data prefix 0x${prefix.toString(16)}`, false);
+}
+async function fetchOffchainJson(uri) {
+    if (!uri.startsWith('https://'))
+        throw new Error(`only https metadata is fetched, not ${uri}`);
+    const response = await fetch(uri, { signal: AbortSignal.timeout(OFFCHAIN_FETCH_TIMEOUT_MS), redirect: 'follow' });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    const text = await response.text();
+    if (text.length > OFFCHAIN_MAX_BYTES)
+        throw new Error('metadata too large');
+    return JSON.parse(text);
+}
+//# sourceMappingURL=ton_jetton_metadata.js.map

package/dist/esm/ton/ton_jetton_metadata.js.map

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

package/dist/esm/ton/ton_messages.d.ts

@@ -0,0 +1,133 @@
+import { Address, Cell, type OutActionSendMsg, SendMode, type StateInit } from '@ton/core';
+import { AbstractSignedMessage } from '../wallet.base.ts';
+/**
+ * What `signMessage` signs: SHA-256 of a fixed prefix and the message's UTF-8
+ * bytes, as Stellar's SEP-53 does. The same key authorizes W5 requests by
+ * signing a 32-byte cell hash, so signing a message's bytes directly would let
+ * a crafted 32-byte message stand in for a request; a prefixed digest cannot
+ * equal a cell hash without a SHA-256 preimage.
+ */
+export declare function tonMessageHash(message: string): Buffer;
+export declare class TonSignedMessage extends AbstractSignedMessage {
+    constructor(signature: string);
+}
+/** W5's limit on outgoing messages per request. */
+export declare const TON_MAX_MESSAGES_PER_REQUEST = 255;
+/** The send mode a message gets unless it names one: the wallet pays forward fees on top of `value`. */
+export declare const TON_DEFAULT_SEND_MODE = SendMode.PAY_GAS_SEPARATELY;
+export declare const TON_COMMENT_OP = 0;
+export declare const TON_JETTON_TRANSFER_OP = 260734629;
+export declare const TON_JETTON_INTERNAL_TRANSFER_OP = 395134233;
+/** One outgoing internal message of a wallet request. */
+export interface TonOutMessage {
+    /** Any address form. */
+    to: string;
+    /** Nanotons attached. */
+    value: bigint;
+    body?: Cell;
+    /** Defaults to `true` when there is a body and `false` otherwise. */
+    bounce?: boolean;
+    stateInit?: StateInit;
+    /** Defaults to {@link TON_DEFAULT_SEND_MODE}. */
+    mode?: number;
+}
+export declare function tonOutAction(message: TonOutMessage): OutActionSendMsg;
+export declare function tonOutActions(messages: readonly TonOutMessage[]): OutActionSendMsg[];
+/** A text comment body (op 0), the form wallets show as a memo. */
+export declare function tonCommentBody(text: string): Cell;
+export interface TonJettonTransferBodyArgs {
+    /** Jetton units, in the jetton's smallest unit. */
+    amount: bigint;
+    /** The new owner (not their jetton wallet). */
+    destination: string;
+    /** Who receives the excess TON once the transfer settles. */
+    responseDestination: string;
+    /** TON forwarded to `destination` with the transfer notification; 0 sends none. */
+    forwardTonAmount?: bigint;
+    forwardPayload?: Cell;
+    queryId?: bigint;
+}
+/** The TEP-74 `transfer` body, sent to the sender's own jetton wallet. */
+export declare function tonJettonTransferBody(args: TonJettonTransferBodyArgs): Cell;
+export declare const TON_W5_SIGNED_INTERNAL_OP = 1936289396;
+export declare const TON_W5_SIGNED_EXTERNAL_OP = 1936287598;
+/** What a signed W5 request commits to, read back from its body. */
+export interface TonW5RequestFields {
+    /** `external`: the wallet sends it itself; `internal`: a relayer delivers it. */
+    authType: 'external' | 'internal';
+    walletId: number;
+    /** Unix seconds; the wallet refuses it from then on. */
+    validUntil: number;
+    /** The wallet seqno it executes at. */
+    seqno: number;
+}
+/**
+ * The fields of a signed W5R1 request body: op, wallet id, `valid_until` and
+ * seqno lead the body, the signature trails it. Throws `TransactionDecodeFailed`
+ * for anything that is not one.
+ */
+export declare function tonW5RequestFields(body: Cell): TonW5RequestFields;
+/** What a signed wallet request commits to, whatever its version. */
+export interface TonWalletRequestFields {
+    /** `w5`: op, wallet id, valid_until, seqno first, the signature at the tail. `legacy`: v3r2 / v4r2, the signature first. */
+    layout: 'w5' | 'legacy';
+    walletId: number;
+    validUntil: number;
+    seqno: number;
+}
+/**
+ * The fields of any signed wallet request body the SDK builds. A v3r2 / v4r2
+ * body is the signature, then wallet id, valid_until and seqno, every field
+ * whole bytes; a W5 body leads with its op and is never byte-aligned (its
+ * action-list flags are two bits). Throws `TransactionDecodeFailed` for
+ * anything else.
+ */
+export declare function tonWalletRequestFields(body: Cell): TonWalletRequestFields;
+/**
+ * A request a wallet signed for a relayer (`TonWallet.createInternalRequest`),
+ * with the seqno and `validUntil` it commits to — what
+ * `TonChain.getRequestState` needs once it has been sent.
+ */
+export interface TonInternalRequest {
+    /** The signed request, the relay message's body. */
+    body: Cell;
+    seqno: number;
+    validUntil: number;
+}
+/** A signed internal request read back from its body, e.g. one found in a trace. */
+export declare function tonInternalRequestOf(body: Cell): TonInternalRequest;
+/** The wallet contracts the SDK builds: W5 (v5r1), and v4r2 / v3r2 as the Python SDK has them. */
+export type TonWalletVersion = 'v3r2' | 'v4r2' | 'v5r1';
+/** The wallet a relay delivers to: its address and the StateInit that deploys it (a `TonWallet` fits). */
+export interface TonRelayTarget {
+    address: string;
+    stateInit: StateInit;
+    /** Relaying needs W5; any other version is refused. */
+    version?: TonWalletVersion;
+}
+export interface TonRelayMessageArgs {
+    wallet: TonRelayTarget;
+    /** The wallet's own signed internal request (`TonWallet.createInternalRequest`). */
+    request: TonInternalRequest;
+    /** Nanotons the relayer attaches: the trace's fees plus whatever the request's messages need. */
+    value: bigint;
+    /** Attach the wallet's StateInit, deploying it; set while it is not deployed. */
+    deploy: boolean;
+}
+/**
+ * The message a relayer sends to deliver a wallet's signed internal request.
+ *
+ * Bounceable, so a request that fails in the wallet returns the value. A
+ * request the wallet does not accept (a bad signature, a stale seqno) is
+ * dropped without a bounce and the wallet keeps the value; the transaction
+ * status reports that as `request_not_executed`.
+ */
+export declare function tonRelayMessage(args: TonRelayMessageArgs): TonOutMessage;
+/**
+ * The normalized hash of an external message (TEP-467): source, import fee and
+ * StateInit dropped, body stored as a reference. It is what both TON Center and
+ * TonAPI index the external message under, and is used as the transaction id.
+ */
+export declare function tonNormalizedExternalHash(destination: string, body: Cell): string;
+export declare function parseTonAddress(address: string): Address;
+//# sourceMappingURL=ton_messages.d.ts.map

package/dist/esm/ton/ton_messages.d.ts.map

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

package/dist/esm/ton/ton_messages.js

@@ -0,0 +1,159 @@
+import { Address, SendMode, beginCell, internal, storeMessage, } from '@ton/core';
+import { createHash } from 'node:crypto';
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { AbstractSignedMessage } from "../wallet.base.js";
+const TON_MESSAGE_PREFIX = 'TON Signed Message:\n';
+/**
+ * What `signMessage` signs: SHA-256 of a fixed prefix and the message's UTF-8
+ * bytes, as Stellar's SEP-53 does. The same key authorizes W5 requests by
+ * signing a 32-byte cell hash, so signing a message's bytes directly would let
+ * a crafted 32-byte message stand in for a request; a prefixed digest cannot
+ * equal a cell hash without a SHA-256 preimage.
+ */
+export function tonMessageHash(message) {
+    return createHash('sha256').update(TON_MESSAGE_PREFIX, 'utf8').update(message, 'utf8').digest();
+}
+export class TonSignedMessage extends AbstractSignedMessage {
+    constructor(signature) {
+        super(signature);
+    }
+}
+/** W5's limit on outgoing messages per request. */
+export const TON_MAX_MESSAGES_PER_REQUEST = 255;
+/** The send mode a message gets unless it names one: the wallet pays forward fees on top of `value`. */
+export const TON_DEFAULT_SEND_MODE = SendMode.PAY_GAS_SEPARATELY;
+export const TON_COMMENT_OP = 0;
+export const TON_JETTON_TRANSFER_OP = 0x0f8a7ea5;
+export const TON_JETTON_INTERNAL_TRANSFER_OP = 0x178d4519;
+export function tonOutAction(message) {
+    if (message.value < 0n) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `TON message value must be >= 0, got ${message.value}`);
+    }
+    return {
+        type: 'sendMsg',
+        mode: message.mode ?? TON_DEFAULT_SEND_MODE,
+        outMsg: internal({
+            to: parseTonAddress(message.to),
+            value: message.value,
+            bounce: message.bounce ?? message.body !== undefined,
+            body: message.body,
+            init: message.stateInit,
+        }),
+    };
+}
+export function tonOutActions(messages) {
+    if (messages.length === 0 || messages.length > TON_MAX_MESSAGES_PER_REQUEST) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `A TON request carries 1 to ${TON_MAX_MESSAGES_PER_REQUEST} messages, got ${messages.length}`);
+    }
+    return messages.map(tonOutAction);
+}
+/** A text comment body (op 0), the form wallets show as a memo. */
+export function tonCommentBody(text) {
+    return beginCell().storeUint(TON_COMMENT_OP, 32).storeStringTail(text).endCell();
+}
+/** The TEP-74 `transfer` body, sent to the sender's own jetton wallet. */
+export function tonJettonTransferBody(args) {
+    const builder = beginCell()
+        .storeUint(TON_JETTON_TRANSFER_OP, 32)
+        .storeUint(args.queryId ?? 0n, 64)
+        .storeCoins(args.amount)
+        .storeAddress(parseTonAddress(args.destination))
+        .storeAddress(parseTonAddress(args.responseDestination))
+        .storeBit(false)
+        .storeCoins(args.forwardTonAmount ?? 0n);
+    return args.forwardPayload === undefined
+        ? builder.storeBit(false).endCell()
+        : builder.storeBit(true).storeRef(args.forwardPayload).endCell();
+}
+export const TON_W5_SIGNED_INTERNAL_OP = 0x73696e74;
+export const TON_W5_SIGNED_EXTERNAL_OP = 0x7369676e;
+/**
+ * The fields of a signed W5R1 request body: op, wallet id, `valid_until` and
+ * seqno lead the body, the signature trails it. Throws `TransactionDecodeFailed`
+ * for anything that is not one.
+ */
+export function tonW5RequestFields(body) {
+    try {
+        const slice = body.beginParse();
+        const op = slice.loadUint(32);
+        if (op !== TON_W5_SIGNED_EXTERNAL_OP && op !== TON_W5_SIGNED_INTERNAL_OP)
+            throw new Error(`op 0x${op.toString(16)}`);
+        return {
+            authType: op === TON_W5_SIGNED_EXTERNAL_OP ? 'external' : 'internal',
+            walletId: slice.loadInt(32),
+            validUntil: slice.loadUint(32),
+            seqno: slice.loadUint(32),
+        };
+    }
+    catch (err) {
+        throw new ChainError(ChainErrorKinds.TransactionDecodeFailed, `Not a signed W5 request: ${err.message}`, undefined, err);
+    }
+}
+const ED25519_SIGNATURE_BITS = 512;
+/**
+ * The fields of any signed wallet request body the SDK builds. A v3r2 / v4r2
+ * body is the signature, then wallet id, valid_until and seqno, every field
+ * whole bytes; a W5 body leads with its op and is never byte-aligned (its
+ * action-list flags are two bits). Throws `TransactionDecodeFailed` for
+ * anything else.
+ */
+export function tonWalletRequestFields(body) {
+    if (body.bits.length % 8 !== 0)
+        return { layout: 'w5', ...tonW5RequestFields(body) };
+    try {
+        const slice = body.beginParse();
+        slice.skip(ED25519_SIGNATURE_BITS);
+        return { layout: 'legacy', walletId: slice.loadUint(32), validUntil: slice.loadUint(32), seqno: slice.loadUint(32) };
+    }
+    catch (err) {
+        throw new ChainError(ChainErrorKinds.TransactionDecodeFailed, `Not a signed wallet request: ${err.message}`, undefined, err);
+    }
+}
+/** A signed internal request read back from its body, e.g. one found in a trace. */
+export function tonInternalRequestOf(body) {
+    const fields = tonW5RequestFields(body);
+    if (fields.authType !== 'internal') {
+        throw new ChainError(ChainErrorKinds.TransactionDecodeFailed, 'Not a signed W5 internal request: it is an external one');
+    }
+    return { body, seqno: fields.seqno, validUntil: fields.validUntil };
+}
+/**
+ * The message a relayer sends to deliver a wallet's signed internal request.
+ *
+ * Bounceable, so a request that fails in the wallet returns the value. A
+ * request the wallet does not accept (a bad signature, a stale seqno) is
+ * dropped without a bounce and the wallet keeps the value; the transaction
+ * status reports that as `request_not_executed`.
+ */
+export function tonRelayMessage(args) {
+    if (args.wallet.version !== undefined && args.wallet.version !== 'v5r1') {
+        throw new ChainError(ChainErrorKinds.FeatureNotSupported, `Only W5 (v5r1) wallets take relayed requests; ${args.wallet.address} is ${args.wallet.version}`);
+    }
+    return {
+        to: args.wallet.address,
+        value: args.value,
+        body: args.request.body,
+        bounce: true,
+        stateInit: args.deploy ? args.wallet.stateInit : undefined,
+    };
+}
+/**
+ * The normalized hash of an external message (TEP-467): source, import fee and
+ * StateInit dropped, body stored as a reference. It is what both TON Center and
+ * TonAPI index the external message under, and is used as the transaction id.
+ */
+export function tonNormalizedExternalHash(destination, body) {
+    const normalized = beginCell()
+        .store(storeMessage({ info: { type: 'external-in', src: null, dest: parseTonAddress(destination), importFee: 0n }, body }, { forceRef: true }))
+        .endCell();
+    return normalized.hash().toString('hex');
+}
+export function parseTonAddress(address) {
+    try {
+        return Address.parse(address);
+    }
+    catch (err) {
+        throw new ChainError(ChainErrorKinds.InvalidAddress, `Invalid TON address: ${address}`, { address }, err);
+    }
+}
+//# sourceMappingURL=ton_messages.js.map

package/dist/esm/ton/ton_messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ton_messages.js","sourceRoot":"","sources":["../../../ton/ton_messages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAGP,QAAQ,EAER,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IACzD,YAAY,SAAiB;QAC3B,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,wGAAwG;AACxG,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,kBAAkB,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AACjD,MAAM,CAAC,MAAM,+BAA+B,GAAG,UAAU,CAAC;AAgB1D,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,IAAI,OAAO,CAAC,KAAK,GAAG,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,uCAAuC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,qBAAqB;QAC3C,MAAM,EAAE,QAAQ,CAAC;YACf,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YACpD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,SAAS;SACxB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAkC;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;QAC5E,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,8BAA8B,4BAA4B,kBAAkB,QAAQ,CAAC,MAAM,EAAE,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,SAAS,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACnF,CAAC;AAeD,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAA+B;IACnE,MAAM,OAAO,GAAG,SAAS,EAAE;SACxB,SAAS,CAAC,sBAAsB,EAAE,EAAE,CAAC;SACrC,SAAS,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC;SACjC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;SACvB,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SAC/C,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;SACvD,QAAQ,CAAC,KAAK,CAAC;SACf,UAAU,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS;QACtC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;QACnC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAapD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,yBAAyB,IAAI,EAAE,KAAK,yBAAyB;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACrH,OAAO;YACL,QAAQ,EAAE,EAAE,KAAK,yBAAyB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;YACpE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,EAAE,4BAA6B,GAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAY,CAAC,CAAC;IAC/I,CAAC;AACH,CAAC;AAWD,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAC/C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IACrF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACvH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,EAAE,gCAAiC,GAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAY,CAAC,CAAC;IACnJ,CAAC;AACH,CAAC;AAcD,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,IAAU;IAC7C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,EAAE,yDAAyD,CAAC,CAAC;IAC3H,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACtE,CAAC;AAuBD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACxE,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,mBAAmB,EACnC,iDAAiD,IAAI,CAAC,MAAM,CAAC,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CACjG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,IAAU;IACvE,MAAM,UAAU,GAAG,SAAS,EAAE;SAC3B,KAAK,CACJ,YAAY,CACV,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EACrG,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CACF;SACA,OAAO,EAAE,CAAC;IACb,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,cAAc,EAAE,wBAAwB,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,GAAY,CAAC,CAAC;IACrH,CAAC;AACH,CAAC"}