@sravankumar02/sdk-core 1.0.0

package/out/core/transaction.d.ts

@@ -0,0 +1,263 @@
+/// <reference types="node" />
+import { BigNumber } from "bignumber.js";
+import { Address } from "./address";
+import { INetworkConfig, IPlainTransactionObject } from "./interfaces";
+/**
+ * An abstraction for creating and signing transactions.
+ */
+export declare class Transaction {
+    /**
+     * The nonce of the transaction (the account sequence number of the sender).
+     */
+    nonce: bigint;
+    /**
+     * The value to transfer.
+     */
+    value: bigint;
+    /**
+     * The address of the sender.
+     */
+    sender: Address;
+    /**
+     * The address of the receiver.
+     */
+    receiver: Address;
+    /**
+     * The username of the sender.
+     */
+    senderUsername: string;
+    /**
+     * The username of the receiver.
+     */
+    receiverUsername: string;
+    /**
+     * The gas price to be used.
+     */
+    gasPrice: bigint;
+    /**
+     * The maximum amount of gas to be consumed when processing the transaction.
+     */
+    gasLimit: bigint;
+    /**
+     * The payload of the transaction.
+     */
+    data: Uint8Array;
+    /**
+     * The chain ID of the Network (e.g. "1" for Mainnet).
+     */
+    chainID: string;
+    /**
+     * The version, required by the Network in order to correctly interpret the contents of the transaction.
+     */
+    version: number;
+    /**
+     * The options field, useful for describing different settings available for transactions.
+     */
+    options: number;
+    /**
+     * The address of the guardian, in bech32 format.
+     */
+    guardian: Address;
+    /**
+     * The relayer address.
+     *  Note: in the next major version, `sender`, `receiver` and `guardian` will also have the type `Address`, instead of `string`.
+     */
+    relayer: Address;
+    /**
+     * The signature.
+     */
+    signature: Uint8Array;
+    /**
+     * The signature of the guardian.
+     */
+    guardianSignature: Uint8Array;
+    /**
+     * The signature of the relayer.
+     */
+    relayerSignature: Uint8Array;
+    /**
+     * Creates a new Transaction object.
+     */
+    constructor(options: {
+        nonce?: bigint;
+        value?: bigint;
+        sender: Address;
+        receiver: Address;
+        senderUsername?: string;
+        receiverUsername?: string;
+        gasPrice?: bigint;
+        gasLimit: bigint;
+        data?: Uint8Array;
+        chainID: string;
+        version?: number;
+        options?: number;
+        guardian?: Address;
+        relayer?: Address;
+        signature?: Uint8Array;
+        guardianSignature?: Uint8Array;
+        relayerSignature?: Uint8Array;
+    });
+    /**
+     * @deprecated method, use {@link nonce} property instead.
+     */
+    getNonce(): bigint;
+    /**
+     * @deprecated method, use {@link nonce} property instead.
+     * Sets the account sequence number of the sender. Must be done prior signing.
+     */
+    setNonce(nonce: bigint): void;
+    /**
+     * @deprecated method, use {@link value} property instead.
+     */
+    getValue(): bigint;
+    /**
+     * @deprecated method, use {@link value} property instead.
+     */
+    setValue(value: bigint): void;
+    /**
+     * @deprecated method, use {@link sender} property instead.
+     */
+    getSender(): Address;
+    /**
+     * @deprecated method, use {@link sender} property instead.
+     */
+    setSender(sender: Address): void;
+    /**
+     * @deprecated method, use {@link receiver} property instead.
+     */
+    getReceiver(): Address;
+    /**
+     * @deprecated method, use {@link senderUsername} property instead.
+     */
+    getSenderUsername(): string;
+    /**
+     * @deprecated method, use {@link senderUsername} property instead.
+     */
+    setSenderUsername(senderUsername: string): void;
+    /**
+     * @deprecated method, use {@link receiverUsername} property instead.
+     */
+    getReceiverUsername(): string;
+    /**
+     * @deprecated method, use {@link receiverUsername} property instead.
+     */
+    setReceiverUsername(receiverUsername: string): void;
+    /**
+     * @deprecated method, use {@link guardian} property instead.
+     */
+    getGuardian(): Address;
+    /**
+     * @deprecated method, use {@link gasPrice} property instead.
+     */
+    getGasPrice(): bigint;
+    /**
+     * @deprecated method, use {@link gasPrice} property instead.
+     */
+    setGasPrice(gasPrice: bigint): void;
+    /**
+     * @deprecated method, use {@link gasLimit} property instead.
+     */
+    getGasLimit(): bigint;
+    /**
+     * @deprecated method, use {@link gasLimit} property instead.
+     */
+    setGasLimit(gasLimit: bigint): void;
+    /**
+     * @deprecated method, use {@link data} property instead.
+     */
+    getData(): Uint8Array;
+    /**
+     * @deprecated method, use {@link chainID} property instead.
+     */
+    getChainID(): string;
+    /**
+     * @deprecated method, use {@link chainID} property instead.
+     */
+    setChainID(chainID: string): void;
+    /**
+     * @deprecated method, use {@link version} property instead.
+     */
+    getVersion(): number;
+    /**
+     * @deprecated method, use {@link version} property instead.
+     */
+    setVersion(version: number): void;
+    /**
+     * @deprecated method, use {@link options} property instead.
+     */
+    getOptions(): number;
+    /**
+     * @deprecated method, use {@link options} property instead.
+     *
+     * Question for review: check how the options are set by sdk-dapp, wallet, ledger, extension.
+     */
+    setOptions(options: number): void;
+    /**
+     * @deprecated method, use{@link signature} property instead.
+     */
+    getSignature(): Buffer;
+    /**
+     * @deprecated method, use {@link guardianSignature} property instead.
+     */
+    getGuardianSignature(): Buffer;
+    /**
+     * @deprecated method, use {@link guardian} property instead.
+     */
+    setGuardian(guardian: Address): void;
+    /**
+     * @deprecated method, use "TransactionComputer.computeBytesForSigning()" instead.
+     * Serializes a transaction to a sequence of bytes, ready to be signed.
+     * This function is called internally by signers.
+     */
+    serializeForSigning(): Buffer;
+    /**
+     * Checks the integrity of the guarded transaction
+     */
+    isGuardedTransaction(): boolean;
+    /**
+     * Converts the transaction object into a ready-to-serialize, plain JavaScript object.
+     * This function is called internally within the signing procedure.
+     */
+    toPlainObject(): IPlainTransactionObject;
+    /**
+     * @deprecated method, use {@link toPlainObject} instead.
+     * Converts a plain object transaction into a Transaction Object.
+     *
+     * @param plainObjectTransaction Raw data of a transaction, usually obtained by calling toPlainObject()
+     */
+    static fromPlainObject(plainObjectTransaction: IPlainTransactionObject): Transaction;
+    /**
+     * Converts a plain object transaction into a Transaction Object.
+     *
+     * @param plainObjectTransaction Raw data of a transaction, usually obtained by calling toPlainObject()
+     */
+    static newFromPlainObject(plainObjectTransaction: IPlainTransactionObject): Transaction;
+    /**
+     * @deprecated method, use {@link signature} property instead.
+     * Applies the signature on the transaction.
+     *
+     * @param signature The signature, as computed by a signer.
+     */
+    applySignature(signature: Uint8Array): void;
+    /**
+     * @deprecated method, use {@link guardianSignature} property instead.
+     * Applies the guardian signature on the transaction.
+     *
+     * @param guardianSignature The signature, as computed by a signer.
+     */
+    applyGuardianSignature(guardianSignature: Uint8Array): void;
+    /**
+     * Converts a transaction to a ready-to-broadcast object.
+     * Called internally by the network provider.
+     */
+    toSendable(): any;
+    /**
+     * @deprecated method, use "TransactionComputer.computeTransactionFee()" instead.
+     *
+     * Computes the current transaction fee based on the {@link NetworkConfig} and transaction properties
+     * @param networkConfig {@link NetworkConfig}
+     */
+    computeFee(networkConfig: INetworkConfig): BigNumber;
+    private toBase64OrUndefined;
+    private toHexOrUndefined;
+}

