@hbar-kit/mirror 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,202 @@
+import { HederaTimestamp, NetworkInput } from '@hbar-kit/core';
+
+interface TransportOptions {
+    fetch?: typeof fetch;
+    retryCount?: number;
+    retryDelay?: number;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface Transport {
+    get(path: string): Promise<unknown>;
+    baseUrl: string;
+}
+declare function http(baseUrl: string, options?: TransportOptions): Transport;
+
+interface RawTransfer {
+    account: string;
+    amount: bigint;
+    is_approval?: boolean;
+}
+interface RawTokenTransfer {
+    token_id: string;
+    account: string;
+    amount: bigint;
+    is_approval?: boolean;
+}
+interface RawNftTransfer {
+    token_id: string;
+    sender_account_id: string | null;
+    receiver_account_id: string | null;
+    serial_number: bigint;
+    is_approval?: boolean;
+}
+interface RawTransaction {
+    transaction_id: string;
+    consensus_timestamp: string;
+    valid_start_timestamp?: string;
+    result: string;
+    name: string;
+    charged_tx_fee: bigint;
+    memo_base64: string;
+    node?: string;
+    nonce: number;
+    scheduled: boolean;
+    parent_consensus_timestamp: string | null;
+    transfers: RawTransfer[];
+    token_transfers: RawTokenTransfer[];
+    nft_transfers: RawNftTransfer[];
+}
+interface RawListLinks {
+    next: string | null;
+}
+interface RawTransactionList {
+    transactions: RawTransaction[];
+    links: RawListLinks;
+}
+interface RawToken {
+    token_id: string;
+    decimals: string | number;
+    symbol: string;
+    name: string;
+    type: string;
+    total_supply?: string;
+    max_supply?: string;
+    treasury_account_id?: string;
+}
+interface RawAccount {
+    account: string;
+    evm_address?: string;
+    deleted?: boolean;
+    balance: {
+        balance: bigint;
+        timestamp: string;
+        tokens: {
+            token_id: string;
+            balance: bigint;
+        }[];
+    };
+}
+interface RawStatus {
+    _status?: {
+        messages?: {
+            message: string;
+        }[];
+    };
+}
+interface Transfer {
+    account: string;
+    amount: bigint;
+    isApproval: boolean;
+}
+interface TokenTransfer {
+    tokenId: string;
+    account: string;
+    amount: bigint;
+    isApproval: boolean;
+}
+interface NftTransfer {
+    tokenId: string;
+    sender: string | null;
+    receiver: string | null;
+    serial: bigint;
+    isApproval: boolean;
+}
+interface Transaction {
+    transactionId: string;
+    consensusTimestamp: HederaTimestamp;
+    validStartTimestamp?: HederaTimestamp | undefined;
+    result: string;
+    name: string;
+    chargedTxFee: bigint;
+    memo: string;
+    nonce: number;
+    scheduled: boolean;
+    parentConsensusTimestamp: string | null;
+    transfers: Transfer[];
+    tokenTransfers: TokenTransfer[];
+    nftTransfers: NftTransfer[];
+    raw: RawTransaction;
+}
+interface Token {
+    tokenId: string;
+    decimals: number;
+    symbol: string;
+    name: string;
+    type: string;
+    totalSupply?: bigint | undefined;
+    maxSupply?: bigint | undefined;
+    treasuryAccountId?: string | undefined;
+    raw: RawToken;
+}
+interface AccountBalance {
+    accountId: string;
+    balance: bigint;
+    tokens: {
+        tokenId: string;
+        balance: bigint;
+    }[];
+    raw: RawAccount;
+}
+interface Page<T> {
+    items: T[];
+    next: string | null;
+}
+
+interface FindTransactionsParams {
+    accountId?: string;
+    transactionType?: string;
+    result?: "success" | "fail";
+    order?: "asc" | "desc";
+    limit?: number;
+    after?: Date | string;
+    before?: Date | string;
+}
+interface TransactionsResource {
+    find(params?: FindTransactionsParams): Promise<Page<Transaction>>;
+    get(transactionId: string): Promise<Transaction[]>;
+}
+
+interface AccountsResource {
+    getBalance(accountId: string): Promise<AccountBalance>;
+    isAssociated(accountId: string, tokenId: string): Promise<boolean>;
+}
+
+interface TokensResource {
+    get(tokenId: string): Promise<Token>;
+}
+
+interface BalancesResource {
+    get(accountId: string): Promise<{
+        accountId: string;
+        balance: bigint;
+        timestamp: string;
+    }>;
+}
+
+interface MirrorClientConfig extends NetworkInput, TransportOptions {
+    transport?: Transport;
+}
+interface MirrorClient {
+    baseUrl: string;
+    transport: Transport;
+    transactions: TransactionsResource;
+    accounts: AccountsResource;
+    tokens: TokensResource;
+    balances: BalancesResource;
+}
+declare function createMirrorClient(config: MirrorClientConfig): MirrorClient;
+
+interface PaginateOptions {
+    maxPages?: number;
+}
+/** Async-iterate a list endpoint by following links.next verbatim until null. */
+declare function paginate<T>(transport: Transport, firstPath: string, select: (page: unknown) => T[], options?: PaginateOptions): AsyncGenerator<T, void, unknown>;
+
+declare function normalizeTransaction(raw: RawTransaction): Transaction;
+declare function normalizeToken(raw: RawToken): Token;
+declare function normalizeAccountBalance(raw: RawAccount): AccountBalance;
+/** Detect Mirror Node not-found: the _status envelope, or an empty transactions array. */
+declare function isNotFound(body: unknown): boolean;
+
+export { type AccountBalance, type FindTransactionsParams, type MirrorClient, type MirrorClientConfig, type NftTransfer, type Page, type RawAccount, type RawListLinks, type RawNftTransfer, type RawStatus, type RawToken, type RawTokenTransfer, type RawTransaction, type RawTransactionList, type RawTransfer, type Token, type TokenTransfer, type Transaction, type Transfer, type Transport, type TransportOptions, createMirrorClient, http, isNotFound, normalizeAccountBalance, normalizeToken, normalizeTransaction, paginate };

package/dist/index.js

@@ -0,0 +1,246 @@
+import { parseTimestamp, resolveNetwork, RateLimitError, MirrorHttpError, TimeoutError, NetworkError, assertEntityId, txIdToMirror, tsFilter } from '@hbar-kit/core';
+
+// src/client.ts
+
+// src/json.ts
+var BIGINT_KEYS = ["amount", "balance", "charged_tx_fee", "serial_number"];
+function parseJsonWithBigInt(text) {
+  const keyAlternation = BIGINT_KEYS.join("|");
+  const re = new RegExp(`("(?:${keyAlternation})"\\s*:\\s*)(-?\\d+)`, "g");
+  const marked = text.replace(re, (_m, prefix, num) => `${prefix}" bi:${num}"`);
+  return JSON.parse(marked, (_k, value) => {
+    if (typeof value === "string" && value.startsWith(" bi:")) return BigInt(value.slice(4));
+    return value;
+  });
+}
+
+// src/transport.ts
+var RETRYABLE = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var jitter = (ms) => ms * (0.5 + Math.random());
+function http(baseUrl, options = {}) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const retryCount = options.retryCount ?? 3;
+  const retryDelay = options.retryDelay ?? 150;
+  const timeout = options.timeout ?? 1e4;
+  const base = baseUrl.replace(/\/+$/, "");
+  async function get(path) {
+    const url = path.startsWith("http") ? path : base + path;
+    let attempt = 0;
+    let lastErr;
+    while (attempt <= retryCount) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeout);
+      try {
+        const response = await doFetch(url, {
+          signal: controller.signal,
+          headers: { accept: "application/json", ...options.headers }
+        });
+        clearTimeout(timer);
+        if (response.ok) {
+          const text = await response.text();
+          return text ? parseJsonWithBigInt(text) : null;
+        }
+        if (RETRYABLE.has(response.status) && attempt < retryCount) {
+          const retryAfter = Number(response.headers.get("retry-after"));
+          const wait = Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter * 1e3 : jitter(retryDelay * 2 ** attempt);
+          await sleep(wait);
+          attempt++;
+          continue;
+        }
+        const body = await response.text().catch(() => "");
+        if (response.status === 429) {
+          const ra = Number(response.headers.get("retry-after"));
+          throw new RateLimitError(
+            `Mirror Node rate limited (429)`,
+            Number.isFinite(ra) ? { details: body, retryAfter: ra } : { details: body }
+          );
+        }
+        throw new MirrorHttpError(`Mirror Node HTTP ${response.status}`, response.status, {
+          details: body
+        });
+      } catch (err) {
+        clearTimeout(timer);
+        if (err instanceof MirrorHttpError) throw err;
+        if (err instanceof DOMException && err.name === "AbortError") {
+          throw new TimeoutError(`Mirror Node request timed out after ${timeout}ms`, { cause: err });
+        }
+        lastErr = err;
+        if (attempt < retryCount) {
+          await sleep(jitter(retryDelay * 2 ** attempt));
+          attempt++;
+          continue;
+        }
+        throw new NetworkError(`Mirror Node request failed: ${String(err)}`, { cause: err });
+      }
+    }
+    throw new NetworkError(`Mirror Node request failed`, { cause: lastErr });
+  }
+  return { get, baseUrl: base };
+}
+var decodeMemo = (b64) => b64 ? Buffer.from(b64, "base64").toString("utf8") : "";
+function normalizeTransaction(raw) {
+  return {
+    transactionId: raw.transaction_id,
+    consensusTimestamp: parseTimestamp(raw.consensus_timestamp),
+    validStartTimestamp: raw.valid_start_timestamp ? parseTimestamp(raw.valid_start_timestamp) : void 0,
+    result: raw.result,
+    name: raw.name,
+    chargedTxFee: raw.charged_tx_fee,
+    memo: decodeMemo(raw.memo_base64),
+    nonce: raw.nonce,
+    scheduled: raw.scheduled,
+    parentConsensusTimestamp: raw.parent_consensus_timestamp,
+    transfers: (raw.transfers ?? []).map((t) => ({
+      account: t.account,
+      amount: t.amount,
+      isApproval: t.is_approval ?? false
+    })),
+    tokenTransfers: (raw.token_transfers ?? []).map((t) => ({
+      tokenId: t.token_id,
+      account: t.account,
+      amount: t.amount,
+      isApproval: t.is_approval ?? false
+    })),
+    nftTransfers: (raw.nft_transfers ?? []).map((t) => ({
+      tokenId: t.token_id,
+      sender: t.sender_account_id,
+      receiver: t.receiver_account_id,
+      serial: t.serial_number,
+      isApproval: t.is_approval ?? false
+    })),
+    raw
+  };
+}
+function normalizeToken(raw) {
+  return {
+    tokenId: raw.token_id,
+    decimals: Number(raw.decimals),
+    symbol: raw.symbol,
+    name: raw.name,
+    type: raw.type,
+    totalSupply: raw.total_supply != null ? BigInt(raw.total_supply) : void 0,
+    maxSupply: raw.max_supply != null ? BigInt(raw.max_supply) : void 0,
+    treasuryAccountId: raw.treasury_account_id,
+    raw
+  };
+}
+function normalizeAccountBalance(raw) {
+  return {
+    accountId: raw.account,
+    balance: raw.balance.balance,
+    tokens: (raw.balance.tokens ?? []).map((t) => ({ tokenId: t.token_id, balance: t.balance })),
+    raw
+  };
+}
+function isNotFound(body) {
+  if (!body || typeof body !== "object") return false;
+  const status = body._status;
+  if (status?.messages?.some((m) => /not found/i.test(m.message))) return true;
+  const txs = body.transactions;
+  if (Array.isArray(txs) && txs.length === 0) return true;
+  return false;
+}
+
+// src/resources/transactions.ts
+function buildQuery(params) {
+  const q = new URLSearchParams();
+  if (params.accountId) q.set("account.id", params.accountId);
+  if (params.transactionType) q.set("transactiontype", params.transactionType);
+  if (params.result) q.set("result", params.result);
+  if (params.order) q.set("order", params.order);
+  q.set("limit", String(Math.min(params.limit ?? 25, 100)));
+  if (params.after) q.append("timestamp", tsFilter("gte", params.after));
+  if (params.before) q.append("timestamp", tsFilter("lt", params.before));
+  return q.toString();
+}
+function createTransactionsResource(transport) {
+  return {
+    async find(params = {}) {
+      const body = await transport.get(
+        `/api/v1/transactions?${buildQuery(params)}`
+      );
+      return {
+        items: (body.transactions ?? []).map(normalizeTransaction),
+        next: body.links?.next ?? null
+      };
+    },
+    async get(transactionId) {
+      const id = txIdToMirror(transactionId);
+      const body = await transport.get(`/api/v1/transactions/${id}`);
+      return (body.transactions ?? []).map(normalizeTransaction);
+    }
+  };
+}
+function createAccountsResource(transport) {
+  return {
+    async getBalance(accountId) {
+      assertEntityId(accountId);
+      return normalizeAccountBalance(
+        await transport.get(`/api/v1/accounts/${accountId}`)
+      );
+    },
+    async isAssociated(accountId, tokenId) {
+      assertEntityId(accountId);
+      assertEntityId(tokenId);
+      const body = await transport.get(
+        `/api/v1/accounts/${accountId}/tokens?token.id=${tokenId}`
+      );
+      return Array.isArray(body.tokens) && body.tokens.length > 0;
+    }
+  };
+}
+function createTokensResource(transport) {
+  return {
+    async get(tokenId) {
+      assertEntityId(tokenId);
+      return normalizeToken(await transport.get(`/api/v1/tokens/${tokenId}`));
+    }
+  };
+}
+function createBalancesResource(transport) {
+  return {
+    async get(accountId) {
+      assertEntityId(accountId);
+      const body = await transport.get(`/api/v1/balances?account.id=${accountId}&limit=1`);
+      return { accountId, balance: body.balances?.[0]?.balance ?? 0n, timestamp: body.timestamp };
+    }
+  };
+}
+
+// src/client.ts
+function createMirrorClient(config) {
+  const { baseUrl } = resolveNetwork(config);
+  const transportOptions = {};
+  if (config.fetch !== void 0) transportOptions.fetch = config.fetch;
+  if (config.retryCount !== void 0) transportOptions.retryCount = config.retryCount;
+  if (config.retryDelay !== void 0) transportOptions.retryDelay = config.retryDelay;
+  if (config.timeout !== void 0) transportOptions.timeout = config.timeout;
+  if (config.headers !== void 0) transportOptions.headers = config.headers;
+  const transport = config.transport ?? http(baseUrl, transportOptions);
+  return {
+    baseUrl: transport.baseUrl,
+    transport,
+    transactions: createTransactionsResource(transport),
+    accounts: createAccountsResource(transport),
+    tokens: createTokensResource(transport),
+    balances: createBalancesResource(transport)
+  };
+}
+
+// src/paginate.ts
+async function* paginate(transport, firstPath, select, options = {}) {
+  const maxPages = options.maxPages ?? 1e3;
+  let path = firstPath;
+  let pages = 0;
+  while (path && pages < maxPages) {
+    const page = await transport.get(path);
+    for (const item of select(page)) yield item;
+    path = page.links?.next ?? null;
+    pages++;
+  }
+}
+
+export { createMirrorClient, http, isNotFound, normalizeAccountBalance, normalizeToken, normalizeTransaction, paginate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json.ts","../src/transport.ts","../src/normalize.ts","../src/resources/transactions.ts","../src/resources/accounts.ts","../src/resources/tokens.ts","../src/resources/balances.ts","../src/client.ts","../src/paginate.ts"],"names":["assertEntityId"],"mappings":";;;;;AACA,IAAM,WAAA,GAAc,CAAC,QAAA,EAAU,SAAA,EAAW,kBAAkB,eAAe,CAAA;AAOpE,SAAS,oBAAoB,IAAA,EAAuB;AACzD,EAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,IAAA,CAAK,GAAG,CAAA;AAC3C,EAAA,MAAM,KAAK,IAAI,MAAA,CAAO,CAAA,KAAA,EAAQ,cAAc,wBAAwB,GAAG,CAAA;AACvE,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,OAAA,CAAQ,EAAA,EAAI,CAAC,EAAA,EAAI,MAAA,EAAgB,GAAA,KAAgB,CAAA,EAAG,MAAM,CAAA,KAAA,EAAQ,GAAG,CAAA,CAAA,CAAG,CAAA;AAC5F,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,EAAQ,CAAC,IAAI,KAAA,KAAU;AACvC,IAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,UAAA,CAAW,MAAM,CAAA,EAAG,OAAO,MAAA,CAAO,KAAA,CAAM,KAAA,CAAM,CAAC,CAAC,CAAA;AACvF,IAAA,OAAO,KAAA;AAAA,EACT,CAAC,CAAA;AACH;;;ACDA,IAAM,SAAA,mBAAY,IAAI,GAAA,CAAI,CAAC,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,GAAG,CAAC,CAAA;AAC7D,IAAM,KAAA,GAAQ,CAAC,EAAA,KAAe,IAAI,OAAA,CAAQ,CAAC,CAAA,KAAM,UAAA,CAAW,CAAA,EAAG,EAAE,CAAC,CAAA;AAClE,IAAM,SAAS,CAAC,EAAA,KAAe,EAAA,IAAM,GAAA,GAAM,KAAK,MAAA,EAAO,CAAA;AAEhD,SAAS,IAAA,CAAK,OAAA,EAAiB,OAAA,GAA4B,EAAC,EAAc;AAC/E,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,KAAA,IAAS,UAAA,CAAW,KAAA;AAC5C,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,CAAA;AACzC,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,GAAA;AACzC,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,GAAA;AACnC,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AAEvC,EAAA,eAAe,IAAI,IAAA,EAAgC;AACjD,IAAA,MAAM,MAAM,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,GAAI,OAAO,IAAA,GAAO,IAAA;AACpD,IAAA,IAAI,OAAA,GAAU,CAAA;AACd,IAAA,IAAI,OAAA;AACJ,IAAA,OAAO,WAAW,UAAA,EAAY;AAC5B,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,MAAM,QAAQ,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,OAAO,CAAA;AAC1D,MAAA,IAAI;AACF,QAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,GAAA,EAAK;AAAA,UAClC,QAAQ,UAAA,CAAW,MAAA;AAAA,UACnB,SAAS,EAAE,MAAA,EAAQ,kBAAA,EAAoB,GAAG,QAAQ,OAAA;AAAQ,SAC3D,CAAA;AACD,QAAA,YAAA,CAAa,KAAK,CAAA;AAClB,QAAA,IAAI,SAAS,EAAA,EAAI;AACf,UAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,UAAA,OAAO,IAAA,GAAO,mBAAA,CAAoB,IAAI,CAAA,GAAI,IAAA;AAAA,QAC5C;AACA,QAAA,IAAI,UAAU,GAAA,CAAI,QAAA,CAAS,MAAM,CAAA,IAAK,UAAU,UAAA,EAAY;AAC1D,UAAA,MAAM,aAAa,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC7D,UAAA,MAAM,IAAA,GACJ,MAAA,CAAO,QAAA,CAAS,UAAU,CAAA,IAAK,UAAA,GAAa,CAAA,GACxC,UAAA,GAAa,GAAA,GACb,MAAA,CAAO,UAAA,GAAa,CAAA,IAAK,OAAO,CAAA;AACtC,UAAA,MAAM,MAAM,IAAI,CAAA;AAChB,UAAA,OAAA,EAAA;AACA,UAAA;AAAA,QACF;AACA,QAAA,MAAM,OAAO,MAAM,QAAA,CAAS,MAAK,CAAE,KAAA,CAAM,MAAM,EAAE,CAAA;AACjD,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,KAAK,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AACrD,UAAA,MAAM,IAAI,cAAA;AAAA,YACR,CAAA,8BAAA,CAAA;AAAA,YACA,MAAA,CAAO,QAAA,CAAS,EAAE,CAAA,GAAI,EAAE,OAAA,EAAS,IAAA,EAAM,UAAA,EAAY,EAAA,EAAG,GAAI,EAAE,OAAA,EAAS,IAAA;AAAK,WAC5E;AAAA,QACF;AACA,QAAA,MAAM,IAAI,eAAA,CAAgB,CAAA,iBAAA,EAAoB,SAAS,MAAM,CAAA,CAAA,EAAI,SAAS,MAAA,EAAQ;AAAA,UAChF,OAAA,EAAS;AAAA,SACV,CAAA;AAAA,MACH,SAAS,GAAA,EAAK;AACZ,QAAA,YAAA,CAAa,KAAK,CAAA;AAClB,QAAA,IAAI,GAAA,YAAe,iBAAiB,MAAM,GAAA;AAC1C,QAAA,IAAI,GAAA,YAAe,YAAA,IAAgB,GAAA,CAAI,IAAA,KAAS,YAAA,EAAc;AAC5D,UAAA,MAAM,IAAI,aAAa,CAAA,oCAAA,EAAuC,OAAO,MAAM,EAAE,KAAA,EAAO,KAAK,CAAA;AAAA,QAC3F;AACA,QAAA,OAAA,GAAU,GAAA;AACV,QAAA,IAAI,UAAU,UAAA,EAAY;AACxB,UAAA,MAAM,KAAA,CAAM,MAAA,CAAO,UAAA,GAAa,CAAA,IAAK,OAAO,CAAC,CAAA;AAC7C,UAAA,OAAA,EAAA;AACA,UAAA;AAAA,QACF;AACA,QAAA,MAAM,IAAI,YAAA,CAAa,CAAA,4BAAA,EAA+B,MAAA,CAAO,GAAG,CAAC,CAAA,CAAA,EAAI,EAAE,KAAA,EAAO,GAAA,EAAK,CAAA;AAAA,MACrF;AAAA,IACF;AACA,IAAA,MAAM,IAAI,YAAA,CAAa,CAAA,0BAAA,CAAA,EAA8B,EAAE,KAAA,EAAO,SAAS,CAAA;AAAA,EACzE;AAEA,EAAA,OAAO,EAAE,GAAA,EAAK,OAAA,EAAS,IAAA,EAAK;AAC9B;ACxEA,IAAM,UAAA,GAAa,CAAC,GAAA,KAAyB,GAAA,GAAM,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA,CAAE,QAAA,CAAS,MAAM,CAAA,GAAI,EAAA;AAE1F,SAAS,qBAAqB,GAAA,EAAkC;AACrE,EAAA,OAAO;AAAA,IACL,eAAe,GAAA,CAAI,cAAA;AAAA,IACnB,kBAAA,EAAoB,cAAA,CAAe,GAAA,CAAI,mBAAmB,CAAA;AAAA,IAC1D,qBAAqB,GAAA,CAAI,qBAAA,GACrB,cAAA,CAAe,GAAA,CAAI,qBAAqB,CAAA,GACxC,MAAA;AAAA,IACJ,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,cAAc,GAAA,CAAI,cAAA;AAAA,IAClB,IAAA,EAAM,UAAA,CAAW,GAAA,CAAI,WAAW,CAAA;AAAA,IAChC,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,0BAA0B,GAAA,CAAI,0BAAA;AAAA,IAC9B,YAAY,GAAA,CAAI,SAAA,IAAa,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MAC3C,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,QAAQ,CAAA,CAAE,MAAA;AAAA,MACV,UAAA,EAAY,EAAE,WAAA,IAAe;AAAA,KAC/B,CAAE,CAAA;AAAA,IACF,iBAAiB,GAAA,CAAI,eAAA,IAAmB,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MACtD,SAAS,CAAA,CAAE,QAAA;AAAA,MACX,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,QAAQ,CAAA,CAAE,MAAA;AAAA,MACV,UAAA,EAAY,EAAE,WAAA,IAAe;AAAA,KAC/B,CAAE,CAAA;AAAA,IACF,eAAe,GAAA,CAAI,aAAA,IAAiB,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MAClD,SAAS,CAAA,CAAE,QAAA;AAAA,MACX,QAAQ,CAAA,CAAE,iBAAA;AAAA,MACV,UAAU,CAAA,CAAE,mBAAA;AAAA,MACZ,QAAQ,CAAA,CAAE,aAAA;AAAA,MACV,UAAA,EAAY,EAAE,WAAA,IAAe;AAAA,KAC/B,CAAE,CAAA;AAAA,IACF;AAAA,GACF;AACF;AAEO,SAAS,eAAe,GAAA,EAAsB;AACnD,EAAA,OAAO;AAAA,IACL,SAAS,GAAA,CAAI,QAAA;AAAA,IACb,QAAA,EAAU,MAAA,CAAO,GAAA,CAAI,QAAQ,CAAA;AAAA,IAC7B,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,aAAa,GAAA,CAAI,YAAA,IAAgB,OAAO,MAAA,CAAO,GAAA,CAAI,YAAY,CAAA,GAAI,MAAA;AAAA,IACnE,WAAW,GAAA,CAAI,UAAA,IAAc,OAAO,MAAA,CAAO,GAAA,CAAI,UAAU,CAAA,GAAI,MAAA;AAAA,IAC7D,mBAAmB,GAAA,CAAI,mBAAA;AAAA,IACvB;AAAA,GACF;AACF;AAEO,SAAS,wBAAwB,GAAA,EAAiC;AACvE,EAAA,OAAO;AAAA,IACL,WAAW,GAAA,CAAI,OAAA;AAAA,IACf,OAAA,EAAS,IAAI,OAAA,CAAQ,OAAA;AAAA,IACrB,SAAS,GAAA,CAAI,OAAA,CAAQ,MAAA,IAAU,IAAI,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,SAAS,CAAA,CAAE,QAAA,EAAU,OAAA,EAAS,CAAA,CAAE,SAAQ,CAAE,CAAA;AAAA,IAC3F;AAAA,GACF;AACF;AAGO,SAAS,WAAW,IAAA,EAAwB;AACjD,EAAA,IAAI,CAAC,IAAA,IAAQ,OAAO,IAAA,KAAS,UAAU,OAAO,KAAA;AAC9C,EAAA,MAAM,SAAU,IAAA,CAAmB,OAAA;AACnC,EAAA,IAAI,MAAA,EAAQ,QAAA,EAAU,IAAA,CAAK,CAAC,CAAA,KAAM,YAAA,CAAa,IAAA,CAAK,CAAA,CAAE,OAAO,CAAC,CAAA,EAAG,OAAO,IAAA;AACxE,EAAA,MAAM,MAAO,IAAA,CAAsC,YAAA;AACnD,EAAA,IAAI,MAAM,OAAA,CAAQ,GAAG,KAAK,GAAA,CAAI,MAAA,KAAW,GAAG,OAAO,IAAA;AACnD,EAAA,OAAO,KAAA;AACT;;;AC5DA,SAAS,WAAW,MAAA,EAAwC;AAC1D,EAAA,MAAM,CAAA,GAAI,IAAI,eAAA,EAAgB;AAC9B,EAAA,IAAI,OAAO,SAAA,EAAW,CAAA,CAAE,GAAA,CAAI,YAAA,EAAc,OAAO,SAAS,CAAA;AAC1D,EAAA,IAAI,OAAO,eAAA,EAAiB,CAAA,CAAE,GAAA,CAAI,iBAAA,EAAmB,OAAO,eAAe,CAAA;AAC3E,EAAA,IAAI,OAAO,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAChD,EAAA,IAAI,OAAO,KAAA,EAAO,CAAA,CAAE,GAAA,CAAI,OAAA,EAAS,OAAO,KAAK,CAAA;AAC7C,EAAA,CAAA,CAAE,GAAA,CAAI,OAAA,EAAS,MAAA,CAAO,IAAA,CAAK,GAAA,CAAI,OAAO,KAAA,IAAS,EAAA,EAAI,GAAG,CAAC,CAAC,CAAA;AACxD,EAAA,IAAI,MAAA,CAAO,OAAO,CAAA,CAAE,MAAA,CAAO,aAAa,QAAA,CAAS,KAAA,EAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AACrE,EAAA,IAAI,MAAA,CAAO,QAAQ,CAAA,CAAE,MAAA,CAAO,aAAa,QAAA,CAAS,IAAA,EAAM,MAAA,CAAO,MAAM,CAAC,CAAA;AACtE,EAAA,OAAO,EAAE,QAAA,EAAS;AACpB;AAEO,SAAS,2BAA2B,SAAA,EAA4C;AACrF,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,MAAA,GAAS,EAAC,EAAG;AACtB,MAAA,MAAM,IAAA,GAAQ,MAAM,SAAA,CAAU,GAAA;AAAA,QAC5B,CAAA,qBAAA,EAAwB,UAAA,CAAW,MAAM,CAAC,CAAA;AAAA,OAC5C;AACA,MAAA,OAAO;AAAA,QACL,QAAQ,IAAA,CAAK,YAAA,IAAgB,EAAC,EAAG,IAAI,oBAAoB,CAAA;AAAA,QACzD,IAAA,EAAM,IAAA,CAAK,KAAA,EAAO,IAAA,IAAQ;AAAA,OAC5B;AAAA,IACF,CAAA;AAAA,IACA,MAAM,IAAI,aAAA,EAAe;AACvB,MAAA,MAAM,EAAA,GAAK,aAAa,aAAa,CAAA;AACrC,MAAA,MAAM,OAAQ,MAAM,SAAA,CAAU,GAAA,CAAI,CAAA,qBAAA,EAAwB,EAAE,CAAA,CAAE,CAAA;AAG9D,MAAA,OAAA,CAAQ,IAAA,CAAK,YAAA,IAAgB,EAAC,EAAG,IAAI,oBAAoB,CAAA;AAAA,IAC3D;AAAA,GACF;AACF;ACzCO,SAAS,uBAAuB,SAAA,EAAwC;AAC7E,EAAA,OAAO;AAAA,IACL,MAAM,WAAW,SAAA,EAAW;AAC1B,MAAA,cAAA,CAAe,SAAS,CAAA;AACxB,MAAA,OAAO,uBAAA;AAAA,QACJ,MAAM,SAAA,CAAU,GAAA,CAAI,CAAA,iBAAA,EAAoB,SAAS,CAAA,CAAE;AAAA,OACtD;AAAA,IACF,CAAA;AAAA,IACA,MAAM,YAAA,CAAa,SAAA,EAAW,OAAA,EAAS;AACrC,MAAA,cAAA,CAAe,SAAS,CAAA;AACxB,MAAA,cAAA,CAAe,OAAO,CAAA;AACtB,MAAA,MAAM,IAAA,GAAQ,MAAM,SAAA,CAAU,GAAA;AAAA,QAC5B,CAAA,iBAAA,EAAoB,SAAS,CAAA,iBAAA,EAAoB,OAAO,CAAA;AAAA,OAC1D;AACA,MAAA,OAAO,MAAM,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAA,IAAK,IAAA,CAAK,OAAO,MAAA,GAAS,CAAA;AAAA,IAC5D;AAAA,GACF;AACF;AClBO,SAAS,qBAAqB,SAAA,EAAsC;AACzE,EAAA,OAAO;AAAA,IACL,MAAM,IAAI,OAAA,EAAS;AACjB,MAAAA,eAAe,OAAO,CAAA;AACtB,MAAA,OAAO,eAAgB,MAAM,SAAA,CAAU,IAAI,CAAA,eAAA,EAAkB,OAAO,EAAE,CAAc,CAAA;AAAA,IACtF;AAAA,GACF;AACF;ACTO,SAAS,uBAAuB,SAAA,EAAwC;AAC7E,EAAA,OAAO;AAAA,IACL,MAAM,IAAI,SAAA,EAAW;AACnB,MAAAA,eAAe,SAAS,CAAA;AACxB,MAAA,MAAM,OAAQ,MAAM,SAAA,CAAU,GAAA,CAAI,CAAA,4BAAA,EAA+B,SAAS,CAAA,QAAA,CAAU,CAAA;AAIpF,MAAA,OAAO,EAAE,SAAA,EAAW,OAAA,EAAS,IAAA,CAAK,QAAA,GAAW,CAAC,CAAA,EAAG,OAAA,IAAW,EAAA,EAAI,SAAA,EAAW,IAAA,CAAK,SAAA,EAAU;AAAA,IAC5F;AAAA,GACF;AACF;;;ACEO,SAAS,mBAAmB,MAAA,EAA0C;AAC3E,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,cAAA,CAAe,MAAM,CAAA;AACzC,EAAA,MAAM,mBAAqC,EAAC;AAC5C,EAAA,IAAI,MAAA,CAAO,KAAA,KAAU,MAAA,EAAW,gBAAA,CAAiB,QAAQ,MAAA,CAAO,KAAA;AAChE,EAAA,IAAI,MAAA,CAAO,UAAA,KAAe,MAAA,EAAW,gBAAA,CAAiB,aAAa,MAAA,CAAO,UAAA;AAC1E,EAAA,IAAI,MAAA,CAAO,UAAA,KAAe,MAAA,EAAW,gBAAA,CAAiB,aAAa,MAAA,CAAO,UAAA;AAC1E,EAAA,IAAI,MAAA,CAAO,OAAA,KAAY,MAAA,EAAW,gBAAA,CAAiB,UAAU,MAAA,CAAO,OAAA;AACpE,EAAA,IAAI,MAAA,CAAO,OAAA,KAAY,MAAA,EAAW,gBAAA,CAAiB,UAAU,MAAA,CAAO,OAAA;AACpE,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,SAAA,IAAa,IAAA,CAAK,SAAS,gBAAgB,CAAA;AACpE,EAAA,OAAO;AAAA,IACL,SAAS,SAAA,CAAU,OAAA;AAAA,IACnB,SAAA;AAAA,IACA,YAAA,EAAc,2BAA2B,SAAS,CAAA;AAAA,IAClD,QAAA,EAAU,uBAAuB,SAAS,CAAA;AAAA,IAC1C,MAAA,EAAQ,qBAAqB,SAAS,CAAA;AAAA,IACtC,QAAA,EAAU,uBAAuB,SAAS;AAAA,GAC5C;AACF;;;AC9BA,gBAAuB,SACrB,SAAA,EACA,SAAA,EACA,MAAA,EACA,OAAA,GAA2B,EAAC,EACM;AAClC,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,GAAA;AACrC,EAAA,IAAI,IAAA,GAAsB,SAAA;AAC1B,EAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,EAAA,OAAO,IAAA,IAAQ,QAAQ,QAAA,EAAU;AAC/B,IAAA,MAAM,IAAA,GAAgB,MAAM,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAC9C,IAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAI,CAAA,EAAG,MAAM,IAAA;AACvC,IAAA,IAAA,GAAQ,IAAA,CAA6C,OAAO,IAAA,IAAQ,IAAA;AACpE,IAAA,KAAA,EAAA;AAAA,EACF;AACF","file":"index.js","sourcesContent":["// Fields whose integer values may exceed Number.MAX_SAFE_INTEGER and must be bigint.\nconst BIGINT_KEYS = [\"amount\", \"balance\", \"charged_tx_fee\", \"serial_number\"]\n\n/**\n * Parse Mirror Node JSON, coercing known integer money fields to bigint losslessly.\n * Wraps `\"key\": <integer>` in a sentinel string BEFORE JSON.parse so large integers\n * never pass through a lossy JS number, then revives them as bigint.\n */\nexport function parseJsonWithBigInt(text: string): unknown {\n  const keyAlternation = BIGINT_KEYS.join(\"|\")\n  const re = new RegExp(`(\"(?:${keyAlternation})\"\\\\s*:\\\\s*)(-?\\\\d+)`, \"g\")\n  const marked = text.replace(re, (_m, prefix: string, num: string) => `${prefix}\" bi:${num}\"`)\n  return JSON.parse(marked, (_k, value) => {\n    if (typeof value === \"string\" && value.startsWith(\" bi:\")) return BigInt(value.slice(4))\n    return value\n  })\n}\n","import { MirrorHttpError, RateLimitError, TimeoutError, NetworkError } from \"@hbar-kit/core\"\nimport { parseJsonWithBigInt } from \"./json.js\"\n\nexport interface TransportOptions {\n  fetch?: typeof fetch\n  retryCount?: number\n  retryDelay?: number\n  timeout?: number\n  headers?: Record<string, string>\n}\nexport interface Transport {\n  get(path: string): Promise<unknown>\n  baseUrl: string\n}\n\nconst RETRYABLE = new Set([408, 425, 429, 500, 502, 503, 504])\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))\nconst jitter = (ms: number) => ms * (0.5 + Math.random())\n\nexport function http(baseUrl: string, options: TransportOptions = {}): Transport {\n  const doFetch = options.fetch ?? globalThis.fetch\n  const retryCount = options.retryCount ?? 3\n  const retryDelay = options.retryDelay ?? 150\n  const timeout = options.timeout ?? 10_000\n  const base = baseUrl.replace(/\\/+$/, \"\")\n\n  async function get(path: string): Promise<unknown> {\n    const url = path.startsWith(\"http\") ? path : base + path\n    let attempt = 0\n    let lastErr: unknown\n    while (attempt <= retryCount) {\n      const controller = new AbortController()\n      const timer = setTimeout(() => controller.abort(), timeout)\n      try {\n        const response = await doFetch(url, {\n          signal: controller.signal,\n          headers: { accept: \"application/json\", ...options.headers },\n        })\n        clearTimeout(timer)\n        if (response.ok) {\n          const text = await response.text()\n          return text ? parseJsonWithBigInt(text) : null\n        }\n        if (RETRYABLE.has(response.status) && attempt < retryCount) {\n          const retryAfter = Number(response.headers.get(\"retry-after\"))\n          const wait =\n            Number.isFinite(retryAfter) && retryAfter > 0\n              ? retryAfter * 1000\n              : jitter(retryDelay * 2 ** attempt)\n          await sleep(wait)\n          attempt++\n          continue\n        }\n        const body = await response.text().catch(() => \"\")\n        if (response.status === 429) {\n          const ra = Number(response.headers.get(\"retry-after\"))\n          throw new RateLimitError(\n            `Mirror Node rate limited (429)`,\n            Number.isFinite(ra) ? { details: body, retryAfter: ra } : { details: body },\n          )\n        }\n        throw new MirrorHttpError(`Mirror Node HTTP ${response.status}`, response.status, {\n          details: body,\n        })\n      } catch (err) {\n        clearTimeout(timer)\n        if (err instanceof MirrorHttpError) throw err\n        if (err instanceof DOMException && err.name === \"AbortError\") {\n          throw new TimeoutError(`Mirror Node request timed out after ${timeout}ms`, { cause: err })\n        }\n        lastErr = err\n        if (attempt < retryCount) {\n          await sleep(jitter(retryDelay * 2 ** attempt))\n          attempt++\n          continue\n        }\n        throw new NetworkError(`Mirror Node request failed: ${String(err)}`, { cause: err })\n      }\n    }\n    throw new NetworkError(`Mirror Node request failed`, { cause: lastErr })\n  }\n\n  return { get, baseUrl: base }\n}\n","import { parseTimestamp } from \"@hbar-kit/core\"\nimport type {\n  RawTransaction,\n  Transaction,\n  RawToken,\n  Token,\n  RawAccount,\n  AccountBalance,\n  RawStatus,\n} from \"./types.js\"\n\nconst decodeMemo = (b64: string): string => (b64 ? Buffer.from(b64, \"base64\").toString(\"utf8\") : \"\")\n\nexport function normalizeTransaction(raw: RawTransaction): Transaction {\n  return {\n    transactionId: raw.transaction_id,\n    consensusTimestamp: parseTimestamp(raw.consensus_timestamp),\n    validStartTimestamp: raw.valid_start_timestamp\n      ? parseTimestamp(raw.valid_start_timestamp)\n      : undefined,\n    result: raw.result,\n    name: raw.name,\n    chargedTxFee: raw.charged_tx_fee,\n    memo: decodeMemo(raw.memo_base64),\n    nonce: raw.nonce,\n    scheduled: raw.scheduled,\n    parentConsensusTimestamp: raw.parent_consensus_timestamp,\n    transfers: (raw.transfers ?? []).map((t) => ({\n      account: t.account,\n      amount: t.amount,\n      isApproval: t.is_approval ?? false,\n    })),\n    tokenTransfers: (raw.token_transfers ?? []).map((t) => ({\n      tokenId: t.token_id,\n      account: t.account,\n      amount: t.amount,\n      isApproval: t.is_approval ?? false,\n    })),\n    nftTransfers: (raw.nft_transfers ?? []).map((t) => ({\n      tokenId: t.token_id,\n      sender: t.sender_account_id,\n      receiver: t.receiver_account_id,\n      serial: t.serial_number,\n      isApproval: t.is_approval ?? false,\n    })),\n    raw,\n  }\n}\n\nexport function normalizeToken(raw: RawToken): Token {\n  return {\n    tokenId: raw.token_id,\n    decimals: Number(raw.decimals),\n    symbol: raw.symbol,\n    name: raw.name,\n    type: raw.type,\n    totalSupply: raw.total_supply != null ? BigInt(raw.total_supply) : undefined,\n    maxSupply: raw.max_supply != null ? BigInt(raw.max_supply) : undefined,\n    treasuryAccountId: raw.treasury_account_id,\n    raw,\n  }\n}\n\nexport function normalizeAccountBalance(raw: RawAccount): AccountBalance {\n  return {\n    accountId: raw.account,\n    balance: raw.balance.balance,\n    tokens: (raw.balance.tokens ?? []).map((t) => ({ tokenId: t.token_id, balance: t.balance })),\n    raw,\n  }\n}\n\n/** Detect Mirror Node not-found: the _status envelope, or an empty transactions array. */\nexport function isNotFound(body: unknown): boolean {\n  if (!body || typeof body !== \"object\") return false\n  const status = (body as RawStatus)._status\n  if (status?.messages?.some((m) => /not found/i.test(m.message))) return true\n  const txs = (body as { transactions?: unknown[] }).transactions\n  if (Array.isArray(txs) && txs.length === 0) return true\n  return false\n}\n","import { tsFilter, txIdToMirror } from \"@hbar-kit/core\"\nimport type { Transport } from \"../transport.js\"\nimport { normalizeTransaction } from \"../normalize.js\"\nimport type { Page, RawTransaction, RawTransactionList, Transaction } from \"../types.js\"\n\nexport interface FindTransactionsParams {\n  accountId?: string\n  transactionType?: string\n  result?: \"success\" | \"fail\"\n  order?: \"asc\" | \"desc\"\n  limit?: number\n  after?: Date | string\n  before?: Date | string\n}\n\nexport interface TransactionsResource {\n  find(params?: FindTransactionsParams): Promise<Page<Transaction>>\n  get(transactionId: string): Promise<Transaction[]>\n}\n\nfunction buildQuery(params: FindTransactionsParams): string {\n  const q = new URLSearchParams()\n  if (params.accountId) q.set(\"account.id\", params.accountId)\n  if (params.transactionType) q.set(\"transactiontype\", params.transactionType)\n  if (params.result) q.set(\"result\", params.result)\n  if (params.order) q.set(\"order\", params.order)\n  q.set(\"limit\", String(Math.min(params.limit ?? 25, 100)))\n  if (params.after) q.append(\"timestamp\", tsFilter(\"gte\", params.after))\n  if (params.before) q.append(\"timestamp\", tsFilter(\"lt\", params.before))\n  return q.toString()\n}\n\nexport function createTransactionsResource(transport: Transport): TransactionsResource {\n  return {\n    async find(params = {}) {\n      const body = (await transport.get(\n        `/api/v1/transactions?${buildQuery(params)}`,\n      )) as RawTransactionList\n      return {\n        items: (body.transactions ?? []).map(normalizeTransaction),\n        next: body.links?.next ?? null,\n      }\n    },\n    async get(transactionId) {\n      const id = txIdToMirror(transactionId)\n      const body = (await transport.get(`/api/v1/transactions/${id}`)) as {\n        transactions?: RawTransaction[]\n      }\n      return (body.transactions ?? []).map(normalizeTransaction)\n    },\n  }\n}\n","import { assertEntityId } from \"@hbar-kit/core\"\nimport type { Transport } from \"../transport.js\"\nimport { normalizeAccountBalance } from \"../normalize.js\"\nimport type { AccountBalance, RawAccount } from \"../types.js\"\n\nexport interface AccountsResource {\n  getBalance(accountId: string): Promise<AccountBalance>\n  isAssociated(accountId: string, tokenId: string): Promise<boolean>\n}\n\nexport function createAccountsResource(transport: Transport): AccountsResource {\n  return {\n    async getBalance(accountId) {\n      assertEntityId(accountId)\n      return normalizeAccountBalance(\n        (await transport.get(`/api/v1/accounts/${accountId}`)) as RawAccount,\n      )\n    },\n    async isAssociated(accountId, tokenId) {\n      assertEntityId(accountId)\n      assertEntityId(tokenId)\n      const body = (await transport.get(\n        `/api/v1/accounts/${accountId}/tokens?token.id=${tokenId}`,\n      )) as { tokens?: unknown[] }\n      return Array.isArray(body.tokens) && body.tokens.length > 0\n    },\n  }\n}\n","import { assertEntityId } from \"@hbar-kit/core\"\nimport type { Transport } from \"../transport.js\"\nimport { normalizeToken } from \"../normalize.js\"\nimport type { RawToken, Token } from \"../types.js\"\n\nexport interface TokensResource {\n  get(tokenId: string): Promise<Token>\n}\n\nexport function createTokensResource(transport: Transport): TokensResource {\n  return {\n    async get(tokenId) {\n      assertEntityId(tokenId)\n      return normalizeToken((await transport.get(`/api/v1/tokens/${tokenId}`)) as RawToken)\n    },\n  }\n}\n","import { assertEntityId } from \"@hbar-kit/core\"\nimport type { Transport } from \"../transport.js\"\n\nexport interface BalancesResource {\n  get(accountId: string): Promise<{ accountId: string; balance: bigint; timestamp: string }>\n}\n\nexport function createBalancesResource(transport: Transport): BalancesResource {\n  return {\n    async get(accountId) {\n      assertEntityId(accountId)\n      const body = (await transport.get(`/api/v1/balances?account.id=${accountId}&limit=1`)) as {\n        timestamp: string\n        balances: { account: string; balance: bigint }[]\n      }\n      return { accountId, balance: body.balances?.[0]?.balance ?? 0n, timestamp: body.timestamp }\n    },\n  }\n}\n","import { resolveNetwork, type NetworkInput } from \"@hbar-kit/core\"\nimport { http, type TransportOptions, type Transport } from \"./transport.js\"\nimport { createTransactionsResource, type TransactionsResource } from \"./resources/transactions.js\"\nimport { createAccountsResource, type AccountsResource } from \"./resources/accounts.js\"\nimport { createTokensResource, type TokensResource } from \"./resources/tokens.js\"\nimport { createBalancesResource, type BalancesResource } from \"./resources/balances.js\"\n\nexport interface MirrorClientConfig extends NetworkInput, TransportOptions {\n  transport?: Transport\n}\n\nexport interface MirrorClient {\n  baseUrl: string\n  transport: Transport\n  transactions: TransactionsResource\n  accounts: AccountsResource\n  tokens: TokensResource\n  balances: BalancesResource\n}\n\nexport function createMirrorClient(config: MirrorClientConfig): MirrorClient {\n  const { baseUrl } = resolveNetwork(config)\n  const transportOptions: TransportOptions = {}\n  if (config.fetch !== undefined) transportOptions.fetch = config.fetch\n  if (config.retryCount !== undefined) transportOptions.retryCount = config.retryCount\n  if (config.retryDelay !== undefined) transportOptions.retryDelay = config.retryDelay\n  if (config.timeout !== undefined) transportOptions.timeout = config.timeout\n  if (config.headers !== undefined) transportOptions.headers = config.headers\n  const transport = config.transport ?? http(baseUrl, transportOptions)\n  return {\n    baseUrl: transport.baseUrl,\n    transport,\n    transactions: createTransactionsResource(transport),\n    accounts: createAccountsResource(transport),\n    tokens: createTokensResource(transport),\n    balances: createBalancesResource(transport),\n  }\n}\n","import type { Transport } from \"./transport.js\"\n\nexport interface PaginateOptions {\n  maxPages?: number\n}\n\n/** Async-iterate a list endpoint by following links.next verbatim until null. */\nexport async function* paginate<T>(\n  transport: Transport,\n  firstPath: string,\n  select: (page: unknown) => T[],\n  options: PaginateOptions = {},\n): AsyncGenerator<T, void, unknown> {\n  const maxPages = options.maxPages ?? 1000\n  let path: string | null = firstPath\n  let pages = 0\n  while (path && pages < maxPages) {\n    const page: unknown = await transport.get(path)\n    for (const item of select(page)) yield item\n    path = (page as { links?: { next: string | null } }).links?.next ?? null\n    pages++\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@hbar-kit/mirror",
+  "version": "0.1.0",
+  "description": "Typed Hedera Mirror Node REST client.",
+  "license": "MIT",
+  "homepage": "https://devwhodevs.github.io/hbar-kit/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devwhodevs/hbar-kit.git",
+    "directory": "packages/mirror"
+  },
+  "bugs": "https://github.com/devwhodevs/hbar-kit/issues",
+  "keywords": [
+    "hedera",
+    "hbar",
+    "hts",
+    "mirror-node",
+    "rest",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@hbar-kit/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "check:publish": "publint --strict && attw --pack ."
+  }
+}

