@koralabs/kora-labs-common 6.9.4 → 6.11.0

package/chain/providers/Blockfrost.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Blockfrost = void 0;
+const types_1 = require("../../types");
+const fetchProviderJson_1 = require("../transport/fetchProviderJson");
+const imageDatum_1 = require("../datum/imageDatum");
+const providerConfig_1 = require("../providerConfig");
+class Blockfrost {
+    constructor(config) {
+        this.config = config;
+        this.name = 'Blockfrost';
+    }
+    async fetchBlockfrost(path) {
+        var _a;
+        const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+        const url = `https://cardano-${this.config.network.toLowerCase()}.blockfrost.io/api/v0/${normalizedPath}`;
+        return (0, fetchProviderJson_1.fetchProviderJson)({
+            provider: 'Blockfrost',
+            url,
+            headers: {
+                'Content-Type': 'application/json',
+                project_id: (_a = this.config.blockfrostApiKey) !== null && _a !== void 0 ? _a : ''
+            }
+        });
+    }
+    async getDrepMetadata(drepId) {
+        return await this.fetchBlockfrost(`/governance/dreps/${drepId}/metadata`);
+    }
+    async getLatestBlock() {
+        return await this.fetchBlockfrost('blocks/latest');
+    }
+    async getLatestTransactionForAsset(policyId, hex) {
+        var _a;
+        const res = await this.fetchBlockfrost(`/assets/${policyId}${hex}/transactions?order=desc`);
+        const [tx] = res;
+        return (_a = tx === null || tx === void 0 ? void 0 : tx.tx_hash) !== null && _a !== void 0 ? _a : null;
+    }
+    async getAssets(policyId) {
+        var _a;
+        const res = await this.fetchBlockfrost(`/assets/policy/${policyId}`);
+        if (!Array.isArray(res))
+            return [];
+        return ((_a = res === null || res === void 0 ? void 0 : res.reduce((agg, item) => {
+            const { asset, quantity } = item;
+            const [, hex] = asset.split(policyId);
+            if (hex.includes(types_1.AssetNameLabel.LBL_100) || quantity === '0')
+                return agg;
+            agg.push({ policyId, hex });
+            return agg;
+        }, [])) !== null && _a !== void 0 ? _a : []);
+    }
+    async getAssetUtxo(policyId, hex) {
+        var _a;
+        // A BURN that only spends the asset is NOT listed by /assets/{asset}/transactions, so
+        // getLatestTransactionForAsset returns the pre-burn output tx and the asset is still in its
+        // (now-spent) outputs — we'd resurrect a de-indexed handle. /assets DOES reflect the burn
+        // (quantity 0), so gate on current supply first: a burned (or absent) asset resolves to null.
+        const info = await this.fetchBlockfrost(`/assets/${policyId}${hex}`);
+        if (!info || info.status_code === 404 || String(info.quantity) === '0')
+            return null;
+        const tx = await this.getLatestTransactionForAsset(policyId, hex);
+        if (!tx)
+            return null;
+        const res = await this.fetchBlockfrost(`/txs/${tx}/utxos`);
+        const asset = (_a = res === null || res === void 0 ? void 0 : res.outputs) === null || _a === void 0 ? void 0 : _a.find((output) => output.amount.some((a) => a.unit === `${policyId}${hex}`));
+        // Defensive: if the latest tx lists the asset only in inputs, return null.
+        if (!asset)
+            return null;
+        return { ...asset, tx_hash: tx };
+    }
+    async getDatumFromHash(datumHash) {
+        const result = await this.fetchBlockfrost(`/scripts/datum/${datumHash}/cbor`);
+        if (result.status)
+            return null;
+        return result.cbor;
+    }
+    async getAssetDatum(policyId, hex) {
+        var _a;
+        const asset = await this.getAssetUtxo(policyId, hex);
+        return (_a = asset === null || asset === void 0 ? void 0 : asset.inline_datum) !== null && _a !== void 0 ? _a : null;
+    }
+    async getCip25AssetImage(policyId, hex) {
+        var _a, _b;
+        const res = await this.fetchBlockfrost(`/assets/${policyId}${hex}`);
+        let image = (_b = (_a = res === null || res === void 0 ? void 0 : res.onchain_metadata) === null || _a === void 0 ? void 0 : _a.image) !== null && _b !== void 0 ? _b : null;
+        if (Array.isArray(image))
+            image = image.join('');
+        return image;
+    }
+    async getRefScriptCbor(tx, policyId, hex) {
+        const res = await this.fetchBlockfrost(`/txs/${tx}/utxos`);
+        const output = res.outputs.find((o) => o.amount.some((a) => a.unit === `${policyId}${hex}`));
+        const scriptHash = output === null || output === void 0 ? void 0 : output.reference_script_hash;
+        const { cbor } = await this.fetchBlockfrost(`/scripts/${scriptHash}/cbor`);
+        return cbor;
+    }
+    async getTxUtxos(tx) {
+        return await this.fetchBlockfrost(`/txs/${tx}/utxos`);
+    }
+    async getAssetsByStakeKey(stakeKey) {
+        const result = [];
+        let hasResults = true;
+        let page = 1;
+        while (hasResults) {
+            const items = await this.fetchBlockfrost(`/accounts/${stakeKey}/addresses/assets?count=100&page=${page}`);
+            if (items.length === 0)
+                hasResults = false;
+            result.push(...items.map((item) => ({ asset: item.unit, amount: item.quantity })));
+            page++;
+        }
+        return result;
+    }
+    async getBackgroundImageDetails(policyId, hex) {
+        var _a;
+        const data = await this.fetchBlockfrost(`/assets/${policyId}${hex}`);
+        const updateHex = hex.startsWith(types_1.AssetNameLabel.LBL_222) || hex.startsWith(types_1.AssetNameLabel.LBL_444)
+            ? `${types_1.AssetNameLabel.LBL_100}${hex.replace(types_1.AssetNameLabel.LBL_222, '').replace(types_1.AssetNameLabel.LBL_444, '')}`
+            : hex;
+        const datum = await this.getAssetDatum(policyId, updateHex);
+        if (datum) {
+            return (0, imageDatum_1.getImageDataFromDatum)((_a = this.config.apiHost) !== null && _a !== void 0 ? _a : (0, providerConfig_1.defaultApiHost)(this.config.network), datum);
+        }
+        let image = '';
+        if ((data === null || data === void 0 ? void 0 : data.onchain_metadata) && (data === null || data === void 0 ? void 0 : data.onchain_metadata.image)) {
+            image = data === null || data === void 0 ? void 0 : data.onchain_metadata.image;
+        }
+        return { image, metadata: data === null || data === void 0 ? void 0 : data.onchain_metadata };
+    }
+    async getAddressInfo(bech32Address) {
+        const result = await this.fetchBlockfrost(`/addresses/${bech32Address}`);
+        return {
+            address: result.address,
+            amount: result.amount,
+            stake_address: result.stake_address,
+            script: result.script
+        };
+    }
+    async getAddressUTxOs(bech32Address) {
+        return await this.fetchBlockfrost(`/addresses/${bech32Address}/utxos`);
+    }
+}
+exports.Blockfrost = Blockfrost;

