@koralabs/kora-labs-common 6.9.4 → 6.10.0

package/aws/jwtSigner.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 /** True when a local RSA key is configured (i.e. signing/verifying needs no AWS). */
 export declare const isLocalJwtSigner: () => boolean;
 /** Sign `message` with RS256 — local private key if present, else AWS KMS. */

package/aws/kmsEnvironment.d.ts

@@ -1,11 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 import { KMSClient } from '@aws-sdk/client-kms';
 export type KmsClientLike = Pick<KMSClient, 'send'>;
 /**

package/aws/kmsEnvironment.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadAfterHydratingKmsEnvironment = exports.hydrateKmsEnvironment = exports.decryptKmsCiphertext = exports.isKmsDisabled = void 0;
+exports.isKmsDisabled = void 0;
+exports.decryptKmsCiphertext = decryptKmsCiphertext;
+exports.hydrateKmsEnvironment = hydrateKmsEnvironment;
+exports.loadAfterHydratingKmsEnvironment = loadAfterHydratingKmsEnvironment;
 const client_kms_1 = require("@aws-sdk/client-kms");
 const KMS_ENV_BUNDLE_KEY = 'KMS_ENV_BUNDLE_ENC';
 const KMS_DISABLED_KEY = 'KORA_KMS_DISABLED';
@@ -21,7 +24,6 @@ async function decryptKmsCiphertext(ciphertext, client = new client_kms_1.KMSCli
     }
     return Buffer.from(response.Plaintext).toString('utf8');
 }
-exports.decryptKmsCiphertext = decryptKmsCiphertext;
 async function hydrateKmsEnvironment({ env = process.env, client, keys } = {}) {
     // Self-host: SOPS/age decrypts the env at deploy time, so the values are already
     // plaintext and there is no KMS to call. Skip decryption entirely (don't even
@@ -83,9 +85,7 @@ async function hydrateKmsEnvironment({ env = process.env, client, keys } = {}) {
     }
     return hydratedKeys;
 }
-exports.hydrateKmsEnvironment = hydrateKmsEnvironment;
 async function loadAfterHydratingKmsEnvironment(load, options) {
     await hydrateKmsEnvironment(options);
     return load();
 }
-exports.loadAfterHydratingKmsEnvironment = loadAfterHydratingKmsEnvironment;

package/aws/objectStore.d.ts

@@ -1,11 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 export interface ObjectStoreConfig {
     region: string;
     endpoint?: string;

package/chain/cache/ShortTermCache.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Process-local short-TTL cache with in-flight de-duplication. Concurrent identical requests share
+ * a single upstream fetch, and a successful result is served from memory for `ttlMs`. Failures are
+ * NEVER cached (the fetcher promise only writes to the store on resolve). The clock is injectable so
+ * TTL behavior is unit-testable. Ported from the handle.me BFF into kora-labs-common.
+ */
+export declare class ShortTermCache {
+    private readonly now;
+    private store;
+    private inflight;
+    constructor(now?: () => number);
+    get<T>(key: string, ttlMs: number, fetcher: () => Promise<T>): Promise<T>;
+    delete(key: string): void;
+    clear(): void;
+}
+/** Shared process-local cache instance for repetitive chain reads. */
+export declare const sharedShortTermCache: ShortTermCache;

package/chain/cache/ShortTermCache.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sharedShortTermCache = exports.ShortTermCache = void 0;
+/**
+ * Process-local short-TTL cache with in-flight de-duplication. Concurrent identical requests share
+ * a single upstream fetch, and a successful result is served from memory for `ttlMs`. Failures are
+ * NEVER cached (the fetcher promise only writes to the store on resolve). The clock is injectable so
+ * TTL behavior is unit-testable. Ported from the handle.me BFF into kora-labs-common.
+ */
+class ShortTermCache {
+    constructor(now = Date.now) {
+        this.now = now;
+        this.store = new Map();
+        this.inflight = new Map();
+    }
+    async get(key, ttlMs, fetcher) {
+        const hit = this.store.get(key);
+        if (hit && hit.expiresAt > this.now()) {
+            return hit.value;
+        }
+        const pending = this.inflight.get(key);
+        if (pending) {
+            return pending;
+        }
+        const promise = (async () => {
+            const value = await fetcher();
+            this.store.set(key, { value, expiresAt: this.now() + ttlMs });
+            return value;
+        })().finally(() => {
+            this.inflight.delete(key);
+        });
+        this.inflight.set(key, promise);
+        return promise;
+    }
+    delete(key) {
+        this.store.delete(key);
+        this.inflight.delete(key);
+    }
+    clear() {
+        this.store.clear();
+        this.inflight.clear();
+    }
+}
+exports.ShortTermCache = ShortTermCache;
+/** Shared process-local cache instance for repetitive chain reads. */
+exports.sharedShortTermCache = new ShortTermCache();

package/chain/failover/ChainProviderFailover.d.ts

