hiero-sdk-utils 0.1.0

package/dist/cjs/resources/nfts.js

@@ -0,0 +1,62 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NftsResource = 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 NFT endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const nft of client.nfts.listByToken('0.0.1234')) {
+ *   console.log(nft.serial_number, nft.account_id);
+ * }
+ * ```
+ */
+class NftsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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
+     */
+    async getByTokenAndSerial(tokenId, serialNumber) {
+        this.validateTokenId(tokenId);
+        this.validateSerialNumber(serialNumber);
+        return this.client.get(`/api/v1/tokens/${tokenId}/nfts/${serialNumber}`);
+    }
+    /**
+     * 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, params) {
+        this.validateTokenId(tokenId);
+        return (0, paginator_js_1.paginate)(this.client, `/api/v1/tokens/${tokenId}/nfts`, 'nfts', params);
+    }
+    validateTokenId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid token ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOKEN_ID');
+        }
+    }
+    validateSerialNumber(serial) {
+        if (!Number.isInteger(serial) || serial <= 0) {
+            throw new index_js_1.ValidationError(`Invalid serial number: ${serial}. Must be a positive integer.`, 'INVALID_SERIAL_NUMBER');
+        }
+    }
+}
+exports.NftsResource = NftsResource;
+//# sourceMappingURL=nfts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.js","sourceRoot":"","sources":["../../../src/resources/nfts.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AACrD,kDAAuD;AAEvD;;;;;;;;;GASG;AACH,MAAa,YAAY;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,YAAoB;QAC7D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACpB,kBAAkB,OAAO,SAAS,YAAY,EAAE,CACjD,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAe,EAAE,MAAwB;QACnD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,kBAAkB,OAAO,OAAO,EAChC,MAAM,EACN,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,EAAU;QAChC,IAAI,CAAC,6BAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,0BAAe,CACvB,6BAA6B,EAAE,0DAA0D,EACzF,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,MAAc;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,0BAAe,CACvB,0BAA0B,MAAM,+BAA+B,EAC/D,uBAAuB,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAxDD,oCAwDC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/resources/schedules.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/schedules.js

@@ -0,0 +1,53 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedulesResource = 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 schedule endpoints.
+ *
+ * @example
+ * ```ts
+ * const schedule = await client.schedules.getById('0.0.1234');
+ * for await (const s of client.schedules.list()) {
+ *   console.log(s.schedule_id);
+ * }
+ * ```
+ */
+class SchedulesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single schedule by ID.
+     *
+     * @param scheduleId - Schedule in `0.0.X` format
+     * @returns The schedule info including signatures and execution status
+     * @throws {ValidationError} If scheduleId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(scheduleId) {
+        this.validateScheduleId(scheduleId);
+        return this.client.get(`/api/v1/schedules/${scheduleId}`);
+    }
+    /**
+     * Lists schedules with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of schedule info objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/schedules', 'schedules', params);
+    }
+    validateScheduleId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid schedule ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_SCHEDULE_ID');
+        }
+    }
+}
+exports.SchedulesResource = SchedulesResource;
+//# sourceMappingURL=schedules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../../src/resources/schedules.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/tokens.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TokenInfo, TokensQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node token endpoints.
+ *
+ * @example
+ * ```ts
+ * const token = await client.tokens.getById('0.0.1234');
+ * for await (const t of client.tokens.list({ type: 'FUNGIBLE_COMMON' })) {
+ *   console.log(t.name, t.symbol);
+ * }
+ * ```
+ */
+export declare class TokensResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single token by ID.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @returns The token info including supply, keys, and custom fees
+     * @throws {ValidationError} If tokenId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(tokenId: string): Promise<TokenInfo>;
+    /**
+     * Lists tokens with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of token info objects
+     */
+    list(params?: TokensQueryParams): AsyncIterable<TokenInfo>;
+    private validateTokenId;
+}
+//# sourceMappingURL=tokens.d.ts.map

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

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

package/dist/cjs/resources/tokens.js

@@ -0,0 +1,53 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensResource = 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 token endpoints.
+ *
+ * @example
+ * ```ts
+ * const token = await client.tokens.getById('0.0.1234');
+ * for await (const t of client.tokens.list({ type: 'FUNGIBLE_COMMON' })) {
+ *   console.log(t.name, t.symbol);
+ * }
+ * ```
+ */
+class TokensResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single token by ID.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @returns The token info including supply, keys, and custom fees
+     * @throws {ValidationError} If tokenId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(tokenId) {
+        this.validateTokenId(tokenId);
+        return this.client.get(`/api/v1/tokens/${tokenId}`);
+    }
+    /**
+     * Lists tokens with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of token info objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/tokens', 'tokens', params);
+    }
+    validateTokenId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid token ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOKEN_ID');
+        }
+    }
+}
+exports.TokensResource = TokensResource;
+//# sourceMappingURL=tokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AACrD,kDAAuD;AAEvD;;;;;;;;;;GAUG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAY,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACjE,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,eAAe,CAAC,EAAU;QAChC,IAAI,CAAC,6BAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,0BAAe,CACvB,6BAA6B,EAAE,0DAA0D,EACzF,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAxCD,wCAwCC"}

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

@@ -0,0 +1,38 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TopicInfo, TopicMessage, TopicMessagesQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node topic endpoints.
+ *
+ * @example
+ * ```ts
+ * const topic = await client.topics.getById('0.0.1234');
+ * for await (const msg of client.topics.listMessages('0.0.1234')) {
+ *   console.log(msg.message);
+ * }
+ * ```
+ */
+export declare class TopicsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves topic info by ID.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @returns The topic info including keys and memo
+     * @throws {ValidationError} If topicId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(topicId: string): Promise<TopicInfo>;
+    /**
+     * Lists messages for a topic. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of topic message objects
+     * @throws {ValidationError} If topicId format is invalid
+     */
+    listMessages(topicId: string, params?: TopicMessagesQueryParams): AsyncIterable<TopicMessage>;
+    private validateTopicId;
+}
+//# sourceMappingURL=topics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../../src/resources/topics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAKzF;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlD;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,aAAa,CAAC,YAAY,CAAC;IAU7F,OAAO,CAAC,eAAe;CAQxB"}

package/dist/cjs/resources/topics.js

@@ -0,0 +1,56 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicsResource = 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 topic endpoints.
+ *
+ * @example
+ * ```ts
+ * const topic = await client.topics.getById('0.0.1234');
+ * for await (const msg of client.topics.listMessages('0.0.1234')) {
+ *   console.log(msg.message);
+ * }
+ * ```
+ */
+class TopicsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves topic info by ID.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @returns The topic info including keys and memo
+     * @throws {ValidationError} If topicId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(topicId) {
+        this.validateTopicId(topicId);
+        return this.client.get(`/api/v1/topics/${topicId}`);
+    }
+    /**
+     * Lists messages for a topic. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of topic message objects
+     * @throws {ValidationError} If topicId format is invalid
+     */
+    listMessages(topicId, params) {
+        this.validateTopicId(topicId);
+        return (0, paginator_js_1.paginate)(this.client, `/api/v1/topics/${topicId}/messages`, 'messages', params);
+    }
+    validateTopicId(id) {
+        if (!common_js_1.ENTITY_ID_PATTERN.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid topic ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOPIC_ID');
+        }
+    }
+}
+exports.TopicsResource = TopicsResource;
+//# sourceMappingURL=topics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/resources/topics.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AACrD,kDAAuD;AAEvD;;;;;;;;;;GAUG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAY,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAe,EAAE,MAAiC;QAC7D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,kBAAkB,OAAO,WAAW,EACpC,UAAU,EACV,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,EAAU;QAChC,IAAI,CAAC,6BAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,0BAAe,CACvB,6BAA6B,EAAE,0DAA0D,EACzF,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA3CD,wCA2CC"}

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

@@ -0,0 +1,35 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TransactionInfo, TransactionsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node transaction endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const tx of client.transactions.list({ limit: 10 })) {
+ *   console.log(tx.transaction_id, tx.result);
+ * }
+ * ```
+ */
+export declare class TransactionsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single transaction by its transaction ID.
+     *
+     * @param transactionId - Transaction ID in `shard.realm.num-ssssssssss-nnnnnnnnn` format
+     * @returns The transaction info including transfers and result
+     * @throws {ValidationError} If the transaction ID format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(transactionId: string): Promise<TransactionInfo>;
+    /**
+     * Lists transactions with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of transaction info objects
+     */
+    list(params?: TransactionsQueryParams): AsyncIterable<TransactionInfo>;
+    private validateTransactionId;
+}
+//# sourceMappingURL=transactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAIhF;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAe9D;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC,eAAe,CAAC;IAStE,OAAO,CAAC,qBAAqB;CAS9B"}

