@sravankumar02/sdk-core 1.0.0

package/out/core/smartContractQuery.d.ts

@@ -0,0 +1,35 @@
+import { Address } from "./address";
+export declare class SmartContractQuery {
+    contract: Address;
+    caller?: Address;
+    value?: bigint;
+    function: string;
+    arguments?: Uint8Array[];
+    constructor(options: {
+        contract: Address;
+        caller?: Address;
+        value?: bigint;
+        function: string;
+        arguments?: Uint8Array[];
+    });
+}
+export declare type SmartContractQueryInput = {
+    contract: Address;
+    caller?: Address;
+    value?: bigint;
+    function: string;
+    arguments: any[];
+};
+export declare class SmartContractQueryResponse {
+    function: string;
+    returnCode: string;
+    returnMessage: string;
+    returnDataParts: Uint8Array[];
+    constructor(obj: {
+        function: string;
+        returnCode: string;
+        returnMessage: string;
+        returnDataParts: Uint8Array[];
+    });
+    static fromHttpResponse(payload: any, functionName: string): SmartContractQueryResponse;
+}

package/out/core/smartContractQuery.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartContractQueryResponse = exports.SmartContractQuery = void 0;
+class SmartContractQuery {
+    constructor(options) {
+        this.contract = options.contract;
+        this.caller = options.caller;
+        this.value = options.value;
+        this.function = options.function;
+        this.arguments = options.arguments;
+    }
+}
+exports.SmartContractQuery = SmartContractQuery;
+class SmartContractQueryResponse {
+    constructor(obj) {
+        this.function = obj.function;
+        this.returnCode = obj.returnCode;
+        this.returnMessage = obj.returnMessage;
+        this.returnDataParts = obj.returnDataParts;
+    }
+    static fromHttpResponse(payload, functionName) {
+        let returnData = payload["returnData"] || payload["ReturnData"];
+        let returnCode = payload["returnCode"] || payload["ReturnCode"];
+        let returnMessage = payload["returnMessage"] || payload["ReturnMessage"];
+        return new SmartContractQueryResponse({
+            returnDataParts: returnData?.map((item) => Buffer.from(item || "", "base64")) ?? [],
+            returnCode: returnCode,
+            returnMessage: returnMessage,
+            function: functionName,
+        });
+    }
+}
+exports.SmartContractQueryResponse = SmartContractQueryResponse;
+//# sourceMappingURL=smartContractQuery.js.map

package/out/core/smartContractQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartContractQuery.js","sourceRoot":"","sources":["../../src/core/smartContractQuery.ts"],"names":[],"mappings":";;;AAEA,MAAa,kBAAkB;IAO3B,YAAY,OAMX;QACG,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACvC,CAAC;CACJ;AApBD,gDAoBC;AAUD,MAAa,0BAA0B;IAMnC,YAAY,GAAmG;QAC3G,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,OAAY,EAAE,YAAoB;QACtD,IAAI,UAAU,GAAa,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1E,IAAI,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;QAChE,IAAI,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzE,OAAO,IAAI,0BAA0B,CAAC;YAClC,eAAe,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;YACnF,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,YAAY;SACzB,CAAC,CAAC;IACP,CAAC;CACJ;AAzBD,gEAyBC"}

package/out/core/tokenTransfersDataBuilder.d.ts

@@ -0,0 +1,10 @@
+import { Address } from "./address";
+import { TokenTransfer } from "./tokens";
+export declare class TokenTransfersDataBuilder {
+    private tokenComputer;
+    private argsSerializer;
+    constructor();
+    buildDataPartsForDCDTTransfer(transfer: TokenTransfer): string[];
+    buildDataPartsForSingleDCDTNFTTransfer(transfer: TokenTransfer, receiver: Address): string[];
+    buildDataPartsForMultiDCDTNFTTransfer(receiver: Address, transfers: TokenTransfer[]): string[];
+}

