@koralabs/kora-labs-common 4.4.8 → 5.0.0

package/constants/index.d.ts

@@ -1,4 +1,5 @@
 export declare const IS_SERVER: boolean;
+export declare const NETWORK: string;
 export declare const IS_PRODUCTION: boolean;
 export declare const AUTH_GRANT_DURATION: number;
 export declare const TOU_URL = "https://handle.me/$/tou";

package/constants/index.js

@@ -1,10 +1,11 @@
 "use strict";
-var _a, _b;
+var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOU_URL = exports.AUTH_GRANT_DURATION = exports.IS_PRODUCTION = exports.IS_SERVER = void 0;
+exports.TOU_URL = exports.AUTH_GRANT_DURATION = exports.IS_PRODUCTION = exports.NETWORK = exports.IS_SERVER = void 0;
 exports.IS_SERVER = typeof process !== 'undefined' && typeof process.versions.node !== 'undefined';
+exports.NETWORK = (_b = (_a = process.env.NETWORK) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : 'preview';
 exports.IS_PRODUCTION = exports.IS_SERVER
-    ? ((_a = process.env.NODE_ENV) === null || _a === void 0 ? void 0 : _a.trim()) === 'production' && ((_b = process.env.NETWORK) === null || _b === void 0 ? void 0 : _b.toLowerCase()) == 'mainnet'
+    ? ((_c = process.env.NODE_ENV) === null || _c === void 0 ? void 0 : _c.trim()) === 'production' && exports.NETWORK == 'mainnet'
     : !(window.location.host.includes('preview.') ||
         window.location.host.includes('preprod.') ||
         window.location.host.includes('localhost'));

package/errors/index.d.ts

@@ -2,3 +2,12 @@ export declare class OauthAccessError extends Error {
     oauthErrorCode: string;
     constructor(message: string, oauthErrorCode: 'invalid_request' | 'invalid_client' | 'invalid_grant' | 'unauthorized_client' | 'unsupported_grant_type' | 'invalid_scope');
 }
+export declare class ModelException extends Error {
+    message: string;
+    constructor(message: string);
+}
+export declare class HttpException extends Error {
+    status: number;
+    message: string;
+    constructor(status: number, message: string);
+}

package/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OauthAccessError = void 0;
+exports.HttpException = exports.ModelException = exports.OauthAccessError = void 0;
 class OauthAccessError extends Error {
     constructor(message, oauthErrorCode) {
         super();
@@ -9,3 +9,18 @@ class OauthAccessError extends Error {
     }
 }
 exports.OauthAccessError = OauthAccessError;
+class ModelException extends Error {
+    constructor(message) {
+        super(message);
+        this.message = message;
+    }
+}
+exports.ModelException = ModelException;
+class HttpException extends Error {
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.message = message;
+    }
+}
+exports.HttpException = HttpException;

package/handles/constants.d.ts

@@ -11,3 +11,12 @@ export declare const REGEX_HANDLE: RegExp;
 export declare const REGEX_SUB_HANDLE: RegExp;
 export declare const HANDLES_API_KEY: string;
 export declare const KORA_USER_AGENT: string;
+export declare enum ERROR_TEXT {
+    HANDLE_LIMIT_EXCEEDED = "'records_per_page' must be a number",
+    HANDLE_LIMIT_INVALID_FORMAT = "'records_per_page' can't be more than 1000",
+    HANDLE_SORT_INVALID = "'sort' must be 'desc' or 'asc'",
+    HANDLE_PAGE_INVALID = "'page' must be a number",
+    HANDLE_SLOT_NUMBER_INVALID = "'slot_number' must be a number",
+    HANDLE_PAGE_AND_SLOT_NUMBER_INVALID = "'page' and 'slot_number' can't be used together"
+}
+export declare const HANDLES_PER_PAGE_MAX = 1000;

package/handles/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KORA_USER_AGENT = exports.HANDLES_API_KEY = exports.REGEX_SUB_HANDLE = exports.REGEX_HANDLE = exports.REGEX_SPLIT_ON_NUMS = exports.REGEX_SPLIT_ON_CHARS = exports.RESPONSE_NOT_ALLOWED = exports.RESPONSE_INVALID_HANDLE_FORMAT = exports.RESPONSE_UNAVAILABLE_LEGENDARY = exports.RESPONSE_UNAVAILABLE_RESERVED = exports.RESPONSE_UNAVAILABLE_ACTIVE_SESSION = exports.RESPONSE_UNAVAILABLE_PAID = exports.RESPONSE_AVAILABLE = void 0;
+exports.HANDLES_PER_PAGE_MAX = exports.ERROR_TEXT = exports.KORA_USER_AGENT = exports.HANDLES_API_KEY = exports.REGEX_SUB_HANDLE = exports.REGEX_HANDLE = exports.REGEX_SPLIT_ON_NUMS = exports.REGEX_SPLIT_ON_CHARS = exports.RESPONSE_NOT_ALLOWED = exports.RESPONSE_INVALID_HANDLE_FORMAT = exports.RESPONSE_UNAVAILABLE_LEGENDARY = exports.RESPONSE_UNAVAILABLE_RESERVED = exports.RESPONSE_UNAVAILABLE_ACTIVE_SESSION = exports.RESPONSE_UNAVAILABLE_PAID = exports.RESPONSE_AVAILABLE = void 0;
 const constants_1 = require("../constants");
 exports.RESPONSE_AVAILABLE = 'Yay! This handle is available.';
 exports.RESPONSE_UNAVAILABLE_PAID = 'Sorry! This Handle is pending mint or already minted.';
@@ -16,3 +16,13 @@ exports.REGEX_HANDLE = new RegExp(/^[a-zA-Z0-9_.-]{1,15}$/);
 exports.REGEX_SUB_HANDLE = new RegExp(/(?:^[a-z0-9_.-]{1,15}$)|(?:^(?!.{29})[a-z0-9_.-]+@[a-z0-9_.-]{1,15}$)/g);
 exports.HANDLES_API_KEY = constants_1.IS_PRODUCTION ? (_a = process.env.HANDLES_API_KEY) !== null && _a !== void 0 ? _a : '' : '';
 exports.KORA_USER_AGENT = (_b = process.env.KORA_USER_AGENT) !== null && _b !== void 0 ? _b : '';
+var ERROR_TEXT;
+(function (ERROR_TEXT) {
+    ERROR_TEXT["HANDLE_LIMIT_EXCEEDED"] = "'records_per_page' must be a number";
+    ERROR_TEXT["HANDLE_LIMIT_INVALID_FORMAT"] = "'records_per_page' can't be more than 1000";
+    ERROR_TEXT["HANDLE_SORT_INVALID"] = "'sort' must be 'desc' or 'asc'";
+    ERROR_TEXT["HANDLE_PAGE_INVALID"] = "'page' must be a number";
+    ERROR_TEXT["HANDLE_SLOT_NUMBER_INVALID"] = "'slot_number' must be a number";
+    ERROR_TEXT["HANDLE_PAGE_AND_SLOT_NUMBER_INVALID"] = "'page' and 'slot_number' can't be used together";
+})(ERROR_TEXT = exports.ERROR_TEXT || (exports.ERROR_TEXT = {}));
+exports.HANDLES_PER_PAGE_MAX = 1000;

package/handles/index.d.ts

@@ -1,7 +1,8 @@
 export * from './interfaces';
+export * from './interfaces/api';
+export * from './interfaces/handlesRepository';
 export * from './constants';
 export * from './api';
 export * from './policies';
-export { getRarity } from './getRarity';
-export { buildMetadata } from './buildMetadata';
-export { checkHandlePattern } from './validation';
+export * from './utils';
+export * from './models';

package/handles/index.js

@@ -14,14 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkHandlePattern = exports.buildMetadata = exports.getRarity = void 0;
 __exportStar(require("./interfaces"), exports);
+__exportStar(require("./interfaces/api"), exports);
+__exportStar(require("./interfaces/handlesRepository"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./api"), exports);
 __exportStar(require("./policies"), exports);
-var getRarity_1 = require("./getRarity");
-Object.defineProperty(exports, "getRarity", { enumerable: true, get: function () { return getRarity_1.getRarity; } });
-var buildMetadata_1 = require("./buildMetadata");
-Object.defineProperty(exports, "buildMetadata", { enumerable: true, get: function () { return buildMetadata_1.buildMetadata; } });
-var validation_1 = require("./validation");
-Object.defineProperty(exports, "checkHandlePattern", { enumerable: true, get: function () { return validation_1.checkHandlePattern; } });
+__exportStar(require("./utils"), exports);
+__exportStar(require("./models"), exports);

package/handles/interfaces/api.d.ts

@@ -0,0 +1,124 @@
+import { IPersonalization, IPersonalizedHandle, IHandleMetadata, IUTxO, IReferenceToken, HandleType, ISubHandleSettings, IPzDatumConvertedUsingSchema } from '.';
+export interface SubHandleSettings {
+    settings: ISubHandleSettings;
+    utxo: IUTxO;
+}
+export interface StoredHandle extends IPersonalizedHandle {
+    amount: number;
+    default?: boolean;
+    pz_enabled?: boolean;
+    resolved_addresses: {
+        ada: string;
+        [key: string]: string;
+    };
+    payment_key_hash: string;
+    subhandle_settings?: {
+        settings?: string;
+        utxo: IUTxO;
+    };
+    sub_rarity?: string;
+    sub_length?: number;
+    sub_characters?: string;
+    sub_numeric_modifiers?: string;
+    virtual?: {
+        expires_time: number;
+        public_mint: boolean;
+    };
+    original_address?: string;
+}
+export interface HandleHistory {
+    old: Partial<StoredHandle> | null;
+    new?: Partial<StoredHandle> | null;
+}
+export interface ISlotHistoryIndex {
+    [handleHex: string]: HandleHistory;
+}
+export interface IHandleStoreMetrics {
+    firstSlot?: number;
+    lastSlot?: number;
+    currentSlot?: number;
+    elapsedOgmiosExec?: number;
+    elapsedBuildingExec?: number;
+    firstMemoryUsage?: number;
+    currentBlockHash?: string;
+    tipBlockHash?: string;
+    memorySize?: number;
+    networkSync?: number;
+}
+export interface SaveMintingTxInput {
+    hex: string;
+    name: string;
+    adaAddress: string;
+    og_number: number;
+    image: string;
+    image_hash?: string;
+    slotNumber: number;
+    utxo: string;
+    lovelace: number;
+    svg_version?: string;
+    bg_image?: string;
+    pfp_image?: string;
+    datum?: string;
+    script?: {
+        type: string;
+        cbor: string;
+    };
+    last_update_address?: string;
+    personalization?: IPersonalization;
+    reference_token?: IReferenceToken;
+    resolved_addresses?: Record<string, string>;
+    amount?: number;
+    version?: number;
+    handle_type: HandleType;
+    sub_rarity?: string;
+    sub_length?: number;
+    sub_characters?: string;
+    sub_numeric_modifiers?: string;
+    virtual?: {
+        expires_time: number;
+        public_mint: boolean;
+    };
+    original_address?: string;
+    pz_enabled?: boolean;
+}
+export interface SaveWalletAddressMoveInput {
+    slotNumber: number;
+    name: string;
+    adaAddress: string;
+    utxo: string;
+    datum?: string;
+    script?: {
+        type: string;
+        cbor: string;
+    };
+}
+export interface SavePersonalizationInput {
+    slotNumber: number;
+    hex: string;
+    name: string;
+    personalization: IPersonalization;
+    reference_token: IReferenceToken;
+    personalizationDatum: IPzDatumConvertedUsingSchema | null;
+    metadata: IHandleMetadata | null;
+}
+export interface SaveSubHandleSettingsInput {
+    name: string;
+    settingsDatum?: string;
+    utxoDetails: IUTxO;
+    slotNumber: number;
+}
+export interface HolderAddressIndex {
+    handles: Set<string>;
+    defaultHandle: string;
+    manuallySet: boolean;
+    type: string;
+    knownOwnerName: string;
+}
+export interface HolderAddressDetails {
+    total_handles: number;
+    address: string;
+    type: string;
+    known_owner_name: string;
+    default_handle: string;
+    manually_set: boolean;
+}

package/handles/interfaces/api.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/handles/interfaces/handlesRepository.d.ts

@@ -0,0 +1,65 @@
+import { IHandleStats, IUTxO } from '..';
+import { HolderAddressDetails } from './api';
+import { HandlePaginationModel } from '../models/handlePagination.model';
+import { HandleSearchModel } from '../models/handleSearch.model';
+import { HolderPaginationModel } from '../models/holderPagination.model';
+import { IHandleStoreMetrics, SaveMintingTxInput, SavePersonalizationInput, SaveSubHandleSettingsInput, SaveWalletAddressMoveInput, StoredHandle } from './api';
+export interface IHandlesRepository {
+    initialize: () => Promise<IHandlesRepository>;
+    getAll: (params: {
+        pagination: HandlePaginationModel;
+        search: HandleSearchModel;
+    }) => Promise<{
+        searchTotal: number;
+        handles: StoredHandle[];
+    }>;
+    getHandlesByPaymentKeyHashes: (hashes: string[]) => string[];
+    getHandlesByAddresses: (addresses: string[]) => string[];
+    getHandlesByHolderAddresses: (addresses: string[]) => string[];
+    getAllHandleNames: (search: HandleSearchModel, sort: string) => Promise<string[]>;
+    getHandleByName: (handleName: string) => Promise<StoredHandle | null>;
+    getHandleByHex: (handleHex: string) => Promise<StoredHandle | null>;
+    getHolderAddressDetails: (key: string) => Promise<HolderAddressDetails>;
+    getAllHolders: (params: {
+        pagination: HolderPaginationModel;
+    }) => Promise<HolderAddressDetails[]>;
+    getHandleStats: () => IHandleStats;
+    getTotalHandlesStats: () => {
+        total_handles: number;
+        total_holders: number;
+    };
+    currentHttpStatus: () => number;
+    getHandleDatumByName: (handleName: string) => Promise<string | null>;
+    getSubHandleSettings: (handleName: string) => Promise<{
+        settings?: string;
+        utxo: IUTxO;
+    } | null>;
+    getSubHandles: (handleName: string) => Promise<StoredHandle[]>;
+    getTimeMetrics: () => {
+        elapsedOgmiosExec: number;
+        elapsedBuildingExec: number;
+    };
+    setMetrics: (metrics: IHandleStoreMetrics) => void;
+    getMetrics: () => IHandleStats;
+    prepareHandlesStorage: (loadS3: boolean) => Promise<{
+        slot: number;
+        hash: string;
+    } | null>;
+    rollBackToGenesis: () => Promise<void>;
+    isCaughtUp: () => boolean;
+    burnHandle: (handleName: string, slotNumber: number) => Promise<void>;
+    rewindChangesToSlot: ({ slot, hash, lastSlot }: {
+        slot: number;
+        hash: string;
+        lastSlot: number;
+    }) => Promise<{
+        name: string;
+        action: string;
+        handle: Partial<StoredHandle> | undefined;
+    }[]>;
+    savePersonalizationChange: ({ name, hex, personalization, reference_token, personalizationDatum, slotNumber, metadata }: SavePersonalizationInput) => Promise<void>;
+    saveSubHandleSettingsChange: ({ name, settingsDatum, utxoDetails, slotNumber }: SaveSubHandleSettingsInput) => Promise<void>;
+    saveMintedHandle: (input: SaveMintingTxInput) => Promise<void>;
+    saveHandleUpdate: ({ name, adaAddress, utxo, slotNumber, datum, script }: SaveWalletAddressMoveInput) => Promise<void>;
+    destroy: () => void;
+}

package/handles/interfaces/handlesRepository.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/handles/{interfaces.d.ts → interfaces/index.d.ts}

@@ -1,4 +1,5 @@
-import { BoolInt, FeaturedItemType, HexString, HexStringOrEmpty } from '../types';
+import { BoolInt, FeaturedItemType, HexString, HexStringOrEmpty } from '../../types';
+import { ISlotHistoryIndex, StoredHandle } from './api';
 export declare enum Rarity {
     basic = "basic",
     common = "common",
@@ -202,7 +203,7 @@ export interface IPzDatum {
     pfp_image?: string;
     pfp_asset?: HexStringOrEmpty;
     bg_asset?: HexStringOrEmpty;
-    last_edited_time: number;
+    last_edited_time?: number;
     portal?: string;
     designer?: string;
     socials?: string;
@@ -335,7 +336,8 @@ export interface IHandleFileContent {
     slot: number;
     hash: string;
     schemaVersion?: number;
-    handles: Record<string, IPersonalizedHandle>;
+    handles: Record<string, StoredHandle>;
+    history: [number, ISlotHistoryIndex][];
 }
 export interface IHandleSvgOptions extends IPersonalizationDesigner {
     pfp_image?: string;

package/handles/models/handlePagination.model.d.ts

@@ -0,0 +1,15 @@
+import { SortWithRandom } from '../../types';
+export interface HandlePaginationInput {
+    handlesPerPage?: string;
+    sort?: SortWithRandom;
+    page?: string;
+    slotNumber?: string;
+}
+export declare class HandlePaginationModel {
+    page: number;
+    handlesPerPage: number;
+    sort: SortWithRandom;
+    slotNumber?: number | null;
+    constructor(input?: HandlePaginationInput);
+    private validateHandlePagination;
+}

package/handles/models/handlePagination.model.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlePaginationModel = void 0;
+const errors_1 = require("../../errors");
+const constants_1 = require("../constants");
+const utils_1 = require("../../utils");
+class HandlePaginationModel {
+    constructor(input) {
+        const { handlesPerPage, sort, page, slotNumber } = input !== null && input !== void 0 ? input : {};
+        this.validateHandlePagination(handlesPerPage, sort, page, slotNumber);
+        this.handlesPerPage = handlesPerPage ? parseInt(handlesPerPage) : 100;
+        this.page = page ? parseInt(page) : 1;
+        this.sort = sort !== null && sort !== void 0 ? sort : 'asc';
+        this.slotNumber = slotNumber ? parseInt(slotNumber) : null;
+    }
+    validateHandlePagination(handlesPerPage, sort, page, slotNumber) {
+        if (handlesPerPage && !(0, utils_1.isNumeric)(handlesPerPage)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_LIMIT_INVALID_FORMAT);
+        }
+        if (handlesPerPage && parseInt(handlesPerPage) > 1000) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_LIMIT_EXCEEDED);
+        }
+        if (page && !(0, utils_1.isNumeric)(page)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_PAGE_INVALID);
+        }
+        if (sort && !['desc', 'asc', 'random'].includes(sort)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_SORT_INVALID);
+        }
+        if (slotNumber && !(0, utils_1.isNumeric)(slotNumber)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_SLOT_NUMBER_INVALID);
+        }
+        if (page && slotNumber) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_PAGE_AND_SLOT_NUMBER_INVALID);
+        }
+    }
+}
+exports.HandlePaginationModel = HandlePaginationModel;