package/dist/cjs/resources/transactions.js

@@ -0,0 +1,57 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionsResource = void 0;
+const paginator_js_1 = require("../pagination/paginator.js");
+const index_js_1 = require("../errors/index.js");
+/**
+ * Provides access to Mirror Node transaction endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const tx of client.transactions.list({ limit: 10 })) {
+ *   console.log(tx.transaction_id, tx.result);
+ * }
+ * ```
+ */
+class TransactionsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single transaction by its transaction ID.
+     *
+     * @param transactionId - Transaction ID in `shard.realm.num-ssssssssss-nnnnnnnnn` format
+     * @returns The transaction info including transfers and result
+     * @throws {ValidationError} If the transaction ID format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(transactionId) {
+        this.validateTransactionId(transactionId);
+        const response = await this.client.get(`/api/v1/transactions/${transactionId}`);
+        const first = response.transactions[0];
+        if (!first) {
+            throw new index_js_1.ValidationError(`No transaction found for ID: "${transactionId}"`, 'TRANSACTION_NOT_FOUND');
+        }
+        return first;
+    }
+    /**
+     * Lists transactions with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of transaction info objects
+     */
+    list(params) {
+        return (0, paginator_js_1.paginate)(this.client, '/api/v1/transactions', 'transactions', params);
+    }
+    validateTransactionId(id) {
+        // Format: 0.0.XXXX-SSSSSSSSSS-NNNNNNNNN
+        if (!/^\d+\.\d+\.\d+-\d+-\d+$/.test(id)) {
+            throw new index_js_1.ValidationError(`Invalid transaction ID format: "${id}". Expected "shard.realm.num-seconds-nanos" format.`, 'INVALID_TRANSACTION_ID');
+        }
+    }
+}
+exports.TransactionsResource = TransactionsResource;
+//# sourceMappingURL=transactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAItC,6DAAsD;AACtD,iDAAqD;AAErD;;;;;;;;;GASG;AACH,MAAa,oBAAoB;IACF;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,aAAqB;QACjC,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,wBAAwB,aAAa,EAAE,CACxC,CAAC;QACF,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,0BAAe,CACvB,iCAAiC,aAAa,GAAG,EACjD,uBAAuB,CACxB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAgC;QACnC,OAAO,IAAA,uBAAQ,EACb,IAAI,CAAC,MAAM,EACX,sBAAsB,EACtB,cAAc,EACd,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,EAAU;QACtC,wCAAwC;QACxC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,0BAAe,CACvB,mCAAmC,EAAE,qDAAqD,EAC1F,wBAAwB,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAnDD,oDAmDC"}