package/out/core/transaction.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transaction = void 0;
+const bignumber_js_1 = require("bignumber.js");
+const address_1 = require("./address");
+const constants_1 = require("./constants");
+const signature_1 = require("./signature");
+const transactionComputer_1 = require("./transactionComputer");
+/**
+ * An abstraction for creating and signing transactions.
+ */
+class Transaction {
+    /**
+     * Creates a new Transaction object.
+     */
+    constructor(options) {
+        this.nonce = options.nonce ?? 0n;
+        this.value = options.value ?? 0n;
+        this.sender = options.sender;
+        this.receiver = options.receiver;
+        this.senderUsername = options.senderUsername || "";
+        this.receiverUsername = options.receiverUsername || "";
+        this.gasPrice = options.gasPrice ?? BigInt(constants_1.TRANSACTION_MIN_GAS_PRICE);
+        this.gasLimit = options.gasLimit;
+        this.data = options.data ?? new Uint8Array();
+        this.chainID = options.chainID.valueOf();
+        this.version = options.version ?? constants_1.TRANSACTION_VERSION_DEFAULT;
+        this.options = options.options ?? constants_1.TRANSACTION_OPTIONS_DEFAULT;
+        this.guardian = options.guardian ?? address_1.Address.empty();
+        this.relayer = options.relayer ? options.relayer : address_1.Address.empty();
+        this.signature = options.signature || Buffer.from([]);
+        this.guardianSignature = options.guardianSignature || Buffer.from([]);
+        this.relayerSignature = options.relayerSignature || Buffer.from([]);
+    }
+    /**
+     * @deprecated method, use {@link nonce} property instead.
+     */
+    getNonce() {
+        return this.nonce;
+    }
+    /**
+     * @deprecated method, use {@link nonce} property instead.
+     * Sets the account sequence number of the sender. Must be done prior signing.
+     */
+    setNonce(nonce) {
+        this.nonce = nonce;
+    }
+    /**
+     * @deprecated method, use {@link value} property instead.
+     */
+    getValue() {
+        return this.value;
+    }
+    /**
+     * @deprecated method, use {@link value} property instead.
+     */
+    setValue(value) {
+        this.value = value;
+    }
+    /**
+     * @deprecated method, use {@link sender} property instead.
+     */
+    getSender() {
+        return this.sender;
+    }
+    /**
+     * @deprecated method, use {@link sender} property instead.
+     */
+    setSender(sender) {
+        this.sender = sender;
+    }
+    /**
+     * @deprecated method, use {@link receiver} property instead.
+     */
+    getReceiver() {
+        return this.receiver;
+    }
+    /**
+     * @deprecated method, use {@link senderUsername} property instead.
+     */
+    getSenderUsername() {
+        return this.senderUsername;
+    }
+    /**
+     * @deprecated method, use {@link senderUsername} property instead.
+     */
+    setSenderUsername(senderUsername) {
+        this.senderUsername = senderUsername;
+    }
+    /**
+     * @deprecated method, use {@link receiverUsername} property instead.
+     */
+    getReceiverUsername() {
+        return this.receiverUsername;
+    }
+    /**
+     * @deprecated method, use {@link receiverUsername} property instead.
+     */
+    setReceiverUsername(receiverUsername) {
+        this.receiverUsername = receiverUsername;
+    }
+    /**
+     * @deprecated method, use {@link guardian} property instead.
+     */
+    getGuardian() {
+        return this.guardian;
+    }
+    /**
+     * @deprecated method, use {@link gasPrice} property instead.
+     */
+    getGasPrice() {
+        return this.gasPrice;
+    }
+    /**
+     * @deprecated method, use {@link gasPrice} property instead.
+     */
+    setGasPrice(gasPrice) {
+        this.gasPrice = gasPrice;
+    }
+    /**
+     * @deprecated method, use {@link gasLimit} property instead.
+     */
+    getGasLimit() {
+        return this.gasLimit;
+    }
+    /**
+     * @deprecated method, use {@link gasLimit} property instead.
+     */
+    setGasLimit(gasLimit) {
+        this.gasLimit = gasLimit;
+    }
+    /**
+     * @deprecated method, use {@link data} property instead.
+     */
+    getData() {
+        return this.data;
+    }
+    /**
+     * @deprecated method, use {@link chainID} property instead.
+     */
+    getChainID() {
+        return this.chainID;
+    }
+    /**
+     * @deprecated method, use {@link chainID} property instead.
+     */
+    setChainID(chainID) {
+        this.chainID = chainID;
+    }
+    /**
+     * @deprecated method, use {@link version} property instead.
+     */
+    getVersion() {
+        return this.version;
+    }
+    /**
+     * @deprecated method, use {@link version} property instead.
+     */
+    setVersion(version) {
+        this.version = version;
+    }
+    /**
+     * @deprecated method, use {@link options} property instead.
+     */
+    getOptions() {
+        return this.options;
+    }
+    /**
+     * @deprecated method, use {@link options} property instead.
+     *
+     * Question for review: check how the options are set by sdk-dapp, wallet, ledger, extension.
+     */
+    setOptions(options) {
+        this.options = options;
+    }
+    /**
+     * @deprecated method, use{@link signature} property instead.
+     */
+    getSignature() {
+        return Buffer.from(this.signature);
+    }
+    /**
+     * @deprecated method, use {@link guardianSignature} property instead.
+     */
+    getGuardianSignature() {
+        return Buffer.from(this.guardianSignature);
+    }
+    /**
+     * @deprecated method, use {@link guardian} property instead.
+     */
+    setGuardian(guardian) {
+        this.guardian = guardian;
+    }
+    /**
+     * @deprecated method, use "TransactionComputer.computeBytesForSigning()" instead.
+     * Serializes a transaction to a sequence of bytes, ready to be signed.
+     * This function is called internally by signers.
+     */
+    serializeForSigning() {
+        const computer = new transactionComputer_1.TransactionComputer();
+        const bytes = computer.computeBytesForSigning(this);
+        return Buffer.from(bytes);
+    }
+    /**
+     * Checks the integrity of the guarded transaction
+     */
+    isGuardedTransaction() {
+        const computer = new transactionComputer_1.TransactionComputer();
+        const hasGuardian = !this.guardian.isEmpty();
+        const hasGuardianSignature = this.guardianSignature.length > 0;
+        return computer.hasOptionsSetForGuardedTransaction(this) && hasGuardian && hasGuardianSignature;
+    }
+    /**
+     * Converts the transaction object into a ready-to-serialize, plain JavaScript object.
+     * This function is called internally within the signing procedure.
+     */
+    toPlainObject() {
+        const plainObject = {
+            nonce: Number(this.nonce),
+            value: this.value.toString(),
+            receiver: this.receiver.toBech32(),
+            sender: this.sender.toBech32(),
+            senderUsername: this.toBase64OrUndefined(this.senderUsername),
+            receiverUsername: this.toBase64OrUndefined(this.receiverUsername),
+            gasPrice: Number(this.gasPrice),
+            gasLimit: Number(this.gasLimit),
+            data: this.toBase64OrUndefined(this.data),
+            chainID: this.chainID.valueOf(),
+            version: this.version,
+            options: this.options == 0 ? undefined : this.options,
+            guardian: this.guardian.isEmpty() ? undefined : this.guardian.toBech32(),
+            relayer: this.relayer.isEmpty() ? undefined : this.relayer.toBech32(),
+            signature: this.toHexOrUndefined(this.signature),
+            guardianSignature: this.toHexOrUndefined(this.guardianSignature),
+            relayerSignature: this.toHexOrUndefined(this.relayerSignature),
+        };
+        return plainObject;
+    }
+    /**
+     * @deprecated method, use {@link toPlainObject} instead.
+     * Converts a plain object transaction into a Transaction Object.
+     *
+     * @param plainObjectTransaction Raw data of a transaction, usually obtained by calling toPlainObject()
+     */
+    static fromPlainObject(plainObjectTransaction) {
+        return Transaction.newFromPlainObject(plainObjectTransaction);
+    }
+    /**
+     * Converts a plain object transaction into a Transaction Object.
+     *
+     * @param plainObjectTransaction Raw data of a transaction, usually obtained by calling toPlainObject()
+     */
+    static newFromPlainObject(plainObjectTransaction) {
+        const transaction = new Transaction({
+            nonce: BigInt(plainObjectTransaction.nonce),
+            value: BigInt(plainObjectTransaction.value || ""),
+            receiver: address_1.Address.newFromBech32(plainObjectTransaction.receiver),
+            receiverUsername: Buffer.from(plainObjectTransaction.receiverUsername || "", "base64").toString(),
+            sender: address_1.Address.newFromBech32(plainObjectTransaction.sender),
+            senderUsername: Buffer.from(plainObjectTransaction.senderUsername || "", "base64").toString(),
+            guardian: plainObjectTransaction.guardian
+                ? address_1.Address.newFromBech32(plainObjectTransaction.guardian)
+                : address_1.Address.empty(),
+            relayer: plainObjectTransaction.relayer
+                ? address_1.Address.newFromBech32(plainObjectTransaction.relayer)
+                : address_1.Address.empty(),
+            gasPrice: BigInt(plainObjectTransaction.gasPrice),
+            gasLimit: BigInt(plainObjectTransaction.gasLimit),
+            data: Buffer.from(plainObjectTransaction.data || "", "base64"),
+            chainID: String(plainObjectTransaction.chainID),
+            version: Number(plainObjectTransaction.version),
+            options: plainObjectTransaction.options ? Number(plainObjectTransaction.options) : undefined,
+            signature: Buffer.from(plainObjectTransaction.signature || "", "hex"),
+            guardianSignature: Buffer.from(plainObjectTransaction.guardianSignature || "", "hex"),
+            relayerSignature: Buffer.from(plainObjectTransaction.relayerSignature || "", "hex"),
+        });
+        return transaction;
+    }
+    /**
+     * @deprecated method, use {@link signature} property instead.
+     * Applies the signature on the transaction.
+     *
+     * @param signature The signature, as computed by a signer.
+     */
+    applySignature(signature) {
+        this.signature = signature_1.interpretSignatureAsBuffer(signature);
+    }
+    /**
+     * @deprecated method, use {@link guardianSignature} property instead.
+     * Applies the guardian signature on the transaction.
+     *
+     * @param guardianSignature The signature, as computed by a signer.
+     */
+    applyGuardianSignature(guardianSignature) {
+        this.guardianSignature = signature_1.interpretSignatureAsBuffer(guardianSignature);
+    }
+    /**
+     * Converts a transaction to a ready-to-broadcast object.
+     * Called internally by the network provider.
+     */
+    toSendable() {
+        return this.toPlainObject();
+    }
+    /**
+     * @deprecated method, use "TransactionComputer.computeTransactionFee()" instead.
+     *
+     * Computes the current transaction fee based on the {@link NetworkConfig} and transaction properties
+     * @param networkConfig {@link NetworkConfig}
+     */
+    computeFee(networkConfig) {
+        const computer = new transactionComputer_1.TransactionComputer();
+        const fee = computer.computeTransactionFee(this, networkConfig);
+        return new bignumber_js_1.BigNumber(fee.toString());
+    }
+    toBase64OrUndefined(value) {
+        return value && value.length ? Buffer.from(value).toString("base64") : undefined;
+    }
+    toHexOrUndefined(value) {
+        return value && value.length ? Buffer.from(value).toString("hex") : undefined;
+    }
+}
+exports.Transaction = Transaction;
+//# sourceMappingURL=transaction.js.map