@@ -0,0 +1,50 @@
+import { AccountAsset, AddressInfo, BackgroundImageDetails, ChainProvider, ChainProviderAsset, ChainProviderUtxo } from './interfaces';
+export interface FailoverOptions {
+    /**
+     * Cooldown (ms) during which a provider that just failed is skipped as the *start* provider,
+     * so a throttled/down provider doesn't add latency to every subsequent call. It is still used
+     * as a fallback if the others also fail. Set 0 to disable (pure random start = legacy behavior).
+     */
+    unhealthyCooldownMs?: number;
+    now?: () => number;
+    /** Injectable RNG in [0,1) for deterministic start selection in tests. Defaults to Math.random. */
+    random?: () => number;
+}
+/**
+ * Health-aware failover across interchangeable ChainProviders. Reads start on a healthy provider
+ * (random among healthy, else random overall) and fall through to the next on error — giving mutual
+ * Koios/Blockfrost redundancy from a single call site. Ported from the handle.me BFF and generalized
+ * (no app-level constants) so every repo shares it via kora-labs-common.
+ */
+export declare class ChainProviderFailover {
+    private providers;
+    private unhealthyUntil;
+    private readonly cooldownMs;
+    private readonly now;
+    private readonly random;
+    constructor(providers: ChainProvider[], options?: FailoverOptions);
+    private isHealthy;
+    private getStartIndex;
+    private getNextProviderIndex;
+    private getResponse;
+    getLatestTransactionForAsset(policyId: string, hex: string): Promise<string | null>;
+    getLatestBlock(): Promise<{
+        height: number;
+        slot: number;
+        time: number;
+    }>;
+    getAssets(policyId: string): Promise<{
+        policyId: string;
+        hex: string;
+    }[]>;
+    getAssetDatum(policyId: string, hex: string): Promise<string | null>;
+    getCip25AssetImage(policyId: string, hex: string): Promise<string | null>;
+    getRefScriptCbor(tx: string, policyId: string, hex: string): Promise<string>;
+    getTxUtxos(tx: string): Promise<ChainProviderUtxo>;
+    getAssetUtxo(policyId: string, hex: string): Promise<ChainProviderAsset | null>;
+    getAssetsByStakeKey(stakeKey: string): Promise<AccountAsset[]>;
+    getDatumFromHash(datumHash: string): Promise<string | null>;
+    getBackgroundImageDetails(policyId: string, hex: string): Promise<BackgroundImageDetails>;
+    getAddressInfo(bech32Address: string): Promise<AddressInfo>;
+    getAddressUTxOs(bech32Address: string): Promise<ChainProviderAsset[]>;
+}

package/chain/failover/ChainProviderFailover.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainProviderFailover = void 0;
+/**
+ * Health-aware failover across interchangeable ChainProviders. Reads start on a healthy provider
+ * (random among healthy, else random overall) and fall through to the next on error — giving mutual
+ * Koios/Blockfrost redundancy from a single call site. Ported from the handle.me BFF and generalized
+ * (no app-level constants) so every repo shares it via kora-labs-common.
+ */
+class ChainProviderFailover {
+    constructor(providers, options = {}) {
+        var _a, _b, _c;
+        this.providers = [];
+        this.unhealthyUntil = [];
+        this.providers = providers;
+        this.unhealthyUntil = providers.map(() => 0);
+        this.cooldownMs = (_a = options.unhealthyCooldownMs) !== null && _a !== void 0 ? _a : 30000;
+        this.now = (_b = options.now) !== null && _b !== void 0 ? _b : Date.now;
+        this.random = (_c = options.random) !== null && _c !== void 0 ? _c : Math.random;
+    }
+    isHealthy(index) {
+        return this.unhealthyUntil[index] <= this.now();
+    }
+    getStartIndex() {
+        const healthy = this.providers.map((_, i) => i).filter((i) => this.isHealthy(i));
+        const pool = healthy.length > 0 ? healthy : this.providers.map((_, i) => i);
+        return pool[Math.floor(this.random() * pool.length)];
+    }
+    getNextProviderIndex(currentIndex) {
+        return (currentIndex + 1) % this.providers.length;
+    }
+    async getResponse(funcName, args, currentIndex, runNum) {
+        const num = runNum !== null && runNum !== void 0 ? runNum : 0;
+        const index = currentIndex !== null && currentIndex !== void 0 ? currentIndex : this.getStartIndex();
+        const chainProvider = this.providers[index];
+        return await chainProvider[funcName](...args).catch((error) => {
+            // Mark the failed provider unhealthy for the cooldown window so it isn't chosen as the
+            // start provider again immediately; it remains a valid fallback.
+            if (this.cooldownMs > 0)
+                this.unhealthyUntil[index] = this.now() + this.cooldownMs;
+            if (num === this.providers.length - 1)
+                throw error;
+            return this.getResponse(funcName, args, this.getNextProviderIndex(index), num + 1);
+        });
+    }
+    async getLatestTransactionForAsset(policyId, hex) {
+        return this.getResponse('getLatestTransactionForAsset', [policyId, hex]);
+    }
+    async getLatestBlock() {
+        return this.getResponse('getLatestBlock', []);
+    }
+    async getAssets(policyId) {
+        return this.getResponse('getAssets', [policyId]);
+    }
+    async getAssetDatum(policyId, hex) {
+        return this.getResponse('getAssetDatum', [policyId, hex]);
+    }
+    async getCip25AssetImage(policyId, hex) {
+        return this.getResponse('getCip25AssetImage', [policyId, hex]);
+    }
+    async getRefScriptCbor(tx, policyId, hex) {
+        return this.getResponse('getRefScriptCbor', [tx, policyId, hex]);
+    }
+    async getTxUtxos(tx) {
+        return this.getResponse('getTxUtxos', [tx]);
+    }
+    async getAssetUtxo(policyId, hex) {
+        // Asset resolution is correctness-critical (backs handle-resolution chain fallback): a
+        // provider lagging a burn returns a stale UTxO and falsely resurrects a de-indexed handle.
+        // Prefer Blockfrost (reads the latest asset tx live; Koios's tx index can lag a burn by
+        // minutes). Koios stays the failover on error.
+        const preferredIndex = this.providers.findIndex((p) => { var _a; return ((_a = p.name) !== null && _a !== void 0 ? _a : '').toLowerCase().includes('blockfrost'); });
+        return this.getResponse('getAssetUtxo', [policyId, hex], preferredIndex >= 0 ? preferredIndex : undefined);
+    }
+    async getAssetsByStakeKey(stakeKey) {
+        return this.getResponse('getAssetsByStakeKey', [stakeKey]);
+    }
+    async getDatumFromHash(datumHash) {
+        return this.getResponse('getDatumFromHash', [datumHash]);
+    }
+    async getBackgroundImageDetails(policyId, hex) {
+        return this.getResponse('getBackgroundImageDetails', [policyId, hex]);
+    }
+    async getAddressInfo(bech32Address) {
+        return this.getResponse('getAddressInfo', [bech32Address]);
+    }
+    async getAddressUTxOs(bech32Address) {
+        return this.getResponse('getAddressUTxOs', [bech32Address]);
+    }
+}
+exports.ChainProviderFailover = ChainProviderFailover;

