hiero-sdk-utils 0.1.0

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,YAAY,EACV,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,55 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedulesResource = exports.BlocksResource = exports.BalancesResource = exports.NftsResource = exports.ContractsResource = exports.TopicsResource = exports.TokensResource = exports.TransactionsResource = exports.AccountsResource = exports.PaginationError = exports.ValidationError = exports.MirrorNodeError = exports.HieroError = exports.Networks = exports.HieroClient = void 0;
+/**
+ * hiero-sdk-utils — TypeScript utilities for the Hedera/Hiero Mirror Node.
+ *
+ * @example
+ * ```ts
+ * import { HieroClient, Networks } from 'hiero-sdk-utils';
+ *
+ * const client = new HieroClient({ baseUrl: Networks.testnet });
+ *
+ * // Fetch a single account
+ * const account = await client.accounts.getById('0.0.1234');
+ *
+ * // Iterate through accounts with auto-pagination
+ * for await (const a of client.accounts.list({ limit: 10 })) {
+ *   console.log(a.account, a.balance.balance);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Client
+var HieroClient_js_1 = require("./client/HieroClient.js");
+Object.defineProperty(exports, "HieroClient", { enumerable: true, get: function () { return HieroClient_js_1.HieroClient; } });
+var types_js_1 = require("./client/types.js");
+Object.defineProperty(exports, "Networks", { enumerable: true, get: function () { return types_js_1.Networks; } });
+// Errors
+var index_js_1 = require("./errors/index.js");
+Object.defineProperty(exports, "HieroError", { enumerable: true, get: function () { return index_js_1.HieroError; } });
+Object.defineProperty(exports, "MirrorNodeError", { enumerable: true, get: function () { return index_js_1.MirrorNodeError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return index_js_1.ValidationError; } });
+Object.defineProperty(exports, "PaginationError", { enumerable: true, get: function () { return index_js_1.PaginationError; } });
+// Resources
+var accounts_js_1 = require("./resources/accounts.js");
+Object.defineProperty(exports, "AccountsResource", { enumerable: true, get: function () { return accounts_js_1.AccountsResource; } });
+var transactions_js_1 = require("./resources/transactions.js");
+Object.defineProperty(exports, "TransactionsResource", { enumerable: true, get: function () { return transactions_js_1.TransactionsResource; } });
+var tokens_js_1 = require("./resources/tokens.js");
+Object.defineProperty(exports, "TokensResource", { enumerable: true, get: function () { return tokens_js_1.TokensResource; } });
+var topics_js_1 = require("./resources/topics.js");
+Object.defineProperty(exports, "TopicsResource", { enumerable: true, get: function () { return topics_js_1.TopicsResource; } });
+var contracts_js_1 = require("./resources/contracts.js");
+Object.defineProperty(exports, "ContractsResource", { enumerable: true, get: function () { return contracts_js_1.ContractsResource; } });
+var nfts_js_1 = require("./resources/nfts.js");
+Object.defineProperty(exports, "NftsResource", { enumerable: true, get: function () { return nfts_js_1.NftsResource; } });
+var balances_js_1 = require("./resources/balances.js");
+Object.defineProperty(exports, "BalancesResource", { enumerable: true, get: function () { return balances_js_1.BalancesResource; } });
+var blocks_js_1 = require("./resources/blocks.js");
+Object.defineProperty(exports, "BlocksResource", { enumerable: true, get: function () { return blocks_js_1.BlocksResource; } });
+var schedules_js_1 = require("./resources/schedules.js");
+Object.defineProperty(exports, "SchedulesResource", { enumerable: true, get: function () { return schedules_js_1.SchedulesResource; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAEtC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,SAAS;AACT,0DAAsD;AAA7C,6GAAA,WAAW,OAAA;AACpB,8CAA6C;AAApC,oGAAA,QAAQ,OAAA;AAGjB,SAAS;AACT,8CAK2B;AAJzB,sGAAA,UAAU,OAAA;AACV,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AAGjB,YAAY;AACZ,uDAA2D;AAAlD,+GAAA,gBAAgB,OAAA;AACzB,+DAAmE;AAA1D,uHAAA,oBAAoB,OAAA;AAC7B,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AACvB,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AACvB,yDAA6D;AAApD,iHAAA,iBAAiB,OAAA;AAC1B,+CAAmD;AAA1C,uGAAA,YAAY,OAAA;AACrB,uDAA2D;AAAlD,+GAAA,gBAAgB,OAAA;AACzB,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AACvB,yDAA6D;AAApD,iHAAA,iBAAiB,OAAA"}

package/dist/cjs/pagination/paginator.d.ts

@@ -0,0 +1,21 @@
+import type { HieroClient } from '../client/HieroClient.js';
+/**
+ * Creates an async generator that paginates through a Mirror Node list endpoint.
+ * Follows the `links.next` field to automatically fetch subsequent pages.
+ *
+ * @param client - The HieroClient instance to use for HTTP requests
+ * @param path - The API path for the list endpoint (e.g., '/api/v1/accounts')
+ * @param dataKey - The key in the response object that contains the data array (e.g., 'accounts')
+ * @param params - Optional query parameters for filtering/sorting
+ * @returns An async generator that yields individual items of type T
+ * @throws {PaginationError} If the response shape is unexpected
+ *
+ * @example
+ * ```ts
+ * for await (const account of paginate<AccountInfo>(client, '/api/v1/accounts', 'accounts')) {
+ *   console.log(account.account);
+ * }
+ * ```
+ */
+export declare function paginate<T>(client: HieroClient, path: string, dataKey: string, params?: Record<string, string | number | boolean | undefined>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=paginator.d.ts.map

package/dist/cjs/pagination/paginator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginator.d.ts","sourceRoot":"","sources":["../../../src/pagination/paginator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA+C5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAkCpC"}

package/dist/cjs/pagination/paginator.js

@@ -0,0 +1,89 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginate = paginate;
+const index_js_1 = require("../errors/index.js");
+/**
+ * Builds a query string from parameters.
+ *
+ * @param path - The base API path
+ * @param params - Optional key-value query parameters
+ * @returns The full path with query string appended
+ */
+function buildUrl(path, params) {
+    if (!params) {
+        return path;
+    }
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            searchParams.set(key, String(value));
+        }
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `${path}?${queryString}` : path;
+}
+/**
+ * Extracts the `links.next` value from a Mirror Node paginated response.
+ *
+ * @param body - The raw JSON response object
+ * @returns The next page URL or null
+ */
+function extractNextLink(body) {
+    const links = body['links'];
+    if (links !== null && typeof links === 'object' && !Array.isArray(links)) {
+        const linksObj = links;
+        const next = linksObj['next'];
+        if (typeof next === 'string' && next.length > 0) {
+            return next;
+        }
+    }
+    return null;
+}
+/**
+ * Creates an async generator that paginates through a Mirror Node list endpoint.
+ * Follows the `links.next` field to automatically fetch subsequent pages.
+ *
+ * @param client - The HieroClient instance to use for HTTP requests
+ * @param path - The API path for the list endpoint (e.g., '/api/v1/accounts')
+ * @param dataKey - The key in the response object that contains the data array (e.g., 'accounts')
+ * @param params - Optional query parameters for filtering/sorting
+ * @returns An async generator that yields individual items of type T
+ * @throws {PaginationError} If the response shape is unexpected
+ *
+ * @example
+ * ```ts
+ * for await (const account of paginate<AccountInfo>(client, '/api/v1/accounts', 'accounts')) {
+ *   console.log(account.account);
+ * }
+ * ```
+ */
+async function* paginate(client, path, dataKey, params) {
+    let url = buildUrl(path, params);
+    while (url !== null) {
+        const body = await client.get(url);
+        const items = body[dataKey];
+        if (!Array.isArray(items)) {
+            throw new index_js_1.PaginationError(`Expected array at key "${dataKey}" in response from ${url}, got ${typeof items}`, 'INVALID_RESPONSE_SHAPE');
+        }
+        for (const item of items) {
+            yield item;
+        }
+        // If the page was empty, stop regardless of links
+        if (items.length === 0) {
+            break;
+        }
+        const nextLink = extractNextLink(body);
+        if (nextLink === null) {
+            url = null;
+        }
+        else if (nextLink.startsWith('http')) {
+            url = nextLink;
+        }
+        else {
+            // Relative URL from the Mirror Node
+            url = nextLink.startsWith('/') ? nextLink : `/${nextLink}`;
+        }
+    }
+}
+//# sourceMappingURL=paginator.js.map

