@koralabs/kora-labs-common 6.10.0 → 6.11.0

package/chain/config.d.ts

@@ -0,0 +1,9 @@
+import { ChainProvider } from './failover/interfaces';
+import { ChainProviderConfig } from './providerConfig';
+export * from './providerConfig';
+/** Read a ChainProviderConfig from the standard environment variables. */
+export declare const chainConfigFromEnv: (env?: NodeJS.ProcessEnv) => ChainProviderConfig;
+/**
+ * Factory for the default read-failover provider set: Koios + Blockfrost, mutually redundant.
+ */
+export declare const buildChainProviders: (config: ChainProviderConfig) => ChainProvider[];

package/chain/config.js

@@ -0,0 +1,40 @@
+"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 });
+exports.buildChainProviders = exports.chainConfigFromEnv = void 0;
+const providerConfig_1 = require("./providerConfig");
+const Koios_1 = require("./providers/Koios");
+const Blockfrost_1 = require("./providers/Blockfrost");
+__exportStar(require("./providerConfig"), exports);
+/** Read a ChainProviderConfig from the standard environment variables. */
+const chainConfigFromEnv = (env = process.env) => {
+    var _a, _b, _c, _d;
+    return ({
+        network: (0, providerConfig_1.normalizeNetwork)((_a = env.NETWORK) !== null && _a !== void 0 ? _a : 'mainnet'),
+        koiosBearerToken: ((_b = env.KOIOS_API_BEARER_TOKEN) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
+        blockfrostApiKey: ((_c = env.BLOCKFROST_API_KEY) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
+        apiHost: ((_d = env.HANDLE_API_ENDPOINT) === null || _d === void 0 ? void 0 : _d.trim()) || undefined
+    });
+};
+exports.chainConfigFromEnv = chainConfigFromEnv;
+/**
+ * Factory for the default read-failover provider set: Koios + Blockfrost, mutually redundant.
+ */
+const buildChainProviders = (config) => [
+    new Koios_1.Koios(config),
+    new Blockfrost_1.Blockfrost(config)
+];
+exports.buildChainProviders = buildChainProviders;

package/chain/datum/imageDatum.d.ts

@@ -0,0 +1,14 @@
+import { ICreatorDefaults } from '../../handles/interfaces';
+export declare const decodeDatumViaApi: <T>(apiHost: string, datum: string, schema?: Record<string, unknown>, fetcher?: (url: string, init?: any) => Promise<{
+    text: () => Promise<string>;
+}>) => Promise<T>;
+export declare const decode0xHexToUtf8: (v: unknown) => unknown;
+export declare const normalizeCreatorDefaultTextFields: (creatorDefaults: Record<string, unknown>) => void;
+export interface ImageDatumDetails {
+    image: string;
+    creatorDefaults?: ICreatorDefaults;
+    metadata?: Record<string, unknown>;
+}
+export declare const getImageDataFromDatum: (apiHost: string, datum: string, fetcher?: (url: string, init?: any) => Promise<{
+    text: () => Promise<string>;
+}>) => Promise<ImageDatumDetails>;

package/chain/datum/imageDatum.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImageDataFromDatum = exports.normalizeCreatorDefaultTextFields = exports.decode0xHexToUtf8 = exports.decodeDatumViaApi = void 0;
+// Schema-guided datum decoding for background/CIP-68 image details. Ported verbatim (behavior-
+// preserving) from the handle.me BFF: it POSTs the datum CBOR to the Handles API `/datum` decoder
+// with a field schema so specific TEXT fields are UTF-8-decoded. This is handle-property-correctness
+// critical — the schema and the 0x-hex fallback below must not drift.
+const defaultFetch = (url, init) => globalThis.fetch(url, init);
+const decodeDatumViaApi = async (apiHost, datum, schema, fetcher = defaultFetch) => {
+    const response = await fetcher(`${apiHost}/datum?from=plutus_data_cbor&to=json`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ cbor: datum, schema })
+    });
+    const text = await response.text();
+    if (!text.trim()) {
+        // Empty response — return empty object instead of crashing.
+        return {};
+    }
+    return JSON.parse(text);
+};
+exports.decodeDatumViaApi = decodeDatumViaApi;
+// The api /datum decoder only UTF-8-decodes fields the schema can path to. When a background's
+// CIP-68 `extra` is Constr-wrapped (Constr(0,[map]) at [2]), the schema's `[2]` fields don't match
+// and these TEXT fields come back as `0x<hex>`. Colours/arrays are legitimately hex and left alone;
+// only the known free-text fields are normalized back to UTF-8. A value already decoded (no 0x
+// prefix) passes through unchanged.
+const CREATOR_DEFAULT_TEXT_FIELDS = [
+    'font',
+    'qr_dot',
+    'qr_inner_eye',
+    'qr_outer_eye',
+    'text_ribbon_gradient',
+    'qr_image'
+];
+const decode0xHexToUtf8 = (v) => {
+    if (typeof v === 'string' && /^0x[0-9a-fA-F]*$/.test(v) && v.length > 2) {
+        try {
+            return Buffer.from(v.slice(2), 'hex').toString('utf8');
+        }
+        catch (_a) {
+            return v;
+        }
+    }
+    return v;
+};
+exports.decode0xHexToUtf8 = decode0xHexToUtf8;
+const normalizeCreatorDefaultTextFields = (creatorDefaults) => {
+    for (const field of CREATOR_DEFAULT_TEXT_FIELDS) {
+        if (field in creatorDefaults) {
+            creatorDefaults[field] = (0, exports.decode0xHexToUtf8)(creatorDefaults[field]);
+        }
+    }
+};
+exports.normalizeCreatorDefaultTextFields = normalizeCreatorDefaultTextFields;
+const getImageDataFromDatum = async (apiHost, datum, fetcher) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    let decodedDatum;
+    try {
+        decodedDatum = await (0, exports.decodeDatumViaApi)(apiHost, datum, {
+            constructor_0: {
+                '[0]': { name: 'string', image: 'string', category: 'string' },
+                '[2]': {
+                    font: 'string',
+                    text_ribbon_gradient: 'string',
+                    force_creator_settings: 'bool',
+                    qr_inner_eye: 'string',
+                    qr_outer_eye: 'string',
+                    qr_dot: 'string',
+                    qr_image: 'string'
+                }
+            }
+        }, fetcher);
+    }
+    catch (_j) {
+        return { image: '' };
+    }
+    const image = (_b = (_a = decodedDatum === null || decodedDatum === void 0 ? void 0 : decodedDatum.constructor_0) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.image;
+    let data = { image };
+    const creatorDefaults = (_f = (_e = (_d = (_c = decodedDatum === null || decodedDatum === void 0 ? void 0 : decodedDatum.constructor_0) === null || _c === void 0 ? void 0 : _c[2]) === null || _d === void 0 ? void 0 : _d.constructor_0) === null || _e === void 0 ? void 0 : _e[0]) !== null && _f !== void 0 ? _f : (_g = decodedDatum.constructor_0) === null || _g === void 0 ? void 0 : _g[2];
+    if (creatorDefaults) {
+        (0, exports.normalizeCreatorDefaultTextFields)(creatorDefaults);
+        data = { image, creatorDefaults, metadata: (_h = decodedDatum === null || decodedDatum === void 0 ? void 0 : decodedDatum.constructor_0) === null || _h === void 0 ? void 0 : _h[0] };
+    }
+    return data;
+};
+exports.getImageDataFromDatum = getImageDataFromDatum;