package/handles/models/handleSearch.model.d.ts

@@ -0,0 +1,46 @@
+interface HandleSearchInput {
+    characters?: string;
+    length?: string;
+    rarity?: string;
+    numeric_modifiers?: string;
+    search?: string;
+    holder_address?: string;
+    personalized?: boolean;
+    handle_type?: string;
+    og?: string;
+    handles?: string[];
+}
+export declare class HandleSearchModel {
+    private _characters?;
+    private _length?;
+    private _rarity?;
+    private _numeric_modifiers?;
+    private _search?;
+    private _holder_address?;
+    private _personalized?;
+    private _handle_type?;
+    private _og?;
+    private _handles?;
+    constructor(input?: HandleSearchInput);
+    get characters(): string | undefined;
+    set characters(value: string | undefined);
+    get rarity(): string | undefined;
+    set rarity(value: string | undefined);
+    get handle_type(): string | undefined;
+    set handle_type(value: string | undefined);
+    get length(): string | undefined;
+    set length(value: string | undefined);
+    get numeric_modifiers(): string | undefined;
+    set numeric_modifiers(value: string | undefined);
+    get search(): string | undefined;
+    set search(value: string | undefined);
+    get holder_address(): string | undefined;
+    set holder_address(value: string | undefined);
+    get personalized(): boolean | undefined;
+    set personalized(value: boolean | undefined);
+    get og(): boolean | undefined;
+    set og(value: boolean | undefined);
+    get handles(): string[] | undefined;
+    set handles(value: string[] | undefined);
+}
+export {};