package/chain/providers/Koios.d.ts

@@ -0,0 +1,68 @@
+import { ICreatorDefaults } from '../../handles/interfaces';
+import { AccountAsset, AddressInfo, ChainProvider, ChainProviderAsset, ChainProviderUtxo } from '../failover/interfaces';
+import { ChainProviderConfig } from '../providerConfig';
+interface KoiosAsset {
+    quantity: string;
+    policy_id: string;
+    asset_name: string;
+}
+interface KoiosTxOutput {
+    value: string;
+    tx_hash: string;
+    tx_index: number;
+    asset_list: KoiosAsset[];
+    datum_hash: string | null;
+    stake_addr: string;
+    inline_datum: {
+        bytes: string | null;
+        value: string | null;
+    } | null;
+    payment_addr: {
+        bech32: string;
+    };
+    reference_script: {
+        bytes: string | null;
+        hash: string | null;
+    } | null;
+}
+export declare const buildKoiosHeaders: (bearerToken: string | undefined) => {
+    Authorization?: string | undefined;
+    'Content-Type': string;
+};
+export declare const buildKoiosAddressUtxoRequestBody: (bech32Address: string) => {
+    _addresses: string[];
+    _extended: boolean;
+};
+export declare class Koios implements ChainProvider {
+    private readonly config;
+    name: string;
+    constructor(config: ChainProviderConfig);
+    private fetchKoios;
+    getLatestBlock(): Promise<{
+        height: number;
+        slot: number;
+        time: number;
+    }>;
+    getLatestTransactionForAsset(policyId: string, hex: string): Promise<string | null>;
+    getAssets(policyId: string): Promise<{
+        policyId: string;
+        hex: string;
+    }[]>;
+    getAssetUtxo(policyId: string, hex: string): Promise<ChainProviderAsset | null>;
+    getDatumFromHash(datumHash: string): Promise<string | null>;
+    getAssetDatum(policyId: string, hex: string): Promise<string | null>;
+    getRefScriptCbor(tx: string, policyId: string, hex: string): Promise<string>;
+    buildChainProviderAsset(output: KoiosTxOutput): Promise<ChainProviderAsset>;
+    getTxUtxos(tx: string): Promise<ChainProviderUtxo>;
+    getAssetsByStakeKey(stakeKey: string): Promise<AccountAsset[]>;
+    getAssetMetadata(policyId: string, hex: string): Promise<Record<string, unknown> | undefined>;
+    getCip25AssetImage(policyId: string, hex: string): Promise<string | null>;
+    getBackgroundImageDetails(policyId: string, hex: string): Promise<{
+        image: string;
+        creatorDefaults?: ICreatorDefaults;
+        metadata?: Record<string, unknown>;
+    }>;
+    getAddressInfo(bech32Address: string): Promise<AddressInfo>;
+    getAddressUTxOs(bech32Address: string): Promise<ChainProviderAsset[]>;
+}
+export {};