package/chain/failover/interfaces.d.ts

@@ -0,0 +1,62 @@
+import { ICreatorDefaults } from '../../handles/interfaces';
+export interface ChainProviderAsset {
+    address: string;
+    amount: {
+        unit: string;
+        quantity: string;
+    }[];
+    inline_datum: string | null;
+    output_index: number;
+    tx_hash: string;
+    data_hash: string | null;
+    reference_script_hash?: string | null;
+    reference_script_cbor?: string | null;
+}
+export interface ChainProviderUtxo {
+    outputs: ChainProviderAsset[];
+}
+export interface AccountAsset {
+    asset: string;
+    amount: string;
+}
+export interface AddressInfo {
+    address: string;
+    amount: {
+        unit: string;
+        quantity: string;
+    }[];
+    stake_address?: string | null;
+    script: boolean;
+}
+export interface BackgroundImageDetails {
+    image: string;
+    creatorDefaults?: ICreatorDefaults;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * The unified read contract every chain provider (Koios, Blockfrost, …) implements. The failover
+ * orchestrator only depends on this interface, so providers are hot-swappable and mutually redundant.
+ */
+export interface ChainProvider {
+    name: string;
+    getLatestTransactionForAsset(policyId: string, hex: string): Promise<string | null>;
+    getLatestBlock(): Promise<{
+        height: number;
+        slot: number;
+        time: number;
+    }>;
+    getAssets(policyId: string): Promise<{
+        policyId: string;
+        hex: string;
+    }[]>;
+    getAssetDatum(policyId: string, hex: string): Promise<string | null>;
+    getCip25AssetImage(policyId: string, hex: string): Promise<string | null>;
+    getRefScriptCbor(tx: string, policyId: string, hex: string): Promise<string>;
+    getTxUtxos(tx: string): Promise<ChainProviderUtxo>;
+    getAssetUtxo(policyId: string, hex: string): Promise<ChainProviderAsset | null>;
+    getAssetsByStakeKey(stakeKey: string): Promise<AccountAsset[]>;
+    getDatumFromHash(datumHash: string): Promise<string | null>;
+    getBackgroundImageDetails(policyId: string, hex: string): Promise<BackgroundImageDetails>;
+    getAddressInfo(bech32Address: string): Promise<AddressInfo>;
+    getAddressUTxOs(bech32Address: string): Promise<ChainProviderAsset[]>;
+}

package/chain/failover/interfaces.js

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

package/chain/index.d.ts

@@ -0,0 +1,4 @@
+export * from './transport/fetchProviderJson';
+export * from './failover/interfaces';
+export * from './failover/ChainProviderFailover';
+export * from './cache/ShortTermCache';

package/chain/index.js

@@ -0,0 +1,24 @@
+"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 });
+// Subpath-only module: `@koralabs/kora-labs-common/chain`.
+// NOT re-exported from the root index — this is a server-side chain-access layer and will grow to
+// pull Node-only deps (gRPC/UTxORPC). Keeping it off the root barrel preserves the isomorphic root
+// (same rule the `aws` module follows).
+__exportStar(require("./transport/fetchProviderJson"), exports);
+__exportStar(require("./failover/interfaces"), exports);
+__exportStar(require("./failover/ChainProviderFailover"), exports);
+__exportStar(require("./cache/ShortTermCache"), exports);

package/chain/transport/fetchProviderJson.d.ts

@@ -0,0 +1,26 @@
+export type ProviderName = 'Koios' | 'Blockfrost';
+type ProviderFetcher = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text: () => Promise<string>;
+}>;
+export interface ProviderRequestOptions {
+    provider: ProviderName;
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    maxRps?: number;
+    rateLimitKey?: string;
+    fetcher?: ProviderFetcher;
+}
+export declare const isRetriableError: (provider: ProviderName, error: any) => boolean;
+export declare const fetchProviderJson: <T>({ provider, url, method, headers, body, maxRetries, retryBaseDelayMs, maxRps, rateLimitKey, fetcher }: ProviderRequestOptions) => Promise<T>;
+export {};

