@hbar-kit/mirror 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleksandr Ostrovskyi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @hbar-kit/mirror
+
+Typed client for the Hedera Mirror Node REST API. Native `fetch`, retry-aware transport,
+lossless `bigint` amount parsing, `links.next` pagination, and normalized responses.
+
+```ts
+import { createMirrorClient } from "@hbar-kit/mirror"
+
+const mirror = createMirrorClient({ network: "testnet" })
+const page = await mirror.transactions.find({
+  accountId: "0.0.8093816",
+  transactionType: "cryptotransfer",
+  result: "success",
+  limit: 25,
+})
+for (const tx of page.items) console.log(tx.transactionId, tx.memo, tx.transfers)
+```
+
+`network` (or `baseUrl`) is required — there is no default, which prevents testnet/mainnet
+mix-ups. See the [docs](https://github.com/devwhodevs/hbar-kit).

package/dist/index.cjs

@@ -0,0 +1,254 @@
+'use strict';
+
+var core = require('@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 core.RateLimitError(
+            `Mirror Node rate limited (429)`,
+            Number.isFinite(ra) ? { details: body, retryAfter: ra } : { details: body }
+          );
+        }
+        throw new core.MirrorHttpError(`Mirror Node HTTP ${response.status}`, response.status, {
+          details: body
+        });
+      } catch (err) {
+        clearTimeout(timer);
+        if (err instanceof core.MirrorHttpError) throw err;
+        if (err instanceof DOMException && err.name === "AbortError") {
+          throw new core.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 core.NetworkError(`Mirror Node request failed: ${String(err)}`, { cause: err });
+      }
+    }
+    throw new core.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: core.parseTimestamp(raw.consensus_timestamp),
+    validStartTimestamp: raw.valid_start_timestamp ? core.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", core.tsFilter("gte", params.after));
+  if (params.before) q.append("timestamp", core.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 = core.txIdToMirror(transactionId);
+      const body = await transport.get(`/api/v1/transactions/${id}`);
+      return (body.transactions ?? []).map(normalizeTransaction);
+    }
+  };
+}
+function createAccountsResource(transport) {
+  return {
+    async getBalance(accountId) {
+      core.assertEntityId(accountId);
+      return normalizeAccountBalance(
+        await transport.get(`/api/v1/accounts/${accountId}`)
+      );
+    },
+    async isAssociated(accountId, tokenId) {
+      core.assertEntityId(accountId);
+      core.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) {
+      core.assertEntityId(tokenId);
+      return normalizeToken(await transport.get(`/api/v1/tokens/${tokenId}`));
+    }
+  };
+}
+function createBalancesResource(transport) {
+  return {
+    async get(accountId) {
+      core.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 } = core.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++;
+  }
+}
+
+exports.createMirrorClient = createMirrorClient;
+exports.http = http;
+exports.isNotFound = isNotFound;
+exports.normalizeAccountBalance = normalizeAccountBalance;
+exports.normalizeToken = normalizeToken;
+exports.normalizeTransaction = normalizeTransaction;
+exports.paginate = paginate;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.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":["RateLimitError","MirrorHttpError","TimeoutError","NetworkError","parseTimestamp","tsFilter","txIdToMirror","assertEntityId","resolveNetwork"],"mappings":"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","file":"index.cjs","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/dist/index.d.cts

@@ -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 };