package/handles/models/handleSearch.model.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandleSearchModel = void 0;
+const __1 = require("..");
+const errors_1 = require("../../errors");
+const utils_1 = require("../../utils");
+class HandleSearchModel {
+    constructor(input) {
+        const { characters, length, rarity, numeric_modifiers, search, holder_address, og, personalized, handle_type, handles } = input !== null && input !== void 0 ? input : {};
+        this.characters = characters;
+        this.length = length;
+        this.rarity = rarity;
+        this.numeric_modifiers = numeric_modifiers;
+        this.search = search;
+        this.holder_address = holder_address;
+        this.personalized = personalized;
+        this.handle_type = handle_type;
+        this.og = og === 'true';
+        this.handles = handles;
+    }
+    get characters() {
+        return this._characters;
+    }
+    set characters(value) {
+        const validCharacters = ['letters', 'numbers', 'special'];
+        if (value && !validCharacters.some((v) => value.split(',').includes(v))) {
+            throw new errors_1.ModelException(`characters must be ${validCharacters.join(', ')}`);
+        }
+        this._characters = value;
+    }
+    get rarity() {
+        return this._rarity;
+    }
+    set rarity(value) {
+        const validRarity = Object.values(__1.Rarity);
+        if (value && !validRarity.some((v) => value.split(',').includes(v))) {
+            throw new errors_1.ModelException(`rarity must be ${validRarity.join(', ')}`);
+        }
+        this._rarity = value;
+    }
+    get handle_type() {
+        return this._handle_type;
+    }
+    set handle_type(value) {
+        const validHandleType = Object.values(__1.HandleType);
+        if (value && !validHandleType.some((v) => value.split(',').includes(v))) {
+            throw new errors_1.ModelException(`handle_type must be ${validHandleType.join(', ')}`);
+        }
+        this._handle_type = value;
+    }
+    get length() {
+        return this._length;
+    }
+    set length(value) {
+        const lengthMErrorMsg = "Length must be a number or a range of numbers (ex: 1-28) and can't exceed 28";
+        if (!value) {
+            this._length = value;
+            return;
+        }
+        let minLength = value;
+        let maxLength = value;
+        if (value === null || value === void 0 ? void 0 : value.includes('-')) {
+            minLength = value.split('-')[0];
+            maxLength = value.split('-')[1];
+        }
+        if (!(0, utils_1.isNumeric)(minLength) || !(0, utils_1.isNumeric)(maxLength)) {
+            throw new errors_1.ModelException(lengthMErrorMsg);
+        }
+        if (parseInt(minLength) > 28 || parseInt(maxLength) > 28) {
+            throw new errors_1.ModelException(lengthMErrorMsg);
+        }
+        if (parseInt(minLength) > parseInt(maxLength)) {
+            throw new errors_1.ModelException('Invalid length range');
+        }
+        this._length = value;
+    }
+    get numeric_modifiers() {
+        return this._numeric_modifiers;
+    }
+    set numeric_modifiers(value) {
+        const validModifiers = ['negative', 'decimal'];
+        if (value && !validModifiers.some((v) => value.split(',').includes(v))) {
+            throw new errors_1.ModelException(`numeric_modifiers must be ${validModifiers.join(', ')}`);
+        }
+        this._numeric_modifiers = value;
+    }
+    get search() {
+        return this._search;
+    }
+    set search(value) {
+        if (value && value.length < 3) {
+            throw new errors_1.ModelException('search must be at least 3 characters');
+        }
+        this._search = value;
+    }
+    get holder_address() {
+        return this._holder_address;
+    }
+    set holder_address(value) {
+        this._holder_address = value;
+    }
+    get personalized() {
+        return this._personalized;
+    }
+    set personalized(value) {
+        this._personalized = value;
+    }
+    get og() {
+        return this._og;
+    }
+    set og(value) {
+        this._og = value;
+    }
+    get handles() {
+        return this._handles;
+    }
+    set handles(value) {
+        if (value && !Array.isArray(value)) {
+            throw new errors_1.ModelException(`expected array and received ${typeof value}`);
+        }
+        this._handles = value;
+    }
+}
+exports.HandleSearchModel = HandleSearchModel;