package/chain/transport/fetchProviderJson.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProviderJson = exports.isRetriableError = void 0;
+const utils_1 = require("../../utils");
+const DEFAULT_MAX_RPS = 5;
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_RETRY_BASE_DELAY_MS = 500;
+const RETRIABLE_STATUS_CODES = new Set([403, 408, 425, 429, 500, 502, 503, 504]);
+const RETRIABLE_MESSAGE_SNIPPETS = [
+    'terminated',
+    'socket',
+    'econnreset',
+    'fetch failed',
+    'gateway timeout',
+    'too many requests',
+    'payload too large',
+    'timed out acquiring connection from connection pool',
+    'rate limit',
+    'service unavailable',
+    'temporarily unavailable'
+];
+const rateLimitStates = new Map();
+const delay = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+const getRateLimitState = (key) => {
+    const existing = rateLimitStates.get(key);
+    if (existing)
+        return existing;
+    const state = { pending: [], processing: false, maxRps: DEFAULT_MAX_RPS };
+    rateLimitStates.set(key, state);
+    return state;
+};
+const processRateLimitedQueue = async (key) => {
+    const state = getRateLimitState(key);
+    if (state.processing)
+        return;
+    state.processing = true;
+    try {
+        while (state.pending.length > 0) {
+            const pending = state.pending.splice(0, state.pending.length);
+            const delayInMilliseconds = Math.ceil(1000 / Math.max(1, state.maxRps));
+            await (0, utils_1.asyncForEach)(pending, async (queuedTask) => {
+                try {
+                    const value = await queuedTask.task();
+                    queuedTask.resolve(value);
+                }
+                catch (error) {
+                    queuedTask.reject(error);
+                }
+            }, delayInMilliseconds);
+        }
+    }
+    finally {
+        state.processing = false;
+        if (state.pending.length > 0) {
+            void processRateLimitedQueue(key);
+        }
+    }
+};
+const runRateLimitedTask = (key, maxRps, task) => new Promise((resolve, reject) => {
+    const state = getRateLimitState(key);
+    state.maxRps = maxRps;
+    state.pending.push({ task, resolve, reject });
+    void processRateLimitedQueue(key);
+});
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const parseJson = (text) => {
+    if (!text)
+        return { value: null, parseError: null };
+    try {
+        return { value: JSON.parse(text), parseError: null };
+    }
+    catch (error) {
+        return { value: null, parseError: error };
+    }
+};
+const getProviderPayloadError = (provider, value) => {
+    if (!isRecord(value))
+        return null;
+    if (provider === 'Koios') {
+        if (typeof value.code === 'string' && typeof value.message === 'string') {
+            return value;
+        }
+        return null;
+    }
+    if (typeof value.error === 'string' && (typeof value.status_code === 'number' || typeof value.message === 'string')) {
+        return value;
+    }
+    return null;
+};
+const createProviderError = ({ provider, status, statusText, payload, responseText, cause }) => {
+    const error = new Error(`${provider} request failed: ${status} ${statusText}`.trim());
+    if (cause)
+        error.cause = cause;
+    error.status = status;
+    error.statusText = statusText;
+    if (payload !== undefined) {
+        error[`${provider.toLowerCase()}Response`] = payload;
+    }
+    if (responseText) {
+        error.responseText = responseText.slice(0, 512);
+    }
+    return error;
+};
+const messageLooksRetriable = (value) => RETRIABLE_MESSAGE_SNIPPETS.some((snippet) => value.includes(snippet));
+const isRetriableError = (provider, error) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+    const status = Number((_j = (_g = (_e = (_c = (_b = (_a = error === null || error === void 0 ? void 0 : error.status) !== null && _a !== void 0 ? _a : error === null || error === void 0 ? void 0 : error.statusCode) !== null && _b !== void 0 ? _b : error === null || error === void 0 ? void 0 : error.status_code) !== null && _c !== void 0 ? _c : (_d = error === null || error === void 0 ? void 0 : error.koiosResponse) === null || _d === void 0 ? void 0 : _d.status) !== null && _e !== void 0 ? _e : (_f = error === null || error === void 0 ? void 0 : error.koiosResponse) === null || _f === void 0 ? void 0 : _f.status_code) !== null && _g !== void 0 ? _g : (_h = error === null || error === void 0 ? void 0 : error.blockfrostResponse) === null || _h === void 0 ? void 0 : _h.status) !== null && _j !== void 0 ? _j : (_k = error === null || error === void 0 ? void 0 : error.blockfrostResponse) === null || _k === void 0 ? void 0 : _k.status_code);
+    if (RETRIABLE_STATUS_CODES.has(status))
+        return true;
+    const message = `${(_l = error === null || error === void 0 ? void 0 : error.message) !== null && _l !== void 0 ? _l : ''} ${(_o = (_m = error === null || error === void 0 ? void 0 : error.cause) === null || _m === void 0 ? void 0 : _m.message) !== null && _o !== void 0 ? _o : ''}`.toLowerCase();
+    if (messageLooksRetriable(message))
+        return true;
+    const code = `${(_p = error === null || error === void 0 ? void 0 : error.code) !== null && _p !== void 0 ? _p : ''}`.toLowerCase();
+    const causeCode = `${(_r = (_q = error === null || error === void 0 ? void 0 : error.cause) === null || _q === void 0 ? void 0 : _q.code) !== null && _r !== void 0 ? _r : ''}`.toLowerCase();
+    if (['und_err_socket', 'econnreset', 'etimedout', 'eai_again'].includes(code))
+        return true;
+    if (['und_err_socket', 'econnreset', 'etimedout', 'eai_again'].includes(causeCode))
+        return true;
+    const payload = provider === 'Koios' ? error === null || error === void 0 ? void 0 : error.koiosResponse : error === null || error === void 0 ? void 0 : error.blockfrostResponse;
+    const payloadMessage = `${(_t = (_s = payload === null || payload === void 0 ? void 0 : payload.message) !== null && _s !== void 0 ? _s : payload === null || payload === void 0 ? void 0 : payload.error) !== null && _t !== void 0 ? _t : ''}`.toLowerCase();
+    if (messageLooksRetriable(payloadMessage))
+        return true;
+    if (provider === 'Koios' && `${(_u = payload === null || payload === void 0 ? void 0 : payload.code) !== null && _u !== void 0 ? _u : ''}`.toLowerCase() === 'pgrst003')
+        return true;
+    return false;
+};
+exports.isRetriableError = isRetriableError;
+const defaultFetch = (url, init) => globalThis.fetch(url, init);
+const fetchProviderJson = async ({ provider, url, method = 'GET', headers, body, maxRetries = DEFAULT_MAX_RETRIES, retryBaseDelayMs = DEFAULT_RETRY_BASE_DELAY_MS, maxRps = DEFAULT_MAX_RPS, rateLimitKey = provider, fetcher = defaultFetch }) => {
+    var _a, _b, _c, _d;
+    let attempt = 0;
+    // Retry loop: exits only via return (success) or throw (non-retriable / retries exhausted).
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        try {
+            const response = await runRateLimitedTask(rateLimitKey, maxRps, () => fetcher(url, { method, headers, body }));
+            const responseText = await response.text();
+            const { value: parsed, parseError } = parseJson(responseText);
+            if (parseError && responseText) {
+                throw createProviderError({
+                    provider,
+                    status: response.status,
+                    statusText: response.statusText,
+                    responseText,
+                    cause: parseError
+                });
+            }
+            const payloadError = getProviderPayloadError(provider, parsed);
+            if (!response.ok || payloadError) {
+                const status = Number((_b = (_a = payloadError === null || payloadError === void 0 ? void 0 : payloadError.status_code) !== null && _a !== void 0 ? _a : payloadError === null || payloadError === void 0 ? void 0 : payloadError.status) !== null && _b !== void 0 ? _b : response.status);
+                const statusText = response.statusText || `${(_d = (_c = payloadError === null || payloadError === void 0 ? void 0 : payloadError.error) !== null && _c !== void 0 ? _c : payloadError === null || payloadError === void 0 ? void 0 : payloadError.message) !== null && _d !== void 0 ? _d : 'Request failed'}`;
+                throw createProviderError({ provider, status, statusText, payload: payloadError !== null && payloadError !== void 0 ? payloadError : parsed, responseText });
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (attempt >= maxRetries || !(0, exports.isRetriableError)(provider, error)) {
+                throw error;
+            }
+            attempt++;
+            await delay(retryBaseDelayMs * attempt);
+        }
+    }
+};
+exports.fetchProviderJson = fetchProviderJson;