package/dist/cjs/pagination/paginator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginator.js","sourceRoot":"","sources":["../../../src/pagination/paginator.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AAmEtC,4BAuCC;AAvGD,iDAAqD;AAErD;;;;;;GAMG;AACH,SAAS,QAAQ,CACf,IAAY,EACZ,MAA8D;IAE9D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IAC5C,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAA6B;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAG,KAAgC,CAAC;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,MAAmB,EACnB,IAAY,EACZ,OAAe,EACf,MAA8D;IAE9D,IAAI,GAAG,GAAkB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,GAA4B,MAAM,MAAM,CAAC,GAAG,CAA0B,GAAG,CAAC,CAAC;QACrF,MAAM,KAAK,GAAY,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,0BAAe,CACvB,0BAA0B,OAAO,sBAAsB,GAAG,SAAS,OAAO,KAAK,EAAE,EACjF,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAS,CAAC;QAClB,CAAC;QAED,kDAAkD;QAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAkB,eAAe,CAAC,IAAI,CAAC,CAAC;QAEtD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,GAAG,GAAG,QAAQ,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/resources/accounts.d.ts

@@ -0,0 +1,43 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { AccountInfo, AccountsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node account endpoints.
+ *
+ * @example
+ * ```ts
+ * const account = await client.accounts.getById('0.0.1234');
+ * for await (const a of client.accounts.list({ limit: 10 })) {
+ *   console.log(a.account);
+ * }
+ * ```
+ */
+export declare class AccountsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single account by ID.
+     *
+     * @param accountId - Account in `0.0.X` format
+     * @returns The account info including balance, key, and staking data
+     * @throws {ValidationError} If accountId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(accountId: string): Promise<AccountInfo>;
+    /**
+     * Lists accounts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of account info objects
+     *
+     * @example
+     * ```ts
+     * for await (const account of client.accounts.list({ limit: 5, order: 'desc' })) {
+     *   console.log(account.account, account.balance.balance);
+     * }
+     * ```
+     */
+    list(params?: AccountsQueryParams): AsyncIterable<AccountInfo>;
+    private validateAccountId;
+}
+//# sourceMappingURL=accounts.d.ts.map