package/handles/models/holderPagination.model.d.ts

@@ -0,0 +1,13 @@
+import { Sort } from '../../types';
+export interface HolderPaginationInput {
+    recordsPerPage?: string;
+    sort?: Sort;
+    page?: string;
+}
+export declare class HolderPaginationModel {
+    page: number;
+    recordsPerPage: number;
+    sort: Sort;
+    constructor(input?: HolderPaginationInput);
+    private validateHolderPagination;
+}

package/handles/models/holderPagination.model.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HolderPaginationModel = void 0;
+const errors_1 = require("../../errors");
+const constants_1 = require("../constants");
+const utils_1 = require("../../utils");
+class HolderPaginationModel {
+    constructor(input) {
+        const { recordsPerPage, sort, page } = input !== null && input !== void 0 ? input : {};
+        this.validateHolderPagination(recordsPerPage, sort, page);
+        this.recordsPerPage = recordsPerPage ? parseInt(recordsPerPage) : 100;
+        this.page = page ? parseInt(page) : 1;
+        this.sort = sort !== null && sort !== void 0 ? sort : 'desc';
+    }
+    validateHolderPagination(recordsPerPage, sort, page) {
+        if (recordsPerPage && !(0, utils_1.isNumeric)(recordsPerPage)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_LIMIT_INVALID_FORMAT);
+        }
+        if (recordsPerPage && parseInt(recordsPerPage) > 1000) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_LIMIT_EXCEEDED);
+        }
+        if (page && !(0, utils_1.isNumeric)(page)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_PAGE_INVALID);
+        }
+        if (sort && !['desc', 'asc'].includes(sort)) {
+            throw new errors_1.ModelException(constants_1.ERROR_TEXT.HANDLE_SORT_INVALID);
+        }
+    }
+}
+exports.HolderPaginationModel = HolderPaginationModel;

package/handles/models/index.d.ts

@@ -0,0 +1,3 @@
+export * from './handleSearch.model';
+export * from './handlePagination.model';
+export * from './holderPagination.model';

package/handles/models/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./handleSearch.model"), exports);
+__exportStar(require("./handlePagination.model"), exports);
+__exportStar(require("./holderPagination.model"), exports);

package/handles/{buildMetadata.d.ts → utils.d.ts}

@@ -1,7 +1,13 @@
 import { HandleType, IHandleMetadata } from './interfaces';