package/out/core/tokenTransfersDataBuilder.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenTransfersDataBuilder = void 0;
+const abi_1 = require("../abi");
+const tokens_1 = require("./tokens");
+class TokenTransfersDataBuilder {
+    constructor() {
+        this.tokenComputer = new tokens_1.TokenComputer();
+        this.argsSerializer = new abi_1.ArgSerializer();
+    }
+    buildDataPartsForDCDTTransfer(transfer) {
+        const args = this.argsSerializer.valuesToStrings([
+            new abi_1.TokenIdentifierValue(transfer.token.identifier),
+            new abi_1.BigUIntValue(transfer.amount),
+        ]);
+        return ["DCDTTransfer", ...args];
+    }
+    buildDataPartsForSingleDCDTNFTTransfer(transfer, receiver) {
+        const token = transfer.token;
+        const identifier = this.tokenComputer.extractIdentifierFromExtendedIdentifier(token.identifier);
+        const args = this.argsSerializer.valuesToStrings([
+            new abi_1.TokenIdentifierValue(identifier),
+            new abi_1.BigUIntValue(token.nonce),
+            new abi_1.BigUIntValue(transfer.amount),
+            new abi_1.AddressValue(receiver),
+        ]);
+        return ["DCDTNFTTransfer", ...args];
+    }
+    buildDataPartsForMultiDCDTNFTTransfer(receiver, transfers) {
+        const argsTyped = [new abi_1.AddressValue(receiver), new abi_1.U32Value(transfers.length)];
+        for (const transfer of transfers) {
+            const identifier = this.tokenComputer.extractIdentifierFromExtendedIdentifier(transfer.token.identifier);
+            argsTyped.push(...[
+                new abi_1.TokenIdentifierValue(identifier),
+                new abi_1.BigUIntValue(transfer.token.nonce),
+                new abi_1.BigUIntValue(transfer.amount),
+            ]);
+        }
+        const args = this.argsSerializer.valuesToStrings(argsTyped);
+        return ["MultiDCDTNFTTransfer", ...args];
+    }
+}
+exports.TokenTransfersDataBuilder = TokenTransfersDataBuilder;
+//# sourceMappingURL=tokenTransfersDataBuilder.js.map

package/out/core/tokenTransfersDataBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenTransfersDataBuilder.js","sourceRoot":"","sources":["../../src/core/tokenTransfersDataBuilder.ts"],"names":[],"mappings":";;;AAAA,gCAA+G;AAE/G,qCAAwD;AAExD,MAAa,yBAAyB;IAIlC;QACI,IAAI,CAAC,aAAa,GAAG,IAAI,sBAAa,EAAE,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAa,EAAE,CAAC;IAC9C,CAAC;IAED,6BAA6B,CAAC,QAAuB;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;YAC7C,IAAI,0BAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;YACnD,IAAI,kBAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,sCAAsC,CAAC,QAAuB,EAAE,QAAiB;QAC7E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAEhG,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;YAC7C,IAAI,0BAAoB,CAAC,UAAU,CAAC;YACpC,IAAI,kBAAY,CAAC,KAAK,CAAC,KAAK,CAAC;YAC7B,IAAI,kBAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;YACjC,IAAI,kBAAY,CAAC,QAAQ,CAAC;SAC7B,CAAC,CAAC;QAEH,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,qCAAqC,CAAC,QAAiB,EAAE,SAA0B;QAC/E,MAAM,SAAS,GAAiB,CAAC,IAAI,kBAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,cAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAE7F,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEzG,SAAS,CAAC,IAAI,CACV,GAAG;gBACC,IAAI,0BAAoB,CAAC,UAAU,CAAC;gBACpC,IAAI,kBAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;gBACtC,IAAI,kBAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;aACpC,CACJ,CAAC;SACL;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;CACJ;AAlDD,8DAkDC"}

package/out/core/tokens.d.ts