package/chain/index.d.ts

@@ -2,3 +2,8 @@ export * from './transport/fetchProviderJson';
 export * from './failover/interfaces';
 export * from './failover/ChainProviderFailover';
 export * from './cache/ShortTermCache';
+export * from './providerConfig';
+export * from './config';
+export * from './datum/imageDatum';
+export * from './providers/Koios';
+export * from './providers/Blockfrost';

package/chain/index.js

@@ -15,10 +15,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 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).
+// NOT re-exported from the root index — this is a server-side chain-access layer and pulls Node-only
+// deps. 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);
+__exportStar(require("./providerConfig"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./datum/imageDatum"), exports);
+__exportStar(require("./providers/Koios"), exports);
+__exportStar(require("./providers/Blockfrost"), exports);

package/chain/providerConfig.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Configuration for the concrete chain providers. Injected explicitly (no reading of app-level
+ * constants) so every consumer wires its own env once and the module stays app-agnostic.
+ */
+export interface ChainProviderConfig {
+    /** 'mainnet' | 'preview' | 'preprod' — selects Koios/Blockfrost hosts. */
+    network: string;
+    /** Koios bearer token (optional; anonymous tier works without it). */
+    koiosBearerToken?: string;
+    /** Blockfrost project id for the target network. */
+    blockfrostApiKey?: string;
+    /**
+     * Base URL of the Handles API used for schema-guided datum decoding (POST /datum). Defaults to
+     * the public api.handle.me host for the network. Preserves the exact datum-decode behavior the
+     * BFF relied on (schema-pathed UTF-8 field decoding), which is handle-property-correctness
+     * critical — do NOT swap it for a local CBOR decode without matching that behavior.
+     */
+    apiHost?: string;
+}
+export declare const normalizeNetwork: (network: string) => string;
+/** Public api.handle.me host for a network (mainnet has no subdomain prefix). */
+export declare const defaultApiHost: (network: string) => string;

package/chain/providerConfig.js

@@ -0,0 +1,13 @@
+"use strict";
+// Leaf config module (no imports from providers) so the concrete providers and the factory can both
+// depend on it without a cycle.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultApiHost = exports.normalizeNetwork = void 0;
+const normalizeNetwork = (network) => (network || 'mainnet').toLowerCase();
+exports.normalizeNetwork = normalizeNetwork;
+/** Public api.handle.me host for a network (mainnet has no subdomain prefix). */
+const defaultApiHost = (network) => {
+    const net = (0, exports.normalizeNetwork)(network);
+    return net === 'mainnet' ? 'https://api.handle.me' : `https://${net}.api.handle.me`;
+};
+exports.defaultApiHost = defaultApiHost;

package/chain/providers/Blockfrost.d.ts

@@ -0,0 +1,59 @@
+import { ICreatorDefaults } from '../../handles/interfaces';
+import { AccountAsset, AddressInfo, ChainProvider, ChainProviderAsset, ChainProviderUtxo } from '../failover/interfaces';
+import { ChainProviderConfig } from '../providerConfig';
+export interface DrepMetadataValue {
+    '@value': string;
+}
+export interface DrepReference {
+    '@type': string;
+    label: string | DrepMetadataValue;
+    uri: string | DrepMetadataValue;
+}
+interface DrepMetadata {
+    drep_id: string;
+    json_metadata: {
+        body: {
+            paymentAddress: string | DrepMetadataValue;
+            givenName: string | DrepMetadataValue;
+            image: {
+                contentUrl: string | DrepMetadataValue;
+            };
+            objectives: string | DrepMetadataValue;
+            motivations: string | DrepMetadataValue;
+            qualifications: string | DrepMetadataValue;
+            references: DrepReference[];
+        };
+    };
+}
+export declare class Blockfrost implements ChainProvider {
+    private readonly config;
+    name: string;
+    constructor(config: ChainProviderConfig);
+    private fetchBlockfrost;
+    getDrepMetadata(drepId: string): Promise<DrepMetadata>;
+    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>;
+    getCip25AssetImage(policyId: string, hex: string): Promise<string | null>;
+    getRefScriptCbor(tx: string, policyId: string, hex: string): Promise<string>;
+    getTxUtxos(tx: string): Promise<ChainProviderUtxo>;
+    getAssetsByStakeKey(stakeKey: string): Promise<AccountAsset[]>;
+    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/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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "6.10.0",
+    "version": "6.11.0",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",