package/dist/cjs/resources/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../src/resources/accounts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKxE;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKtD;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC,WAAW,CAAC;IAS9D,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/cjs/resources/accounts.js

@@ -0,0 +1,60 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountsResource = void 0;
+const paginator_js_1 = require("../pagination/paginator.js");
+const index_js_1 = require("../errors/index.js");
+const common_js_1 = require("../types/common.js");
+/**
+ * Provides access to Mirror Node account endpoints.
+ *
+ * @example
+ * ```ts
+ * const account = await client.accounts.getById('0.0.1234');
+ * for await (const a of client.accounts.list({ limit: 10 })) {
+ *   console.log(a.account);
+ * }
+ * ```
+ */
+class AccountsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single account by ID.
+     *
+     * @param accountId - Account in `0.0.X` format
+     * @returns The account info including balance, key, and staking data
+     * @throws {ValidationError} If accountId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(accountId) {
+        this.validateAccountId(accountId);
+        return this.client.get(`/api/v1/accounts/${accountId}`);
+    }
+    /**
+     * Lists accounts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of account info objects
+     *
+     * @example
+     * ```ts
+     * for await (const account of client.accounts.list({ limit: 5, order: 'desc' })) {
+     *   console.log(account.account, account.balance.balance);
+     * }
+     * ```
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/accounts', 'accounts', params);
+    }
+    validateAccountId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid account ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_ACCOUNT_ID');
+        }
+    }
+}
+exports.AccountsResource = AccountsResource;
+//# sourceMappingURL=accounts.js.map

package/dist/cjs/resources/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/resources/accounts.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AACrD,kDAAuD;AAEvD;;;;;;;;;;GAUG;AACH,MAAa,gBAAgB;IACE;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,oBAAoB,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAA4B;QAC/B,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,UAAU,EACV,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,EAAU;QAClC,IAAI,CAAC,6BAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,0BAAe,CACvB,+BAA+B,EAAE,0DAA0D,EAC3F,oBAAoB,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA/CD,4CA+CC"}

package/dist/cjs/resources/balances.d.ts

@@ -0,0 +1,25 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { BalanceEntry, BalancesQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node balance endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const entry of client.balances.list({ limit: 10 })) {
+ *   console.log(entry.account, entry.balance);
+ * }
+ * ```
+ */
+export declare class BalancesResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Lists account balances with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of balance entry objects
+     */
+    list(params?: BalancesQueryParams): AsyncIterable<BalanceEntry>;
+}
+//# sourceMappingURL=balances.d.ts.map