package/environment/index.js

@@ -9,7 +9,7 @@ var ComputeEnvironment;
     ComputeEnvironment["AWS_EC2"] = "aws_ec2";
     ComputeEnvironment["AWS_OTHER"] = "aws_other";
     ComputeEnvironment["OTHER"] = "other";
-})(ComputeEnvironment = exports.ComputeEnvironment || (exports.ComputeEnvironment = {}));
+})(ComputeEnvironment || (exports.ComputeEnvironment = ComputeEnvironment = {}));
 class Environment {
     static async getComputeEnvironment() {
         if (process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.AWS_EXECUTION_ENV) {
@@ -73,14 +73,14 @@ class Environment {
             const response = await fetch('http://169.254.169.254/latest/meta-data/tags/instance/Name');
             return response.text();
         }
-        catch (err) {
+        catch (_a) {
             // swallow
         }
         try {
             const response = await fetch('http://169.254.169.254/latest/meta-data/instance-id');
             return response.text();
         }
-        catch (err) {
+        catch (_b) {
             // swallow
         }
         return null;
@@ -90,7 +90,7 @@ class Environment {
             const response = await fetch('http://169.254.170.2/v2/metadata');
             return await response.json();
         }
-        catch (err) {
+        catch (_a) {
             return null;
         }
     }

package/fn/index.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 interface AlbEvent {
     requestContext: {
         elb: {

package/fn/index.js

@@ -61,7 +61,7 @@ const invokeExpressViaAlb = async (albHandler, ctx, input) => {
         !/^text\//.test(ctype) &&
         !/(json|xml|x-www-form-urlencoded|javascript|graphql)/.test(ctype);
     const event = {
-        requestContext: { elb: { targetGroupArn: 'arn:kora:fn' } },
+        requestContext: { elb: { targetGroupArn: 'arn:kora:fn' } }, // marks this as an ALB event
         httpMethod: h.method,
         path: url.pathname,
         queryStringParameters: Object.keys(qs).length ? qs : null,

package/handles/api.js

@@ -23,7 +23,6 @@ class HandlesApi {
         return handleJson;
     }
     static async apiRequest(url, headers, body) {
-        body;
         if (!HandlesApi._host) {
             throw new Error('HandlesApi has not been initialized. Please call HandlesApi.init(<network>)');
         }

package/handles/constants.js

@@ -31,7 +31,7 @@ var ERROR_TEXT;
     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 = {}));
+})(ERROR_TEXT || (exports.ERROR_TEXT = ERROR_TEXT = {}));
 exports.HANDLES_PER_PAGE_MAX = 1000;
 exports.EMPTY = '|empty|';
 exports.TWELVE_HOURS_IN_SLOTS = 43200; // value comes from the securityParam here: https://cips.cardano.org/cips/cip9/#nonupdatableparameters then converted to slots

package/handles/interfaces/ScriptDetails.js

@@ -19,4 +19,4 @@ var ScriptType;
     ScriptType["HAL_REF_SPEND_PROXY"] = "halrefprx";
     ScriptType["HAL_REF_SPEND"] = "halref";
     ScriptType["HAL_ROYALTY_SPEND"] = "halroy";
-})(ScriptType = exports.ScriptType || (exports.ScriptType = {}));
+})(ScriptType || (exports.ScriptType = ScriptType = {}));

package/handles/interfaces/api.js

@@ -6,7 +6,7 @@ var UTxOFunctionName;
     UTxOFunctionName["ADD_UTXO"] = "addUtxo";
     UTxOFunctionName["UPDATE_HOLDER_INDEX"] = "updateHolderIndex";
     UTxOFunctionName["UPDATE_HANDLE_INDEXES"] = "updateHandleIndexes";
-})(UTxOFunctionName = exports.UTxOFunctionName || (exports.UTxOFunctionName = {}));
+})(UTxOFunctionName || (exports.UTxOFunctionName = UTxOFunctionName = {}));
 var LockedLambdaReason;
 (function (LockedLambdaReason) {
     LockedLambdaReason["REINDEX"] = "REINDEX";
@@ -16,7 +16,7 @@ var LockedLambdaReason;
     LockedLambdaReason["ROLLBACK_20"] = "ROLLBACK_20";
     LockedLambdaReason["UTXO_IMPORT"] = "UTXO_IMPORT";
     LockedLambdaReason["UNLOCKED"] = "";
-})(LockedLambdaReason = exports.LockedLambdaReason || (exports.LockedLambdaReason = {}));
+})(LockedLambdaReason || (exports.LockedLambdaReason = LockedLambdaReason = {}));
 var IndexNames;
 (function (IndexNames) {
     IndexNames["ADDRESS"] = "address";
@@ -39,4 +39,4 @@ var IndexNames;
     IndexNames["SUBHANDLE"] = "subhandle";
     IndexNames["UTXO"] = "utxo";
     IndexNames["UTXO_SLOT"] = "utxo_slot";
-})(IndexNames = exports.IndexNames || (exports.IndexNames = {}));
+})(IndexNames || (exports.IndexNames = IndexNames = {}));