package/chain/providers/Koios.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Koios = exports.buildKoiosAddressUtxoRequestBody = exports.buildKoiosHeaders = void 0;
+const types_1 = require("../../types");
+const fetchProviderJson_1 = require("../transport/fetchProviderJson");
+const imageDatum_1 = require("../datum/imageDatum");
+const providerConfig_1 = require("../providerConfig");
+const buildKoiosHeaders = (bearerToken) => ({
+    'Content-Type': 'application/json',
+    ...(bearerToken ? { Authorization: `Bearer ${bearerToken}` } : {})
+});
+exports.buildKoiosHeaders = buildKoiosHeaders;
+const buildKoiosAddressUtxoRequestBody = (bech32Address) => ({
+    _addresses: [bech32Address],
+    _extended: true
+});
+exports.buildKoiosAddressUtxoRequestBody = buildKoiosAddressUtxoRequestBody;
+class Koios {
+    constructor(config) {
+        this.config = config;
+        this.name = 'Koios';
+    }
+    async fetchKoios(path, method = 'GET', body) {
+        const network = this.config.network.toLowerCase();
+        const host = network === 'mainnet' ? 'api' : network;
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        const url = `https://${host}.koios.rest/api/v1${normalizedPath}`;
+        return (0, fetchProviderJson_1.fetchProviderJson)({
+            provider: 'Koios',
+            url,
+            method,
+            headers: (0, exports.buildKoiosHeaders)(this.config.koiosBearerToken),
+            body
+        });
+    }
+    async getLatestBlock() {
+        const blocks = await this.fetchKoios('/blocks');
+        const latestBlock = blocks[0];
+        return { height: latestBlock.block_height, slot: latestBlock.abs_slot, time: latestBlock.block_time };
+    }
+    async getLatestTransactionForAsset(policyId, hex) {
+        var _a;
+        const res = await this.fetchKoios(`/asset_txs?_asset_policy=${policyId}&_asset_name=${hex}`);
+        const [tx] = res;
+        return (_a = tx === null || tx === void 0 ? void 0 : tx.tx_hash) !== null && _a !== void 0 ? _a : null;
+    }
+    async getAssets(policyId) {
+        var _a;
+        const res = await this.fetchKoios(`/policy_asset_list?_asset_policy=${policyId}`);
+        if (!Array.isArray(res))
+            return [];
+        return ((_a = res === null || res === void 0 ? void 0 : res.reduce((agg, item) => {
+            const { asset_name, total_supply } = item;
+            if (asset_name.includes(types_1.AssetNameLabel.LBL_100) || total_supply === '0')
+                return agg;
+            agg.push({ policyId, hex: asset_name });
+            return agg;
+        }, [])) !== null && _a !== void 0 ? _a : []);
+    }
+    async getAssetUtxo(policyId, hex) {
+        var _a, _b, _c;
+        const tx = await this.getLatestTransactionForAsset(policyId, hex);
+        if (!tx)
+            return null;
+        const payload = { _tx_hashes: [tx], _metadata: true, _assets: true, _scripts: true, _bytecode: true };
+        const res = await this.fetchKoios(`/tx_info`, 'POST', JSON.stringify(payload));
+        const [firstTransaction] = res;
+        const output = (_a = firstTransaction === null || firstTransaction === void 0 ? void 0 : firstTransaction.outputs) === null || _a === void 0 ? void 0 : _a.find((o) => o.asset_list.some((a) => a.policy_id === policyId && a.asset_name === hex));
+        if (!output)
+            return null;
+        const amount = output.asset_list.map((a) => ({
+            unit: `${a.policy_id}${a.asset_name}`,
+            quantity: a.quantity
+        }));
+        amount.push({ unit: 'lovelace', quantity: output.value });
+        const chainProviderAsset = {
+            address: output.payment_addr.bech32,
+            amount,
+            inline_datum: (_c = (_b = output.inline_datum) === null || _b === void 0 ? void 0 : _b.bytes) !== null && _c !== void 0 ? _c : null,
+            output_index: output.tx_index,
+            tx_hash: firstTransaction.tx_hash,
+            data_hash: output.datum_hash
+        };
+        return { ...chainProviderAsset, tx_hash: tx };
+    }
+    async getDatumFromHash(datumHash) {
+        const result = await this.fetchKoios(`/datum_info`, 'POST', JSON.stringify({ _datum_hashes: [datumHash] }));
+        const [firstResult] = result;
+        return firstResult ? firstResult.bytes : null;
+    }
+    async getAssetDatum(policyId, hex) {
+        var _a, _b;
+        const assetUtxos = await this.fetchKoios(`/asset_utxos`, 'POST', JSON.stringify({ _asset_list: [[policyId, hex]], _extended: true }));
+        const utxo = assetUtxos === null || assetUtxos === void 0 ? void 0 : assetUtxos.find((u) => u.asset_list.some((a) => a.policy_id === policyId && a.asset_name === hex));
+        if ((_a = utxo === null || utxo === void 0 ? void 0 : utxo.inline_datum) === null || _a === void 0 ? void 0 : _a.bytes)
+            return utxo.inline_datum.bytes;
+        if (!((_b = utxo === null || utxo === void 0 ? void 0 : utxo.inline_datum) === null || _b === void 0 ? void 0 : _b.bytes) && (utxo === null || utxo === void 0 ? void 0 : utxo.datum_hash))
+            return this.getDatumFromHash(utxo.datum_hash);
+        return null;
+    }
+    async getRefScriptCbor(tx, policyId, hex) {
+        var _a;
+        const { outputs } = await this.getTxUtxos(tx);
+        const output = outputs.find((o) => o.amount.some((a) => a.unit === `${policyId}${hex}`));
+        return (_a = output === null || output === void 0 ? void 0 : output.reference_script_cbor) !== null && _a !== void 0 ? _a : '';
+    }
+    async buildChainProviderAsset(output) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const amount = output.asset_list.map((a) => ({
+            unit: `${a.policy_id}${a.asset_name}`,
+            quantity: a.quantity
+        }));
+        amount.push({ unit: 'lovelace', quantity: output.value });
+        const inline_datum = !((_a = output === null || output === void 0 ? void 0 : output.inline_datum) === null || _a === void 0 ? void 0 : _a.bytes) && (output === null || output === void 0 ? void 0 : output.datum_hash)
+            ? await this.getDatumFromHash(output.datum_hash)
+            : (_c = (_b = output.inline_datum) === null || _b === void 0 ? void 0 : _b.bytes) !== null && _c !== void 0 ? _c : null;
+        return {
+            address: output.payment_addr.bech32,
+            amount,
+            inline_datum,
+            output_index: output.tx_index,
+            tx_hash: output.tx_hash,
+            data_hash: output.datum_hash,
+            reference_script_hash: (_e = (_d = output.reference_script) === null || _d === void 0 ? void 0 : _d.hash) !== null && _e !== void 0 ? _e : null,
+            reference_script_cbor: (_g = (_f = output.reference_script) === null || _f === void 0 ? void 0 : _f.bytes) !== null && _g !== void 0 ? _g : null
+        };
+    }
+    async getTxUtxos(tx) {
+        var _a;
+        const res = await this.fetchKoios(`/tx_info`, 'POST', JSON.stringify({ _tx_hashes: [tx], _metadata: true, _assets: true }));
+        const [firstTransaction] = res;
+        const outputs = [];
+        for (const output of (_a = firstTransaction === null || firstTransaction === void 0 ? void 0 : firstTransaction.outputs) !== null && _a !== void 0 ? _a : []) {
+            outputs.push(await this.buildChainProviderAsset(output));
+        }
+        return { outputs };
+    }
+    async getAssetsByStakeKey(stakeKey) {
+        const items = await this.fetchKoios(`/account_assets`, 'POST', JSON.stringify({ _stake_addresses: [stakeKey] }));
+        return items.reduce((agg, item) => {
+            const { policy_id, asset_name, quantity } = item;
+            if (quantity === '0')
+                return agg;
+            agg.push({ asset: `${policy_id}${asset_name}`, amount: quantity });
+            return agg;
+        }, []);
+    }
+    async getAssetMetadata(policyId, hex) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const assetInfo = await this.fetchKoios(`/asset_info`, 'POST', JSON.stringify({ _asset_list: [[policyId, hex]] }));
+        const [result] = assetInfo;
+        let metadata = (_c = (_b = (_a = result === null || result === void 0 ? void 0 : result.minting_tx_metadata) === null || _a === void 0 ? void 0 : _a['721']) === null || _b === void 0 ? void 0 : _b[policyId]) === null || _c === void 0 ? void 0 : _c[hex];
+        if (!metadata) {
+            const assetName = Buffer.from(hex, 'hex').toString('utf-8');
+            metadata = (_f = (_e = (_d = result === null || result === void 0 ? void 0 : result.minting_tx_metadata) === null || _d === void 0 ? void 0 : _d['721']) === null || _e === void 0 ? void 0 : _e[policyId]) === null || _f === void 0 ? void 0 : _f[assetName];
+            if (!metadata && (result === null || result === void 0 ? void 0 : result.token_registry_metadata)) {
+                metadata = { image: `data:image/png;base64,${(_g = result.token_registry_metadata.logo) !== null && _g !== void 0 ? _g : ''}` };
+            }
+        }
+        return metadata;
+    }
+    async getCip25AssetImage(policyId, hex) {
+        var _a;
+        const metadata = await this.getAssetMetadata(policyId, hex);
+        if (!metadata)
+            return null;
+        let image = (_a = metadata.image) !== null && _a !== void 0 ? _a : null;
+        if (Array.isArray(image))
+            image = image.join('');
+        return image;
+    }
+    async getBackgroundImageDetails(policyId, hex) {
+        var _a;
+        const updateHex = hex.startsWith(types_1.AssetNameLabel.LBL_222) || hex.startsWith(types_1.AssetNameLabel.LBL_444)
+            ? `${types_1.AssetNameLabel.LBL_100}${hex.replace(types_1.AssetNameLabel.LBL_222, '').replace(types_1.AssetNameLabel.LBL_444, '')}`
+            : hex;
+        const datum = await this.getAssetDatum(policyId, updateHex);
+        const metadata = await this.getAssetMetadata(policyId, hex);
+        let image = '';
+        if (metadata && metadata.image)
+            image = metadata.image;
+        if (datum) {
+            return (0, imageDatum_1.getImageDataFromDatum)((_a = this.config.apiHost) !== null && _a !== void 0 ? _a : (0, providerConfig_1.defaultApiHost)(this.config.network), datum);
+        }
+        return { image, metadata };
+    }
+    async getAddressInfo(bech32Address) {
+        const result = (await this.fetchKoios(`/address_info`, 'POST', JSON.stringify({ _addresses: [bech32Address] })))[0];
+        const balance = {};
+        result.utxo_set.forEach((utxo) => {
+            (utxo.asset_list || []).forEach((asset) => {
+                const { policy_id, asset_name, quantity } = asset;
+                const unit = `${policy_id}${asset_name || ''}`;
+                balance[unit] = (balance[unit] || BigInt(0)) + BigInt(quantity);
+            });
+        });
+        const amount = Object.entries(balance).reduce((acc, cur) => [...acc, { unit: cur[0], quantity: cur[1].toString() }], []);
+        return {
+            address: result.address,
+            amount: [{ unit: 'lovelace', quantity: result.balance }].concat(amount.sort((a, b) => (a.unit > b.unit ? 1 : -1))),
+            stake_address: result.stake_address,
+            script: result.script_address
+        };
+    }
+    async getAddressUTxOs(bech32Address) {
+        const result = await this.fetchKoios(`/address_utxos`, 'POST', JSON.stringify((0, exports.buildKoiosAddressUtxoRequestBody)(bech32Address)));
+        const utxos = [];
+        for (const output of result) {
+            utxos.push(await this.buildChainProviderAsset(output));
+        }
+        return utxos;
+    }
+}
+exports.Koios = Koios;

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,