package/dist/cjs/resources/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../../src/resources/balances.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGzE;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC,YAAY,CAAC;CAQhE"}

package/dist/cjs/resources/balances.js

@@ -0,0 +1,33 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BalancesResource = void 0;
+const paginator_js_1 = require("../pagination/paginator.js");
+/**
+ * Provides access to Mirror Node balance endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const entry of client.balances.list({ limit: 10 })) {
+ *   console.log(entry.account, entry.balance);
+ * }
+ * ```
+ */
+class BalancesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Lists account balances with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of balance entry objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/balances', 'balances', params);
+    }
+}
+exports.BalancesResource = BalancesResource;
+//# sourceMappingURL=balances.js.map

package/dist/cjs/resources/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","sourceRoot":"","sources":["../../../src/resources/balances.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AAEtD;;;;;;;;;GASG;AACH,MAAa,gBAAgB;IACE;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,IAAI,CAAC,MAA4B;QAC/B,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,UAAU,EACV,MAA+D,CAChE,CAAC;IACJ,CAAC;CACF;AAlBD,4CAkBC"}

package/dist/cjs/resources/blocks.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { BlockInfo, BlocksQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node block endpoints.
+ *
+ * @example
+ * ```ts
+ * const block = await client.blocks.getByHashOrNumber(12345);
+ * for await (const b of client.blocks.list()) {
+ *   console.log(b.number, b.hash);
+ * }
+ * ```
+ */
+export declare class BlocksResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single block by hash or number.
+     *
+     * @param hashOrNumber - Block hash (hex string) or block number
+     * @returns The block info including hash, timestamp, and gas used
+     * @throws {ValidationError} If the input is neither a valid hash nor a number
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getByHashOrNumber(hashOrNumber: string | number): Promise<BlockInfo>;
+    /**
+     * Lists blocks with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of block info objects
+     */
+    list(params?: BlocksQueryParams): AsyncIterable<BlockInfo>;
+    private validateHashOrNumber;
+}
+//# sourceMappingURL=blocks.d.ts.map

package/dist/cjs/resources/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/resources/blocks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIpE;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAK1E;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC;IAS1D,OAAO,CAAC,oBAAoB;CAiB7B"}

package/dist/cjs/resources/blocks.js

@@ -0,0 +1,58 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocksResource = void 0;
+const paginator_js_1 = require("../pagination/paginator.js");
+const index_js_1 = require("../errors/index.js");
+/**
+ * Provides access to Mirror Node block endpoints.
+ *
+ * @example
+ * ```ts
+ * const block = await client.blocks.getByHashOrNumber(12345);
+ * for await (const b of client.blocks.list()) {
+ *   console.log(b.number, b.hash);
+ * }
+ * ```
+ */
+class BlocksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single block by hash or number.
+     *
+     * @param hashOrNumber - Block hash (hex string) or block number
+     * @returns The block info including hash, timestamp, and gas used
+     * @throws {ValidationError} If the input is neither a valid hash nor a number
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getByHashOrNumber(hashOrNumber) {
+        this.validateHashOrNumber(hashOrNumber);
+        return this.client.get(`/api/v1/blocks/${hashOrNumber}`);
+    }
+    /**
+     * Lists blocks with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of block info objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/blocks', 'blocks', params);
+    }
+    validateHashOrNumber(value) {
+        if (typeof value === 'number') {
+            if (!Number.isInteger(value) || value < 0) {
+                throw new index_js_1.ValidationError(`Invalid block number: ${value}. Must be a non-negative integer.`, 'INVALID_BLOCK_NUMBER');
+            }
+            return;
+        }
+        if (typeof value === 'string' && value.length === 0) {
+            throw new index_js_1.ValidationError('Block hash or number must not be empty.', 'INVALID_BLOCK_IDENTIFIER');
+        }
+    }
+}
+exports.BlocksResource = BlocksResource;
+//# sourceMappingURL=blocks.js.map

package/dist/cjs/resources/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/resources/blocks.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AAErD;;;;;;;;;;GAUG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CAAC,YAA6B;QACnD,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAY,kBAAkB,YAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA0B;QAC7B,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,gBAAgB,EAChB,QAAQ,EACR,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,KAAsB;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,0BAAe,CACvB,yBAAyB,KAAK,mCAAmC,EACjE,sBAAsB,CACvB,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,0BAAe,CACvB,yCAAyC,EACzC,0BAA0B,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAjDD,wCAiDC"}

package/dist/cjs/resources/contracts.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { ContractInfo, ContractsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node contract endpoints.
+ *
+ * @example
+ * ```ts
+ * const contract = await client.contracts.getById('0.0.1234');
+ * for await (const c of client.contracts.list()) {
+ *   console.log(c.contract_id);
+ * }
+ * ```
+ */
+export declare class ContractsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single contract by ID.
+     *
+     * @param contractId - Contract in `0.0.X` format
+     * @returns The contract info including EVM address and timestamps
+     * @throws {ValidationError} If contractId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(contractId: string): Promise<ContractInfo>;
+    /**
+     * Lists contracts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of contract info objects
+     */
+    list(params?: ContractsQueryParams): AsyncIterable<ContractInfo>;
+    private validateContractId;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/cjs/resources/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/resources/contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAK1E;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKxD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,YAAY,CAAC;IAShE,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/cjs/resources/contracts.js