package/handles/interfaces/index.d.ts

@@ -2,10 +2,10 @@ import { BoolInt, FeaturedItemType, HexString, HexStringOrEmpty } from '../../ty
 import type { ScriptDetails } from './ScriptDetails';
 import { UTxOWithTxInfo } from '../UTxO';
 export declare enum Rarity {
-    basic = "basic",
-    common = "common",
-    rare = "rare",
-    ultra_rare = "ultra_rare",
+    basic = "basic",// - 8-15 characters
+    common = "common",// - 4-7 characters
+    rare = "rare",// - 3 characters
+    ultra_rare = "ultra_rare",// - 2 characters
     legendary = "legendary"
 }
 export interface SocialItem {

package/handles/interfaces/index.js

@@ -22,18 +22,18 @@ var Rarity;
     Rarity["rare"] = "rare";
     Rarity["ultra_rare"] = "ultra_rare";
     Rarity["legendary"] = "legendary"; // - 1 character
-})(Rarity = exports.Rarity || (exports.Rarity = {}));
+})(Rarity || (exports.Rarity = Rarity = {}));
 var HandleType;
 (function (HandleType) {
     HandleType["VIRTUAL_SUBHANDLE"] = "virtual_subhandle";
     HandleType["NFT_SUBHANDLE"] = "nft_subhandle";
     HandleType["HANDLE"] = "handle";
-})(HandleType = exports.HandleType || (exports.HandleType = {}));
+})(HandleType || (exports.HandleType = HandleType = {}));
 var SubHandleType;
 (function (SubHandleType) {
     SubHandleType["VIRTUAL"] = "virtual";
     SubHandleType["NFT"] = "nft";
-})(SubHandleType = exports.SubHandleType || (exports.SubHandleType = {}));
+})(SubHandleType || (exports.SubHandleType = SubHandleType = {}));
 var OAuthSocial;
 (function (OAuthSocial) {
     OAuthSocial[OAuthSocial["twitter"] = 0] = "twitter";
@@ -55,7 +55,7 @@ var OAuthSocial;
     OAuthSocial[OAuthSocial["spotify"] = 16] = "spotify";
     OAuthSocial[OAuthSocial["soundcloud"] = 17] = "soundcloud";
     OAuthSocial[OAuthSocial["paypal"] = 18] = "paypal";
-})(OAuthSocial = exports.OAuthSocial || (exports.OAuthSocial = {}));
+})(OAuthSocial || (exports.OAuthSocial = OAuthSocial = {}));
 var AvailabilityResponseCode;
 (function (AvailabilityResponseCode) {
     AvailabilityResponseCode[AvailabilityResponseCode["AVAILABLE"] = 200] = "AVAILABLE";
@@ -63,5 +63,5 @@ var AvailabilityResponseCode;
     AvailabilityResponseCode[AvailabilityResponseCode["NOT_AVAILABLE_FOR_LEGAL_REASONS"] = 451] = "NOT_AVAILABLE_FOR_LEGAL_REASONS";
     AvailabilityResponseCode[AvailabilityResponseCode["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
     AvailabilityResponseCode[AvailabilityResponseCode["LOCKED"] = 423] = "LOCKED";
-})(AvailabilityResponseCode = exports.AvailabilityResponseCode || (exports.AvailabilityResponseCode = {}));
+})(AvailabilityResponseCode || (exports.AvailabilityResponseCode = AvailabilityResponseCode = {}));
 __exportStar(require("./WalletHandle"), exports);

package/handles/policies.js

@@ -18,7 +18,7 @@ exports.HANDLE_POLICIES = {
     getActivePolicy(network, isDeMi = false, atSlot) {
         var _a;
         const theSlot = atSlot ? atSlot : (0, utils_1.getSlotNumberFromDate)(new Date(Date.now()));
-        return (_a = Object.entries(this[network]).find(([, value]) => { var _a; return value.firstMintingSlot <= theSlot && ((_a = value.lastMintingSlot) !== null && _a !== void 0 ? _a : Number.POSITIVE_INFINITY) >= theSlot && value.isDeMi == isDeMi; })) === null || _a === void 0 ? void 0 : _a[0];
+        return (_a = Object.entries(this[network]).find(([, value]) => { var _a, _b; return value.firstMintingSlot <= theSlot && ((_a = value.lastMintingSlot) !== null && _a !== void 0 ? _a : Number.POSITIVE_INFINITY) >= theSlot && ((_b = value.isDeMi) !== null && _b !== void 0 ? _b : false) == isDeMi; })) === null || _a === void 0 ? void 0 : _a[0];
     },
     contains(network, policyId) {
         return Object.keys(this[network]).includes(policyId);

package/handles/utils.d.ts

@@ -7,7 +7,7 @@ export declare const buildMetadata: ({ handleName, handleType, cid, ogNumber }:
     handleName: string;
     handleType: HandleType;
     cid: string;
-    ogNumber?: number | undefined;
+    ogNumber?: number;
 }) => IHandleMetadata;
 export declare const checkHandlePattern: (handle: string, root?: string) => {
     valid: boolean;

package/logger/index.js

@@ -26,7 +26,7 @@ var LogCategory;
     LogCategory["FATAL"] = "FATAL";
     LogCategory["NOTIFY"] = "NOTIFY";
     LogCategory["USER_ISSUE"] = "USER_ISSUE";
-})(LogCategory = exports.LogCategory || (exports.LogCategory = {}));
+})(LogCategory || (exports.LogCategory = LogCategory = {}));
 const ANSI_RESET = '\x1b[0m';
 const ANSI_BLUE = '\x1b[34m';
 const ANSI_GREEN = '\x1b[32m';

package/mpt/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeMintingDataRoot = exports.buildMintingDataTrie = exports.Trie = exports.labelSet = void 0;
 // Server-only (Node) MPT module. Pulls @aiken-lang/merkle-patricia-forestry (native `level`/`blake2b`)