+import { Rarity } from './interfaces';
+export declare const getRarity: (name: string) => Rarity;
 export declare const buildMetadata: ({ handleName, handleType, cid, ogNumber }: {
     handleName: string;
     handleType: HandleType;
     cid: string;
     ogNumber?: number | undefined;
 }) => IHandleMetadata;
+export declare const checkHandlePattern: (handle: string, root?: string) => {
+    valid: boolean;
+    message: string;
+};

package/handles/{buildMetadata.js → utils.js}

@@ -1,7 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildMetadata = void 0;
-const getRarity_1 = require("./getRarity");
+exports.checkHandlePattern = exports.buildMetadata = exports.getRarity = void 0;
+const constants_1 = require("./constants");
+const interfaces_1 = require("./interfaces");
+const getRarity = (name) => {
+    const length = name.length;
+    if (1 === length) {
+        return interfaces_1.Rarity.legendary;
+    }
+    if (2 === length) {
+        return interfaces_1.Rarity.ultra_rare;
+    }
+    if (3 === length) {
+        return interfaces_1.Rarity.rare;
+    }
+    if (length > 3 && length < 8) {
+        return interfaces_1.Rarity.common;
+    }
+    return interfaces_1.Rarity.basic;
+};
+exports.getRarity = getRarity;
 const buildCharacters = (name) => {
     const characters = [];
     if (/[a-z]+/.test(name)) {
@@ -36,7 +54,7 @@ const buildMetadata = ({ handleName, handleType, cid, ogNumber }) => {
         mediaType: 'image/jpeg',
         og: isSubHandle ? 0 : ogNumber ? 1 : 0,
         og_number: isSubHandle ? 0 : ogNumber !== null && ogNumber !== void 0 ? ogNumber : 0,
-        rarity: (0, getRarity_1.getRarity)(rootHandleName !== null && rootHandleName !== void 0 ? rootHandleName : handleName),
+        rarity: (0, exports.getRarity)(rootHandleName !== null && rootHandleName !== void 0 ? rootHandleName : handleName),
         length: handleName.length,
         characters: buildCharacters(rootHandleName !== null && rootHandleName !== void 0 ? rootHandleName : handleName),
         numeric_modifiers: buildNumericModifiers(rootHandleName !== null && rootHandleName !== void 0 ? rootHandleName : handleName),
@@ -46,7 +64,7 @@ const buildMetadata = ({ handleName, handleType, cid, ogNumber }) => {
     if (isSubHandle) {
         metadata = {
             ...metadata,
-            sub_rarity: (0, getRarity_1.getRarity)(subHandleName),
+            sub_rarity: (0, exports.getRarity)(subHandleName),
             sub_length: subHandleName.length,
             sub_characters: buildCharacters(subHandleName),
             sub_numeric_modifiers: buildNumericModifiers(subHandleName)
@@ -55,3 +73,23 @@ const buildMetadata = ({ handleName, handleType, cid, ogNumber }) => {
     return metadata;
 };
 exports.buildMetadata = buildMetadata;
+const checkHandlePattern = (handle, root) => {
+    handle = handle.toLowerCase();
+    if (handle.length <= 1) {
+        return {
+            valid: false,
+            message: constants_1.RESPONSE_UNAVAILABLE_LEGENDARY
+        };
+    }
+    if (!handle.match(constants_1.REGEX_SUB_HANDLE) && (root ? handle.endsWith(`@${root}`) : true)) {
+        return {
+            valid: false,
+            message: constants_1.RESPONSE_INVALID_HANDLE_FORMAT
+        };
+    }
+    return {
+        valid: true,
+        message: constants_1.RESPONSE_AVAILABLE
+    };
+};
+exports.checkHandlePattern = checkHandlePattern;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "4.4.8",
+    "version": "5.0.0",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",
@@ -19,7 +19,7 @@
     ],
     "scripts": {
         "lint": "eslint . --ext .ts",
-        "test": "node --experimental-vm-modules node_modules/.bin/jest",
+        "test": "NETWORK=mainnet node --experimental-vm-modules node_modules/.bin/jest",
         "build": "tsc",
         "build:local": "yarn build && cp package.json ./lib/package.json && cd lib && npm i --production",
         "npm:publish": "yarn build && cp package.json ./lib/package.json && (cd ./lib && npm publish)"
@@ -42,7 +42,9 @@
     "dependencies": {
         "bech32": "^2.0.0",
         "boolean": "^3.2.0",
+        "bs58": "^6.0.0",
         "cbor": "^9.0.2",
+        "crc": "^4.3.2",
         "pluralize-esm": "^9.0.5"
     }
 }

package/types/index.d.ts

@@ -27,3 +27,21 @@ export declare enum CardanoNetwork {
     UNSET = "UNSET"
 }
 export type Network = 'preview' | 'preprod' | 'mainnet';
+export type Sort = 'asc' | 'desc';
+export type SortWithRandom = 'asc' | 'desc' | 'random';
+export declare enum AddressType {
+    Wallet = "wallet",
+    Enterprise = "enterprise",
+    Script = "script",
+    Reward = "reward",
+    Other = "other"
+}
+export declare enum StakeAddressType {
+    Script = "f",
+    Key = "e"
+}
+export interface AddressDetails {
+    address: string;
+    type: string;
+    knownOwnerName: string;
+}

package/types/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CardanoNetwork = exports.AssetNameLabel = void 0;
+exports.StakeAddressType = exports.AddressType = exports.CardanoNetwork = exports.AssetNameLabel = void 0;
 __exportStar(require("./gallery"), exports);
 /**
  * The Cip67Label is a string that is used to identify the asset type.
@@ -38,3 +38,16 @@ var CardanoNetwork;
     CardanoNetwork["PREVIEW"] = "PREVIEW";
     CardanoNetwork["UNSET"] = "UNSET";
 })(CardanoNetwork = exports.CardanoNetwork || (exports.CardanoNetwork = {}));
+var AddressType;
+(function (AddressType) {
+    AddressType["Wallet"] = "wallet";
+    AddressType["Enterprise"] = "enterprise";
+    AddressType["Script"] = "script";
+    AddressType["Reward"] = "reward";
+    AddressType["Other"] = "other";
+})(AddressType = exports.AddressType || (exports.AddressType = {}));
+var StakeAddressType;
+(function (StakeAddressType) {
+    StakeAddressType["Script"] = "f";
+    StakeAddressType["Key"] = "e";
+})(StakeAddressType = exports.StakeAddressType || (exports.StakeAddressType = {}));

package/utils/crypto/index.d.ts

@@ -1,3 +1,4 @@
+import { AddressDetails, AddressType, AssetNameLabel } from '../../types';
 export declare const getNativeCrypto: () => Promise<any>;
 export declare function dec2hex(dec: number): string;
 export declare function getRandomCodeVerifier(length: number): Promise<string>;
@@ -5,3 +6,18 @@ export declare const sha256: (plain: string) => Promise<ArrayBuffer>;
 export declare function base64urlencode(a: ArrayBuffer): string;
 export declare function getChallengeFromVerifier(verifier: string): Promise<string>;
 export declare const decodeAddress: (address: string) => string | null;
+export declare const parseAssetNameLabel: (assetName: string) => AssetNameLabel | null;
+export declare const checkNameLabel: (assetName: string) => {
+    isCip67: boolean;
+    assetLabel: string | null;
+    assetName: string;
+};
+export declare const getPaymentAddressType: (headerByte: number) => AddressType;
+export declare const buildPaymentAddressType: (address: string) => AddressType;
+export declare const buildStakeKey: (address: string) => string | null;
+export declare const getPaymentKeyHash: (address: string) => Promise<string | null>;
+export declare const bech32FromHex: (hex: string, isTestnet?: boolean, type?: 'addr' | 'stake' | 'pool' | 'drep') => string;
+export declare const getAddressHolderDetails: (addr: string) => AddressDetails;
+export declare const checkKnownSmartContracts: (address: string, stake?: string | null) => string;
+export declare const getDateStringFromSlot: (currentSlot: number) => Date;
+export declare const getSlotNumberFromDate: (date: Date) => number;

package/utils/crypto/index.js

@@ -22,10 +22,18 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeAddress = exports.getChallengeFromVerifier = exports.base64urlencode = exports.sha256 = exports.getRandomCodeVerifier = exports.dec2hex = exports.getNativeCrypto = void 0;
-const bech32_1 = require("bech32");
+exports.getSlotNumberFromDate = exports.getDateStringFromSlot = exports.checkKnownSmartContracts = exports.getAddressHolderDetails = exports.bech32FromHex = exports.getPaymentKeyHash = exports.buildStakeKey = exports.buildPaymentAddressType = exports.getPaymentAddressType = exports.checkNameLabel = exports.parseAssetNameLabel = exports.decodeAddress = exports.getChallengeFromVerifier = exports.base64urlencode = exports.sha256 = exports.getRandomCodeVerifier = exports.dec2hex = exports.getNativeCrypto = void 0;
 const constants_1 = require("../../constants");
+const types_1 = require("../../types");
+const cbor_1 = require("../cbor");
+const logger_1 = require("../../logger");
+const bech32_1 = require("bech32");
+const bs58_1 = __importDefault(require("bs58"));
+const crc_1 = require("crc");
 // var verifier = await getRandomCodeVerifier(64);
 // var challenge = await getChallengeFromVerifier(verifier);
 const getNativeCrypto = async () => {
@@ -83,3 +91,200 @@ const decodeAddress = (address) => {
     }
 };
 exports.decodeAddress = decodeAddress;
+const parseAssetNameLabel = (assetName) => {
+    for (const lbl in types_1.AssetNameLabel) {
+        if (assetName.startsWith(types_1.AssetNameLabel[lbl])) {
+            return lbl;
+        }
+    }
+    return null;
+};
+exports.parseAssetNameLabel = parseAssetNameLabel;
+const checkNameLabel = (assetName) => {
+    const assetNameString = typeof assetName === 'string' ? assetName : new TextDecoder().decode(assetName);
+    let isCip67 = false;
+    let assetLabel = null;
+    let actualAssetName = Buffer.from(assetName, 'hex').toString('utf8');
+    if (assetNameString.length >= 8) {
+        const maybeAssetLabel = assetNameString.slice(0, 8);
+        if (maybeAssetLabel.startsWith('0') && maybeAssetLabel.endsWith('0')) {
+            const label = maybeAssetLabel.slice(1, 5);
+            const check = maybeAssetLabel.slice(5, 7);
+            if ((0, crc_1.crc8)(Buffer.from(label, 'hex')).toString(16).padStart(2, '0') == check) {
+                isCip67 = true;
+                assetLabel = `${parseInt(label, 16).toString().padStart(3, '0')}`;
+                actualAssetName = Buffer.from(assetName.slice(8), 'hex').toString('utf8');
+            }
+        }
+    }
+    return {
+        isCip67,
+        assetLabel,
+        assetName: actualAssetName
+    };
+};
+exports.checkNameLabel = checkNameLabel;
+const getPaymentAddressType = (headerByte) => {
+    // https://cips.cardano.org/cips/cip19/#shelleyaddresses
+    if (headerByte >= 8) {
+        return types_1.AddressType.Other;
+    }
+    else if (headerByte === 6) {
+        return types_1.AddressType.Enterprise;
+    }
+    else if (headerByte % 2 === 0) {
+        return types_1.AddressType.Wallet;
+    }
+    else {
+        return types_1.AddressType.Script;
+    }
+};
+exports.getPaymentAddressType = getPaymentAddressType;
+const getDelegationAddressType = (headerByte) => {
+    if (headerByte === 2 || headerByte === 3) {
+        return types_1.StakeAddressType.Script;
+    }
+    return types_1.StakeAddressType.Key;
+};
+const buildPaymentAddressType = (address) => {
+    const decoded = (0, exports.decodeAddress)(address);
+    if (!decoded) {
+        return types_1.AddressType.Other;
+    }
+    const [c] = decoded;
+    const parsedChar = parseInt(c);
+    if (isNaN(parsedChar)) {
+        if (['e', 'f'].includes(c)) {
+            return types_1.AddressType.Reward;
+        }
+        else {
+            return types_1.AddressType.Other;
+        }
+    }
+    const addressType = (0, exports.getPaymentAddressType)(parsedChar);
+    return addressType;
+};
+exports.buildPaymentAddressType = buildPaymentAddressType;
+const buildStakeKey = (address) => {
+    try {
+        const decoded = (0, exports.decodeAddress)(address);
+        if (!decoded || decoded.length !== 114)
+            return null;
+        const [c] = decoded;
+        const parsedChar = parseInt(c);
+        const isTestnet = address.startsWith('addr_test');
+        const prefix = isTestnet ? 'stake_test' : 'stake';
+        const delegationType = `${getDelegationAddressType(parsedChar)}${isTestnet ? '0' : '1'}`;
+        // stake part of the address is the last 56 bytes
+        const stakeAddressDecoded = delegationType + decoded.slice(decoded.length - 56);
+        const stakeAddress = bech32_1.bech32.encode(prefix, bech32_1.bech32.toWords(Uint8Array.from(Buffer.from(stakeAddressDecoded, 'hex'))), 54 + prefix.length);
+        return stakeAddress;
+    }
+    catch (error) {
+        logger_1.Logger.log(`Error building stake key ${error.message}`);
+        return null;
+    }
+};
+exports.buildStakeKey = buildStakeKey;
+const getPaymentKeyHash = async (address) => {
+    try {
+        const decoded = (0, exports.decodeAddress)(address);
+        if (!decoded) {
+            try {
+                // Try Byron addresses
+                const jsonAddress = await (0, cbor_1.decodeCborToJson)({ cborString: Buffer.from(bs58_1.default.decode(address)).toString('hex') });
+                const innerAddress = await (0, cbor_1.decodeCborToJson)({ cborString: jsonAddress[0].value.toString('hex') });
+                return innerAddress[0].toString('hex').slice(2);
+            }
+            catch (_a) {
+                return null;
+            }
+        }
+        else {
+            return decoded.slice(2, 58);
+        }
+    }
+    catch (error) {
+        logger_1.Logger.log(`Error getting payment key ${error.message}`);
+        return null;
+    }
+};
+exports.getPaymentKeyHash = getPaymentKeyHash;
+const bech32FromHex = (hex, isTestnet = !constants_1.IS_PRODUCTION, type = 'addr') => {
+    const prefix = isTestnet ? `${type}_test` : type;
+    const bytes = Uint8Array.from(Buffer.from(hex, 'hex'));
+    const words = bech32_1.bech32.toWords(bytes);
+    return bech32_1.bech32.encode(prefix, words, bytes.length * 2 + prefix.length);
+};
+exports.bech32FromHex = bech32FromHex;
+const getAddressHolderDetails = (addr) => {
+    const addressType = (0, exports.buildPaymentAddressType)(addr);
+    let knownOwnerName = (0, exports.checkKnownSmartContracts)(addr);
+    let stakeKey = null;
+    if (addressType === types_1.AddressType.Wallet || addressType === types_1.AddressType.Script) {
+        stakeKey = (0, exports.buildStakeKey)(addr);
+        knownOwnerName = (0, exports.checkKnownSmartContracts)(addr, stakeKey);
+    }
+    return {
+        address: stakeKey !== null && stakeKey !== void 0 ? stakeKey : addr,
+        type: addressType,
+        knownOwnerName
+    };
+};
+exports.getAddressHolderDetails = getAddressHolderDetails;
+const checkKnownSmartContracts = (address, stake) => {
+    switch (address) {
+        case 'addr1w999n67e86jn6xal07pzxtrmqynspgx0fwmcmpua4wc6yzsxpljz3':
+            return 'jpg.store';
+        case 'addr1w9yr0zr530tp9yzrhly8lw5upddu0eym3yh0mjwa0qlr9pgmkzgv0':
+        case 'addr1w89s3lfv7gkugker5llecq6x3k2vjvfnvp4692laeqe6w6s93vj3j':
+        case 'addr1wx38kptjhuurcag7zdvh5cq98rjxt0ulf6ed7jtmz5gpkfcgjyyx3':
+            return 'cnft.io';
+        case 'addr1wyd3phmr5lhv3zssawqjdpnqrm5r5kgppmmf7864p3dvdrqwuutk4':
+            return 'epoch.art';
+        case 'addr1wxkqxmfkt6jas8mul0luqea8c5vsg8reu3ak3v9cswmm6yg2u9mrh':
+            return 'freeroam.io';
+        case 'addr1wxx0w0ku3jz8hz5dakg982lh22xx6q7z2z7vh0dt34uzghqrxdhqq':
+            return 'Cardahub.io';
+        case 'addr1wywukn5q6lxsa5uymffh2esuk8s8fel7a0tna63rdntgrysv0f3ms':
+            return 'Artifct';
+        case 'addr1wxz62xuzeujtuuzn2ewkrzwmm2pf79kfc84lrnjsd9ja2jscv3gy0':
+            return 'Genesis House';
+        case 'addr1wydpsqf5zz9ddy76d3f3jrrf6jkpyjr48nx5a706w9y68ucy4wu6s':
+            return 'Yummi-Staking';
+        case 'addr1wyl5fauf4m4thqze74kvxk8efcj4n7qjx005v33ympj7uwsscprfk':
+            return 'Tokhun';
+        case 'stake1uxqh9rn76n8nynsnyvf4ulndjv0srcc8jtvumut3989cqmgjt49h6':
+            return 'jpg.store';
+    }
+    switch (stake) {
+        case 'stake1uxqh9rn76n8nynsnyvf4ulndjv0srcc8jtvumut3989cqmgjt49h6':
+            return 'jpg.store';
+    }
+    return '';
+};
+exports.checkKnownSmartContracts = checkKnownSmartContracts;
+const getDateStringFromSlot = (currentSlot) => {
+    // TODO: Make this work for all networks
+    //console.log(`preview slot date = ${new Date(currentSlot * 1000)}`)
+    if (constants_1.NETWORK == 'preview') {
+        return new Date((1666656000 + currentSlot) * 1000);
+    }
+    if (constants_1.NETWORK == 'preprod') {
+        return new Date((1654041600 + currentSlot) * 1000);
+    }
+    return new Date((1596491091 + (currentSlot - 4924800)) * 1000);
+};
+exports.getDateStringFromSlot = getDateStringFromSlot;
+const getSlotNumberFromDate = (date) => {
+    if (constants_1.NETWORK == 'preview') {
+        return Math.floor(date.getTime() / 1000) - 1666656000;
+    }
+    if (constants_1.NETWORK == 'preprod') {
+        return Math.floor(date.getTime() / 1000) - 1654041600;
+    }
+    // Ignore parens to show intent
+    // prettier-ignore
+    return (Math.floor(date.getTime() / 1000) - 1596491091) + 4924800;
+};
+exports.getSlotNumberFromDate = getSlotNumberFromDate;

package/utils/index.d.ts

@@ -1,4 +1,3 @@
-import { AssetNameLabel } from '../types';
 export declare const delay: (ms: number) => Promise<void>;
 export declare const toLovelace: (adaAmount: number) => number;
 export declare const toADA: (lovelaceAmount: number) => number;
@@ -10,6 +9,14 @@ export declare const isNullEmptyOrUndefined: (value: any) => boolean;
 export declare const isAlphaNumeric: (str: string) => boolean;
 export declare const getDateFromSlot: (currentSlot: number, network?: string) => number;
 export declare const getSlotNumberFromDate: (date: Date, network?: string) => number;
-export declare const parseAssetNameLabel: (assetName: string) => AssetNameLabel | null;
+export declare const getElapsedTime: (milliseconds: number) => string;
+export declare const objectHasKeys: (o: any) => boolean;
+export declare const isEmpty: (obj: any) => boolean;
+export declare const isObject: (o: any) => boolean;
+export declare const hasOwnProperty: (o: any, v: PropertyKey) => boolean;
+export declare const isDate: (d: any) => boolean;
+export declare const isEmptyObject: (o: any) => boolean;
+export declare const makeObjectWithoutPrototype: () => any;
+export declare const diff: (lhs: any, rhs: any) => any;
 export { DefaultTextFormat as KeyType, encodeJsonToDatum, decodeCborToJson } from './cbor';
 export * from './crypto';

package/utils/index.js

@@ -14,8 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeCborToJson = exports.encodeJsonToDatum = exports.KeyType = exports.parseAssetNameLabel = exports.getSlotNumberFromDate = exports.getDateFromSlot = exports.isAlphaNumeric = exports.isNullEmptyOrUndefined = exports.isNumeric = exports.asyncForEach = exports.awaitForEach = exports.chunk = exports.toADA = exports.toLovelace = exports.delay = void 0;
-const types_1 = require("../types");
+exports.decodeCborToJson = exports.encodeJsonToDatum = exports.KeyType = exports.diff = exports.makeObjectWithoutPrototype = exports.isEmptyObject = exports.isDate = exports.hasOwnProperty = exports.isObject = exports.isEmpty = exports.objectHasKeys = exports.getElapsedTime = exports.getSlotNumberFromDate = exports.getDateFromSlot = exports.isAlphaNumeric = exports.isNullEmptyOrUndefined = exports.isNumeric = exports.asyncForEach = exports.awaitForEach = exports.chunk = exports.toADA = exports.toLovelace = exports.delay = void 0;
 const delay = (ms) => {
     return new Promise((resolve) => setTimeout(resolve, ms));
 };
@@ -89,15 +88,61 @@ const getSlotNumberFromDate = (date, network) => {
     return (Math.floor(date.getTime() / 1000) - 1596491091) + 4924800;
 };
 exports.getSlotNumberFromDate = getSlotNumberFromDate;
-const parseAssetNameLabel = (assetName) => {
-    for (const lbl in types_1.AssetNameLabel) {
-        if (assetName.startsWith(types_1.AssetNameLabel[lbl])) {
-            return lbl;
+const getElapsedTime = (milliseconds) => {
+    const seconds = Math.floor(milliseconds / 1000);
+    const mins = Math.floor(seconds / 60);
+    return `${mins}:${(seconds - mins * 60).toString().padStart(2, '0')}`;
+};
+exports.getElapsedTime = getElapsedTime;
+const objectHasKeys = (o) => Object.keys(o).length === 0;
+exports.objectHasKeys = objectHasKeys;
+const isEmpty = (obj) => [Object, Array].includes((obj || {}).constructor) && !Object.entries(obj || {}).length;
+exports.isEmpty = isEmpty;
+const isObject = (o) => o != null && typeof o === 'object';
+exports.isObject = isObject;
+const hasOwnProperty = (o, ...args) => Object.prototype.hasOwnProperty.call(o, ...args);
+exports.hasOwnProperty = hasOwnProperty;
+const isDate = (d) => d instanceof Date;
+exports.isDate = isDate;
+const isEmptyObject = (o) => (0, exports.isObject)(o) && (0, exports.objectHasKeys)(o);
+exports.isEmptyObject = isEmptyObject;
+const makeObjectWithoutPrototype = () => Object.create(null);
+exports.makeObjectWithoutPrototype = makeObjectWithoutPrototype;
+const diff = (lhs, rhs) => {
+    if (lhs === rhs)
+        return {}; // equal return no diff
+    if (!(0, exports.isObject)(lhs) || !(0, exports.isObject)(rhs))
+        return rhs; // return updated rhs
+    const deletedValues = Object.keys(lhs).reduce((acc, key) => {
+        if (!(0, exports.hasOwnProperty)(rhs, key)) {
+            acc[key] = undefined;
         }
+        return acc;
+    }, (0, exports.makeObjectWithoutPrototype)());
+    if ((0, exports.isDate)(lhs) || (0, exports.isDate)(rhs)) {
+        if (lhs.valueOf() == rhs.valueOf())
+            return {};
+        return rhs;
+    }
+    if (Array.isArray(lhs) || Array.isArray(rhs)) {
+        if (lhs.length === rhs.length && JSON.stringify(lhs) === JSON.stringify(rhs))
+            return {}; // return no diff
+        return rhs; // return updated rhs
     }
-    return null;
+    return Object.keys(rhs).reduce((acc, key) => {
+        if (!(0, exports.hasOwnProperty)(lhs, key)) {
+            acc[key] = rhs[key]; // return added r key
+            return acc;
+        }
+        const difference = (0, exports.diff)(lhs[key], rhs[key]);
+        // If the difference is empty, and the lhs is an empty object or the rhs is not an empty object
+        if ((0, exports.isEmptyObject)(difference) && !(0, exports.isDate)(difference) && ((0, exports.isEmptyObject)(lhs[key]) || !(0, exports.isEmptyObject)(rhs[key])))
+            return acc; // return no diff
+        acc[key] = difference; // return updated key
+        return acc; // return updated key
+    }, deletedValues);
 };
-exports.parseAssetNameLabel = parseAssetNameLabel;
+exports.diff = diff;
 var cbor_1 = require("./cbor");
 Object.defineProperty(exports, "KeyType", { enumerable: true, get: function () { return cbor_1.DefaultTextFormat; } });
 Object.defineProperty(exports, "encodeJsonToDatum", { enumerable: true, get: function () { return cbor_1.encodeJsonToDatum; } });

package/handles/getRarity.d.ts

@@ -1,2 +0,0 @@
-import { Rarity } from './interfaces';
-export declare const getRarity: (name: string) => Rarity;

package/handles/getRarity.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRarity = void 0;
-const interfaces_1 = require("./interfaces");
-const getRarity = (name) => {
-    const length = name.length;
-    if (1 === length) {
-        return interfaces_1.Rarity.legendary;
-    }
-    if (2 === length) {
-        return interfaces_1.Rarity.ultra_rare;
-    }
-    if (3 === length) {
-        return interfaces_1.Rarity.rare;
-    }
-    if (length > 3 && length < 8) {
-        return interfaces_1.Rarity.common;
-    }
-    return interfaces_1.Rarity.basic;
-};
-exports.getRarity = getRarity;

package/handles/validation.d.ts

@@ -1,4 +0,0 @@
-export declare const checkHandlePattern: (handle: string, root?: string) => {
-    valid: boolean;
-    message: string;
-};

package/handles/validation.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkHandlePattern = void 0;
-const constants_1 = require("./constants");
-const checkHandlePattern = (handle, root) => {
-    handle = handle.toLowerCase();
-    if (handle.length <= 1) {
-        return {
-            valid: false,
-            message: constants_1.RESPONSE_UNAVAILABLE_LEGENDARY
-        };
-    }
-    if (!handle.match(constants_1.REGEX_SUB_HANDLE) && (root ? handle.endsWith(`@${root}`) : true)) {
-        return {
-            valid: false,
-            message: constants_1.RESPONSE_INVALID_HANDLE_FORMAT
-        };
-    }
-    return {
-        valid: true,
-        message: constants_1.RESPONSE_AVAILABLE
-    };
-};
-exports.checkHandlePattern = checkHandlePattern;