@@ -0,0 +1,130 @@
+import BigNumber from "bignumber.js";
+interface ILegacyTokenTransferOptions {
+    tokenIdentifier: string;
+    nonce: number;
+    amountAsBigInteger: BigNumber.Value;
+    numDecimals?: number;
+}
+export declare type TokenType = "NFT" | "SFT" | "META" | "FNG";
+export declare class Token {
+    /**
+     * E.g. "FOO-abcdef", "REWA-000000".
+     */
+    readonly identifier: string;
+    readonly nonce: bigint;
+    constructor(options: {
+        identifier: string;
+        nonce?: bigint;
+    });
+}
+export declare class TokenTransfer {
+    readonly token: Token;
+    readonly amount: bigint;
+    /**
+     * @deprecated field. Use "token.identifier" instead.
+     */
+    readonly tokenIdentifier: string;
+    /**
+     * @deprecated field. Use "token.nonce" instead.
+     */
+    readonly nonce: number;
+    /**
+     * @deprecated field. Use "amount" instead.
+     */
+    readonly amountAsBigInteger: BigNumber;
+    /**
+     * @deprecated field. The number of decimals is not a concern of "sdk-core".
+     * For formatting and parsing amounts, use "sdk-dapp" or "bignumber.js" directly.
+     */
+    readonly numDecimals: number;
+    constructor(options: {
+        token: Token;
+        amount: bigint;
+    } | ILegacyTokenTransferOptions);
+    /**     *
+     * @param amount
+     * @returns @TokenTransfer from native token
+     */
+    static newFromNativeAmount(amount: bigint): TokenTransfer;
+    private isLegacyTokenTransferOptions;
+    /**
+     * @deprecated Use {@link newFromNativeAmount} instead.
+     */
+    static rewaFromAmount(amount: BigNumber.Value): TokenTransfer;
+    /**
+     * @deprecated Use {@link newFromNativeAmount} instead.
+     */
+    static rewaFromBigInteger(amountAsBigInteger: BigNumber.Value): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static fungibleFromAmount(tokenIdentifier: string, amount: BigNumber.Value, numDecimals: number): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static fungibleFromBigInteger(tokenIdentifier: string, amountAsBigInteger: BigNumber.Value, numDecimals?: number): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static nonFungible(tokenIdentifier: string, nonce: number): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static semiFungible(tokenIdentifier: string, nonce: number, quantity: number): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static metaDcdtFromAmount(tokenIdentifier: string, nonce: number, amount: BigNumber.Value, numDecimals: number): TokenTransfer;
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static metaDcdtFromBigInteger(tokenIdentifier: string, nonce: number, amountAsBigInteger: BigNumber.Value, numDecimals?: number): TokenTransfer;
+    toString(): string;
+    /**
+     * @deprecated Use the "amount" field instead.
+     */
+    valueOf(): BigNumber;
+    /**
+     * @deprecated For formatting and parsing amounts, use "sdk-dapp" or "bignumber.js" directly.
+     */
+    toPrettyString(): string;
+    private toAmount;
+    /**
+     * @deprecated Within your code, don't mix native values (REWA) and custom (DCDT) tokens.
+     * See "TransferTransactionsFactory.createTransactionForNativeTokenTransfer()" vs. "TransferTransactionsFactory.createTransactionForDCDTTokenTransfer()".
+     */
+    isRewa(): boolean;
+    /**
+     * @deprecated Use "TokenComputer.isFungible(token)" instead.
+     */
+    isFungible(): boolean;
+}
+export declare class TokenComputer {
+    TOKEN_RANDOM_SEQUENCE_LENGTH: number;
+    constructor();
+    /**
+     * Returns token.nonce == 0
+     */
+    isFungible(token: Token): boolean;
+    /**
+     * Given "FOO-abcdef-0a" returns 10.
+     */
+    extractNonceFromExtendedIdentifier(identifier: string): number;
+    /**
+     * Given "FOO-abcdef-0a" returns FOO-abcdef.
+     */
+    extractIdentifierFromExtendedIdentifier(identifier: string): string;
+    /**
+     * Given "FOO-abcdef-0a" returns FOO.
+     * Given "FOO-abcdef" returns FOO.
+     */
+    extractTickerFromExtendedIdentifier(identifier: string): string;
+    computeExtendedIdentifier(token: Token): string;
+    private validateExtendedIdentifier;
+    private splitIdentifierIntoComponents;
+    private checkIfExtendedIdentifierWasProvided;
+    private checkLengthOfRandomSequence;
+    private checkLengthOfPrefix;
+    private ensureTokenTickerValidity;
+}
+export {};