package/out/core/transaction.js.map

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

package/out/core/transactionBuilder.d.ts

@@ -0,0 +1,32 @@
+import { Address } from "./address";
+import { Transaction } from "./transaction";
+interface Config {
+    chainID: string;
+    minGasLimit: bigint;
+    gasLimitPerByte: bigint;
+}
+/**
+ * @internal
+ */
+export declare class TransactionBuilder {
+    private config;
+    private sender;
+    private receiver;
+    private dataParts;
+    private providedGasLimit;
+    private addDataMovementGas;
+    private amount?;
+    constructor(options: {
+        config: Config;
+        sender: Address;
+        receiver: Address;
+        dataParts: string[];
+        gasLimit: bigint;
+        addDataMovementGas: boolean;
+        amount?: bigint;
+    });
+    private computeGasLimit;
+    private buildTransactionPayload;
+    build(): Transaction;
+}
+export {};

package/out/core/transactionBuilder.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionBuilder = void 0;
+const constants_1 = require("./constants");
+const transaction_1 = require("./transaction");
+/**
+ * @internal
+ */
+class TransactionBuilder {
+    constructor(options) {
+        this.config = options.config;
+        this.sender = options.sender;
+        this.receiver = options.receiver;
+        this.dataParts = options.dataParts;
+        this.providedGasLimit = options.gasLimit;
+        this.addDataMovementGas = options.addDataMovementGas;
+        this.amount = options.amount;
+    }
+    computeGasLimit(payload) {
+        if (!this.addDataMovementGas) {
+            return this.providedGasLimit;
+        }
+        const dataMovementGas = this.config.minGasLimit + this.config.gasLimitPerByte * BigInt(payload.length);
+        const gasLimit = dataMovementGas + this.providedGasLimit;
+        return gasLimit;
+    }
+    buildTransactionPayload() {
+        const data = this.dataParts.join(constants_1.ARGUMENTS_SEPARATOR);
+        return Buffer.from(data);
+    }
+    build() {
+        const data = this.buildTransactionPayload();
+        const gasLimit = this.computeGasLimit(data);
+        return new transaction_1.Transaction({
+            sender: this.sender,
+            receiver: this.receiver,
+            gasLimit: gasLimit,
+            value: this.amount || 0n,
+            data: data.valueOf(),
+            chainID: this.config.chainID,
+        });
+    }
+}
+exports.TransactionBuilder = TransactionBuilder;
+//# sourceMappingURL=transactionBuilder.js.map

package/out/core/transactionBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionBuilder.js","sourceRoot":"","sources":["../../src/core/transactionBuilder.ts"],"names":[],"mappings":";;;AACA,2CAAkD;AAClD,+CAA4C;AAQ5C;;GAEG;AACH,MAAa,kBAAkB;IAS3B,YAAY,OAQX;QACG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAEO,eAAe,CAAC,OAAmB;QACvC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC1B,OAAO,IAAI,CAAC,gBAAgB,CAAC;SAChC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvG,MAAM,QAAQ,GAAG,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACzD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,uBAAuB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,+BAAmB,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE5C,OAAO,IAAI,yBAAW,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;YACpB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC/B,CAAC,CAAC;IACP,CAAC;CACJ;AAvDD,gDAuDC"}