@@ -0,0 +1,53 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractsResource = void 0;
+const paginator_js_1 = require("../pagination/paginator.js");
+const index_js_1 = require("../errors/index.js");
+const common_js_1 = require("../types/common.js");
+/**
+ * Provides access to Mirror Node contract endpoints.
+ *
+ * @example
+ * ```ts
+ * const contract = await client.contracts.getById('0.0.1234');
+ * for await (const c of client.contracts.list()) {
+ *   console.log(c.contract_id);
+ * }
+ * ```
+ */
+class ContractsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single contract by ID.
+     *
+     * @param contractId - Contract in `0.0.X` format
+     * @returns The contract info including EVM address and timestamps
+     * @throws {ValidationError} If contractId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(contractId) {
+        this.validateContractId(contractId);
+        return this.client.get(`/api/v1/contracts/${contractId}`);
+    }
+    /**
+     * Lists contracts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of contract info objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/contracts', 'contracts', params);
+    }
+    validateContractId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid contract ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_CONTRACT_ID');
+        }
+    }
+}
+exports.ContractsResource = ContractsResource;
+//# sourceMappingURL=contracts.js.map

package/dist/cjs/resources/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/resources/contracts.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AACrD,kDAAuD;AAEvD;;;;;;;;;;GAUG;AACH,MAAa,iBAAiB;IACC;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAe,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA6B;QAChC,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,mBAAmB,EACnB,WAAW,EACX,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,EAAU;QACnC,IAAI,CAAC,6BAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,0BAAe,CACvB,gCAAgC,EAAE,0DAA0D,EAC5F,qBAAqB,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAxCD,8CAwCC"}

package/dist/cjs/resources/nfts.d.ts

@@ -0,0 +1,39 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { NftInfo, NftsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node NFT endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const nft of client.nfts.listByToken('0.0.1234')) {
+ *   console.log(nft.serial_number, nft.account_id);
+ * }
+ * ```
+ */
+export declare class NftsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a specific NFT by token ID and serial number.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param serialNumber - The NFT serial number
+     * @returns The NFT info including metadata and owner
+     * @throws {ValidationError} If tokenId format is invalid or serialNumber is not positive
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getByTokenAndSerial(tokenId: string, serialNumber: number): Promise<NftInfo>;
+    /**
+     * Lists NFTs for a token. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of NFT info objects
+     * @throws {ValidationError} If tokenId format is invalid
+     */
+    listByToken(tokenId: string, params?: NftsQueryParams): AsyncIterable<NftInfo>;
+    private validateTokenId;
+    private validateSerialNumber;
+}
+//# sourceMappingURL=nfts.d.ts.map

package/dist/cjs/resources/nfts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.d.ts","sourceRoot":"","sources":["../../../src/resources/nfts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKhE;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;;OAQG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlF;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC;IAU9E,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,oBAAoB;CAQ7B"}