package/out/core/tokens.js

@@ -0,0 +1,287 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenComputer = exports.TokenTransfer = exports.Token = void 0;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const utils_codec_1 = require("./utils.codec");
+// Legacy constants:
+const REWATokenIdentifier = "REWA";
+const REWANumDecimals = 18;
+// Legacy configuration.
+// Note: this will actually set the default rounding mode for all BigNumber objects in the environment (in the application / dApp).
+bignumber_js_1.default.set({ ROUNDING_MODE: 1 });
+class Token {
+    constructor(options) {
+        this.identifier = options.identifier;
+        this.nonce = options.nonce || 0n;
+    }
+}
+exports.Token = Token;
+class TokenTransfer {
+    constructor(options) {
+        if (this.isLegacyTokenTransferOptions(options)) {
+            // Handle legacy fields.
+            const amount = new bignumber_js_1.default(options.amountAsBigInteger);
+            if (!amount.isInteger() || amount.isNegative()) {
+                throw new errors_1.ErrInvalidArgument(`bad amountAsBigInteger: ${options.amountAsBigInteger}`);
+            }
+            this.tokenIdentifier = options.tokenIdentifier;
+            this.nonce = options.nonce;
+            this.amountAsBigInteger = amount;
+            this.numDecimals = options.numDecimals || 0;
+            // Handle new fields.
+            this.token = new Token({
+                identifier: options.tokenIdentifier,
+                nonce: BigInt(options.nonce),
+            });
+            this.amount = BigInt(this.amountAsBigInteger.toFixed(0));
+        }
+        else {
+            // Handle new fields.
+            this.token = options.token;
+            this.amount = options.amount;
+            // Handle legacy fields.
+            this.tokenIdentifier = options.token.identifier;
+            this.nonce = Number(options.token.nonce);
+            this.amountAsBigInteger = new bignumber_js_1.default(this.amount.toString());
+            this.numDecimals = 0;
+        }
+    }
+    /**     *
+     * @param amount
+     * @returns @TokenTransfer from native token
+     */
+    static newFromNativeAmount(amount) {
+        const token = new Token({ identifier: constants_1.REWA_IDENTIFIER_FOR_MULTI_DCDTNFT_TRANSFER });
+        return new TokenTransfer({ token, amount });
+    }
+    isLegacyTokenTransferOptions(options) {
+        return options.tokenIdentifier !== undefined;
+    }
+    /**
+     * @deprecated Use {@link newFromNativeAmount} instead.
+     */
+    static rewaFromAmount(amount) {
+        const amountAsBigInteger = new bignumber_js_1.default(amount).shiftedBy(REWANumDecimals).decimalPlaces(0);
+        return this.rewaFromBigInteger(amountAsBigInteger);
+    }
+    /**
+     * @deprecated Use {@link newFromNativeAmount} instead.
+     */
+    static rewaFromBigInteger(amountAsBigInteger) {
+        return new TokenTransfer({
+            tokenIdentifier: REWATokenIdentifier,
+            nonce: 0,
+            amountAsBigInteger,
+            numDecimals: REWANumDecimals,
+        });
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static fungibleFromAmount(tokenIdentifier, amount, numDecimals) {
+        const amountAsBigInteger = new bignumber_js_1.default(amount).shiftedBy(numDecimals).decimalPlaces(0);
+        return this.fungibleFromBigInteger(tokenIdentifier, amountAsBigInteger, numDecimals);
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static fungibleFromBigInteger(tokenIdentifier, amountAsBigInteger, numDecimals = 0) {
+        return new TokenTransfer({
+            tokenIdentifier,
+            nonce: 0,
+            amountAsBigInteger,
+            numDecimals,
+        });
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static nonFungible(tokenIdentifier, nonce) {
+        return new TokenTransfer({
+            tokenIdentifier,
+            nonce,
+            amountAsBigInteger: 1,
+            numDecimals: 0,
+        });
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static semiFungible(tokenIdentifier, nonce, quantity) {
+        return new TokenTransfer({
+            tokenIdentifier,
+            nonce,
+            amountAsBigInteger: quantity,
+            numDecimals: 0,
+        });
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static metaDcdtFromAmount(tokenIdentifier, nonce, amount, numDecimals) {
+        const amountAsBigInteger = new bignumber_js_1.default(amount).shiftedBy(numDecimals).decimalPlaces(0);
+        return this.metaDcdtFromBigInteger(tokenIdentifier, nonce, amountAsBigInteger, numDecimals);
+    }
+    /**
+     * @deprecated Use the constructor instead: new TokenTransfer({ token, amount });
+     */
+    static metaDcdtFromBigInteger(tokenIdentifier, nonce, amountAsBigInteger, numDecimals = 0) {
+        return new TokenTransfer({
+            tokenIdentifier,
+            nonce,
+            amountAsBigInteger,
+            numDecimals,
+        });
+    }
+    toString() {
+        return this.amount.toString();
+    }
+    /**
+     * @deprecated Use the "amount" field instead.
+     */
+    valueOf() {
+        return new bignumber_js_1.default(this.amount.toString());
+    }
+    /**
+     * @deprecated For formatting and parsing amounts, use "sdk-dapp" or "bignumber.js" directly.
+     */
+    toPrettyString() {
+        return `${this.toAmount()} ${this.tokenIdentifier}`;
+    }
+    toAmount() {
+        return this.amountAsBigInteger.shiftedBy(-this.numDecimals).toFixed(this.numDecimals);
+    }
+    /**
+     * @deprecated Within your code, don't mix native values (REWA) and custom (DCDT) tokens.
+     * See "TransferTransactionsFactory.createTransactionForNativeTokenTransfer()" vs. "TransferTransactionsFactory.createTransactionForDCDTTokenTransfer()".
+     */
+    isRewa() {
+        return this.token.identifier == REWATokenIdentifier;
+    }
+    /**
+     * @deprecated Use "TokenComputer.isFungible(token)" instead.
+     */
+    isFungible() {
+        return this.token.nonce == 0n;
+    }
+}
+exports.TokenTransfer = TokenTransfer;
+class TokenComputer {
+    constructor() {
+        this.TOKEN_RANDOM_SEQUENCE_LENGTH = 6;
+    }
+    /**
+     * Returns token.nonce == 0
+     */
+    isFungible(token) {
+        return token.nonce === 0n;
+    }
+    /**
+     * Given "FOO-abcdef-0a" returns 10.
+     */
+    extractNonceFromExtendedIdentifier(identifier) {
+        const parts = identifier.split("-");
+        const { prefix, ticker, randomSequence } = this.splitIdentifierIntoComponents(parts);
+        this.validateExtendedIdentifier(prefix, ticker, randomSequence, parts);
+        // If identifier is for a fungible token (2 parts or 3 with prefix), return 0
+        if (parts.length === 2 || (prefix && parts.length === 3)) {
+            return 0;
+        }
+        // Otherwise, decode the last part as an unsigned number
+        const hexNonce = parts[parts.length - 1];
+        return decodeUnsignedNumber(Buffer.from(hexNonce, "hex"));
+    }
+    /**
+     * Given "FOO-abcdef-0a" returns FOO-abcdef.
+     */
+    extractIdentifierFromExtendedIdentifier(identifier) {
+        const parts = identifier.split("-");
+        const { prefix, ticker, randomSequence } = this.splitIdentifierIntoComponents(parts);
+        this.validateExtendedIdentifier(prefix, ticker, randomSequence, parts);
+        if (prefix) {
+            this.checkLengthOfPrefix(prefix);
+            return prefix + "-" + ticker + "-" + randomSequence;
+        }
+        return ticker + "-" + randomSequence;
+    }
+    /**
+     * Given "FOO-abcdef-0a" returns FOO.
+     * Given "FOO-abcdef" returns FOO.
+     */
+    extractTickerFromExtendedIdentifier(identifier) {
+        const parts = identifier.split("-");
+        const { prefix, ticker, randomSequence } = this.splitIdentifierIntoComponents(parts);
+        this.validateExtendedIdentifier(prefix, ticker, randomSequence, parts);
+        if (prefix) {
+            this.checkLengthOfPrefix(prefix);
+            return prefix + "-" + ticker + "-" + randomSequence;
+        }
+        return ticker;
+    }
+    computeExtendedIdentifier(token) {
+        const parts = token.identifier.split("-");
+        const { prefix, ticker, randomSequence } = this.splitIdentifierIntoComponents(parts);
+        this.validateExtendedIdentifier(prefix, ticker, randomSequence, parts);
+        if (token.nonce < 0) {
+            throw new Error("The token nonce can't be less than 0");
+        }
+        if (token.nonce === 0n) {
+            return token.identifier;
+        }
+        const nonceAsHex = utils_codec_1.numberToPaddedHex(token.nonce);
+        return `${token.identifier}-${nonceAsHex}`;
+    }
+    validateExtendedIdentifier(prefix, ticker, randomSequence, parts) {
+        this.checkIfExtendedIdentifierWasProvided(prefix, parts);
+        this.ensureTokenTickerValidity(ticker);
+        this.checkLengthOfRandomSequence(randomSequence);
+    }
+    splitIdentifierIntoComponents(parts) {
+        if (parts.length >= 3 && parts[2].length === this.TOKEN_RANDOM_SEQUENCE_LENGTH) {
+            return { prefix: parts[0], ticker: parts[1], randomSequence: parts[2] };
+        }
+        return { prefix: null, ticker: parts[0], randomSequence: parts[1] };
+    }
+    checkIfExtendedIdentifierWasProvided(prefix, tokenParts) {
+        //  this is for the identifiers of fungible tokens
+        const MIN_EXTENDED_IDENTIFIER_LENGTH_IF_SPLITTED = 2;
+        //  this is for the identifiers of nft, sft and meta-dcdt
+        const MAX_EXTENDED_IDENTIFIER_LENGTH_IF_SPLITTED = prefix ? 4 : 3;
+        if (tokenParts.length < MIN_EXTENDED_IDENTIFIER_LENGTH_IF_SPLITTED ||
+            tokenParts.length > MAX_EXTENDED_IDENTIFIER_LENGTH_IF_SPLITTED) {
+            throw new errors_1.ErrInvalidTokenIdentifier("Invalid extended token identifier provided");
+        }
+    }
+    checkLengthOfRandomSequence(randomSequence) {
+        if (randomSequence.length !== this.TOKEN_RANDOM_SEQUENCE_LENGTH) {
+            throw new errors_1.ErrInvalidTokenIdentifier("The identifier is not valid. The random sequence does not have the right length");
+        }
+    }
+    checkLengthOfPrefix(prefix) {
+        const MAX_TOKEN_PREFIX_LENGTH = 4;
+        const MIN_TOKEN_PREFIX_LENGTH = 1;
+        if (prefix.length < MIN_TOKEN_PREFIX_LENGTH || prefix.length > MAX_TOKEN_PREFIX_LENGTH) {
+            throw new errors_1.ErrInvalidTokenIdentifier("The identifier is not valid. The prefix does not have the right length");
+        }
+    }
+    ensureTokenTickerValidity(ticker) {
+        const MIN_TICKER_LENGTH = 3;
+        const MAX_TICKER_LENGTH = 10;
+        if (ticker.length < MIN_TICKER_LENGTH || ticker.length > MAX_TICKER_LENGTH) {
+            throw new errors_1.ErrInvalidTokenIdentifier(`The token ticker should be between ${MIN_TICKER_LENGTH} and ${MAX_TICKER_LENGTH} characters`);
+        }
+        if (!ticker.match(/^[a-zA-Z0-9]+$/)) {
+            throw new errors_1.ErrInvalidTokenIdentifier("The token ticker should only contain alphanumeric characters");
+        }
+    }
+}
+exports.TokenComputer = TokenComputer;
+function decodeUnsignedNumber(arg) {
+    return arg.readUIntBE(0, arg.length);
+}
+//# sourceMappingURL=tokens.js.map

package/out/core/tokens.js.map

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