package/mpt/labelSet.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 /** Does the canonical label set contain `label`? */
 export declare const contains: (set: string, label: string) => boolean;
 /** Insert `label`, keeping the set sorted ascending. Throws if already present. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "6.9.4",
+    "version": "6.10.0",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",
@@ -43,12 +43,12 @@
         "@types/jest": "^30.0.0",
         "@types/node": "^22.15.17",
         "@types/pluralize": "^0.0.29",
-        "@typescript-eslint/eslint-plugin": "^7.6.0",
-        "@typescript-eslint/parser": "^7.6.0",
-        "eslint": "^8.57.0",
+        "@typescript-eslint/eslint-plugin": "^8.67.0",
+        "@typescript-eslint/parser": "^8.67.0",
+        "eslint": "^8.57.1",
         "jest": "^30.4.2",
         "ts-jest": "^29.4.11",
-        "typescript": "^4.7.3"
+        "typescript": "^5.9.3"
     },
     "dependencies": {
         "@aws-sdk/client-kms": "^3.1003.0",
@@ -63,8 +63,8 @@
         "pluralize-esm": "^9.0.5"
     },
     "overrides": {
-        "js-yaml": "4.3.0",
-        "brace-expansion": "5.0.8"
+        "js-yaml": "4.3.1",
+        "brace-expansion": "5.0.9"
     },
     "peerDependencies": {
         "@aiken-lang/merkle-patricia-forestry": "^1.2.0"

package/types/index.js

@@ -32,14 +32,14 @@ var AssetNameLabel;
     AssetNameLabel["LBL_100"] = "000643b0";
     AssetNameLabel["LBL_222"] = "000de140";
     AssetNameLabel["LBL_444"] = "001bc280";
-})(AssetNameLabel = exports.AssetNameLabel || (exports.AssetNameLabel = {}));
+})(AssetNameLabel || (exports.AssetNameLabel = AssetNameLabel = {}));
 var CardanoNetwork;
 (function (CardanoNetwork) {
     CardanoNetwork["MAINNET"] = "MAINNET";
     CardanoNetwork["PREPROD"] = "PREPROD";
     CardanoNetwork["PREVIEW"] = "PREVIEW";
     CardanoNetwork["UNSET"] = "UNSET";
-})(CardanoNetwork = exports.CardanoNetwork || (exports.CardanoNetwork = {}));
+})(CardanoNetwork || (exports.CardanoNetwork = CardanoNetwork = {}));
 var AddressType;
 (function (AddressType) {
     AddressType["Wallet"] = "wallet";
@@ -48,9 +48,9 @@ var AddressType;
     AddressType["Reward"] = "reward";
     AddressType["Other"] = "other";
     AddressType["Drep"] = "drep";
-})(AddressType = exports.AddressType || (exports.AddressType = {}));
+})(AddressType || (exports.AddressType = AddressType = {}));
 var StakeAddressType;
 (function (StakeAddressType) {
     StakeAddressType["Script"] = "f";
     StakeAddressType["Key"] = "e";
-})(StakeAddressType = exports.StakeAddressType || (exports.StakeAddressType = {}));
+})(StakeAddressType || (exports.StakeAddressType = StakeAddressType = {}));

package/types/profile-header.js

@@ -7,11 +7,11 @@ var ProfileHeaderBannerImageTypes;
     ProfileHeaderBannerImageTypes["circuit_board"] = "circuit_board";
     ProfileHeaderBannerImageTypes["hidden"] = "hidden";
     ProfileHeaderBannerImageTypes["asset"] = "asset";
-})(ProfileHeaderBannerImageTypes = exports.ProfileHeaderBannerImageTypes || (exports.ProfileHeaderBannerImageTypes = {}));
+})(ProfileHeaderBannerImageTypes || (exports.ProfileHeaderBannerImageTypes = ProfileHeaderBannerImageTypes = {}));
 var ProfileHeaderPFPImageTypes;
 (function (ProfileHeaderPFPImageTypes) {
     ProfileHeaderPFPImageTypes["personalized_handle"] = "personalized_handle";
     ProfileHeaderPFPImageTypes["pfp"] = "pfp";
     ProfileHeaderPFPImageTypes["hidden"] = "hidden";
     ProfileHeaderPFPImageTypes["asset"] = "asset";
-})(ProfileHeaderPFPImageTypes = exports.ProfileHeaderPFPImageTypes || (exports.ProfileHeaderPFPImageTypes = {}));
+})(ProfileHeaderPFPImageTypes || (exports.ProfileHeaderPFPImageTypes = ProfileHeaderPFPImageTypes = {}));

package/utils/cbor/index.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 export { designerSchema } from './schema/designer';
 export { handleDatumSchema } from './schema/handleData';
 export { marketplaceDatumSchema } from './schema/marketplaceDatum';
@@ -44,8 +42,8 @@ declare class JsonToDatumObject {
     json: any;
     options: EncodeOptions;
     constructor(json: any, options?: EncodeOptions);
-    getFormattedKey: (key: string) => string | number | Buffer;
-    getHexOrString: (str: string) => string | Buffer;
+    getFormattedKey: (key: string) => string | number | Buffer<ArrayBuffer>;
+    getHexOrString: (str: string) => string | Buffer<ArrayBuffer>;
     encodeCBOR: (encoder: any) => any;
     keyIsNumeric: (key: any) => boolean | undefined;
 }
@@ -57,6 +55,6 @@ export declare const encodeJsonToDatum: (json: any, options?: EncodeOptions) =>
 export declare const decodeCborToJson: ({ cborString, schema, defaultKeyType, forJson }: {
     cborString: string;
     schema?: any;
-    defaultKeyType?: DefaultTextFormat | undefined;
-    forJson?: boolean | undefined;
+    defaultKeyType?: DefaultTextFormat;
+    forJson?: boolean;
 }) => any;

package/utils/cbor/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeCborToJson = exports.encodeJsonToDatum = exports.DupeKey = exports.DefaultTextFormat = exports.subHandleSettingsDatumSchema = exports.socialsSchema = exports.portalSchema = exports.marketplaceDatumSchema = exports.handleDatumSchema = exports.designerSchema = void 0;
 const boolean_1 = require("boolean");
@@ -53,7 +63,7 @@ var DefaultTextFormat;
 (function (DefaultTextFormat) {
     DefaultTextFormat["UTF8"] = "utf8";
     DefaultTextFormat["HEX"] = "hex";
-})(DefaultTextFormat = exports.DefaultTextFormat || (exports.DefaultTextFormat = {}));
+})(DefaultTextFormat || (exports.DefaultTextFormat = DefaultTextFormat = {}));
 class JsonToDatumObject {
     constructor(json, options) {
         var _a, _b;

package/utils/crypto/index.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { AddressDetails, AddressType, AssetNameLabel } from '../../types';
 export declare const getNativeCrypto: () => Promise<any>;
 export declare function dec2hex(dec: number): string;
@@ -18,8 +16,8 @@ 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) => string | null;
-export declare const bech32FromHex: (hex: string, isTestnet?: boolean, type?: 'addr' | 'stake' | 'pool' | 'drep' | 'cc_hot' | 'cc_cold') => string;
-export declare const bech32AddressFromHashes: (paymentHash: string, paymentHashType?: 'key' | 'script', stakeHash?: string, stakeHashType?: 'key' | 'script', type?: 'addr' | 'stake', isTestnet?: boolean) => string;
+export declare const bech32FromHex: (hex: string, isTestnet?: boolean, type?: "addr" | "stake" | "pool" | "drep" | "cc_hot" | "cc_cold") => string;
+export declare const bech32AddressFromHashes: (paymentHash: string, paymentHashType?: "key" | "script", stakeHash?: string, stakeHashType?: "key" | "script", type?: "addr" | "stake", isTestnet?: boolean) => string;
 export declare const buildHolderInfo: (addr: string) => AddressDetails;
 export declare const getDateStringFromSlot: (currentSlot: number) => Date;
 export declare const getSlotNumberFromDate: (date: Date) => number;

package/utils/crypto/index.js

@@ -15,18 +15,32 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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.blake2b = exports.addressHexToBech32 = exports.getSlotNumberFromDate = exports.getDateStringFromSlot = exports.buildHolderInfo = exports.bech32AddressFromHashes = 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;
+exports.blake2b = exports.addressHexToBech32 = exports.getSlotNumberFromDate = exports.getDateStringFromSlot = exports.buildHolderInfo = exports.bech32AddressFromHashes = exports.bech32FromHex = exports.getPaymentKeyHash = exports.buildStakeKey = exports.buildPaymentAddressType = exports.getPaymentAddressType = exports.checkNameLabel = exports.parseAssetNameLabel = exports.decodeAddress = exports.sha256 = exports.getNativeCrypto = void 0;
+exports.dec2hex = dec2hex;
+exports.getRandomCodeVerifier = getRandomCodeVerifier;
+exports.base64urlencode = base64urlencode;
+exports.getChallengeFromVerifier = getChallengeFromVerifier;
 const bech32_1 = require("bech32");
 const blakejs_1 = require("blakejs");
 const bs58_1 = __importDefault(require("bs58"));
@@ -48,14 +62,12 @@ exports.getNativeCrypto = getNativeCrypto;
 function dec2hex(dec) {
     return ('0' + dec.toString(16)).slice(-2);
 }
-exports.dec2hex = dec2hex;
 async function getRandomCodeVerifier(length) {
     const crypto = await (0, exports.getNativeCrypto)();
     const array = new Uint32Array(length / 2);
     crypto.getRandomValues(array);
     return Array.from(array, dec2hex).join('');
 }
-exports.getRandomCodeVerifier = getRandomCodeVerifier;
 const sha256 = async (plain) => {
     const crypto = await (0, exports.getNativeCrypto)();
     const encoder = new TextEncoder();
@@ -75,20 +87,18 @@ function base64urlencode(a) {
         .replace(/\//g, '_')
         .replace(/=+$/, '');
 }
-exports.base64urlencode = base64urlencode;
 async function getChallengeFromVerifier(verifier) {
     const hashed = await (0, exports.sha256)(verifier);
     const base64encoded = base64urlencode(hashed);
     return base64encoded;
 }
-exports.getChallengeFromVerifier = getChallengeFromVerifier;
 const decodeAddress = (address) => {
     try {
         const addressWords = bech32_1.bech32.decode(address, address.length);
         const payload = bech32_1.bech32.fromWords(addressWords.words);
         return `${Buffer.from(payload).toString('hex')}`;
     }
-    catch (error) {
+    catch (_a) {
         return null;
     }
 };

package/utils/index.d.ts

@@ -13,18 +13,18 @@ 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 hasOwnProperty: (o: any, ...args: [v: PropertyKey]) => boolean;
+export declare const isDate: (d: any) => d is Date;
 export declare const isEmptyObject: (o: any) => boolean;
 export declare const makeObjectWithoutPrototype: () => any;
-export declare const ExcludesFalse: <T>(n?: T | null | undefined) => n is T;
+export declare const ExcludesFalse: <T>(n?: T | undefined | null) => n is T;
 export declare const diff: (lhs: any, rhs: any) => any;
 export declare const mapStringifyReplacer: (_key: any, value: any) => any;
 export declare const mapNoKeysStringifyReplacer: (_key: any, value: any) => any;
 export declare const USER_ISSUE_TRACKING_ID_REGEX: RegExp;
 export declare const createUserIssueTrackingId: ({ timestamp, random }?: {
-    timestamp?: number | undefined;
-    random?: (() => number) | undefined;
+    timestamp?: number;
+    random?: () => number;
 }) => string;
 export declare const isUserIssueTrackingId: (value: unknown) => value is string;
 export declare const normalizeUserIssueEventSegment: (value: string) => string;