package/src/client.ts

@@ -0,0 +1,38 @@
+import { resolveNetwork, type NetworkInput } from "@hbar-kit/core"
+import { http, type TransportOptions, type Transport } from "./transport.js"
+import { createTransactionsResource, type TransactionsResource } from "./resources/transactions.js"
+import { createAccountsResource, type AccountsResource } from "./resources/accounts.js"
+import { createTokensResource, type TokensResource } from "./resources/tokens.js"
+import { createBalancesResource, type BalancesResource } from "./resources/balances.js"
+
+export interface MirrorClientConfig extends NetworkInput, TransportOptions {
+  transport?: Transport
+}
+
+export interface MirrorClient {
+  baseUrl: string
+  transport: Transport
+  transactions: TransactionsResource
+  accounts: AccountsResource
+  tokens: TokensResource
+  balances: BalancesResource
+}
+
+export function createMirrorClient(config: MirrorClientConfig): MirrorClient {
+  const { baseUrl } = resolveNetwork(config)
+  const transportOptions: TransportOptions = {}
+  if (config.fetch !== undefined) transportOptions.fetch = config.fetch
+  if (config.retryCount !== undefined) transportOptions.retryCount = config.retryCount
+  if (config.retryDelay !== undefined) transportOptions.retryDelay = config.retryDelay
+  if (config.timeout !== undefined) transportOptions.timeout = config.timeout
+  if (config.headers !== undefined) transportOptions.headers = config.headers
+  const transport = config.transport ?? http(baseUrl, transportOptions)
+  return {
+    baseUrl: transport.baseUrl,
+    transport,
+    transactions: createTransactionsResource(transport),
+    accounts: createAccountsResource(transport),
+    tokens: createTokensResource(transport),
+    balances: createBalancesResource(transport),
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export { createMirrorClient } from "./client.js"
+export type { MirrorClient, MirrorClientConfig } from "./client.js"
+export { http } from "./transport.js"
+export type { Transport, TransportOptions } from "./transport.js"
+export { paginate } from "./paginate.js"
+export {
+  normalizeTransaction,
+  normalizeToken,
+  normalizeAccountBalance,
+  isNotFound,
+} from "./normalize.js"
+export type { FindTransactionsParams } from "./resources/transactions.js"
+export * from "./types.js"

package/src/json.ts

@@ -0,0 +1,17 @@
+// Fields whose integer values may exceed Number.MAX_SAFE_INTEGER and must be bigint.
+const BIGINT_KEYS = ["amount", "balance", "charged_tx_fee", "serial_number"]
+
+/**
+ * Parse Mirror Node JSON, coercing known integer money fields to bigint losslessly.
+ * Wraps `"key": <integer>` in a sentinel string BEFORE JSON.parse so large integers
+ * never pass through a lossy JS number, then revives them as bigint.
+ */
+export function parseJsonWithBigInt(text: string): unknown {
+  const keyAlternation = BIGINT_KEYS.join("|")
+  const re = new RegExp(`("(?:${keyAlternation})"\\s*:\\s*)(-?\\d+)`, "g")
+  const marked = text.replace(re, (_m, prefix: string, num: string) => `${prefix}" bi:${num}"`)
+  return JSON.parse(marked, (_k, value) => {
+    if (typeof value === "string" && value.startsWith(" bi:")) return BigInt(value.slice(4))
+    return value
+  })
+}