@ohmpathorn/block-node-client 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9F,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtoReader = exports.decodeBlockItem = exports.STATE_IDS = exports.RESPONSE_CODES = exports.TX_TYPES = exports.BlockNodeClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "BlockNodeClient", { enumerable: true, get: function () { return client_1.BlockNodeClient; } });
+var decoder_1 = require("./decoder");
+Object.defineProperty(exports, "TX_TYPES", { enumerable: true, get: function () { return decoder_1.TX_TYPES; } });
+Object.defineProperty(exports, "RESPONSE_CODES", { enumerable: true, get: function () { return decoder_1.RESPONSE_CODES; } });
+Object.defineProperty(exports, "STATE_IDS", { enumerable: true, get: function () { return decoder_1.STATE_IDS; } });
+Object.defineProperty(exports, "decodeBlockItem", { enumerable: true, get: function () { return decoder_1.decodeBlockItem; } });
+Object.defineProperty(exports, "ProtoReader", { enumerable: true, get: function () { return decoder_1.ProtoReader; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA2C;AAAlC,yGAAA,eAAe,OAAA;AACxB,qCAA8F;AAArF,mGAAA,QAAQ,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC1E,0CAAwB"}

package/dist/proto-manager.d.ts

@@ -0,0 +1,22 @@
+import * as grpc from "@grpc/grpc-js";
+/**
+ * Manages inline proto definitions and loaded gRPC clients.
+ * Protos are written to a temp directory at construction and cleaned up on close().
+ */
+export declare class ProtoManager {
+    private readonly endpoint;
+    private readonly tls;
+    private protoDir;
+    private _nodeClient;
+    private _blockClient;
+    private _streamClient;
+    constructor(endpoint: string, tls: "tls" | "insecure");
+    get nodeClient(): grpc.Client;
+    get blockClient(): grpc.Client;
+    get streamClient(): grpc.Client;
+    cleanup(): void;
+    private write;
+    private writeProtos;
+    private loadClients;
+}
+//# sourceMappingURL=proto-manager.d.ts.map

package/dist/proto-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-manager.d.ts","sourceRoot":"","sources":["../src/proto-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAGtC;;;GAGG;AACH,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAU,OAAO,CAAC,QAAQ,CAAC,GAAG;IALnE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAA4B;gBAEpB,QAAQ,EAAE,MAAM,EAAmB,GAAG,EAAE,KAAK,GAAG,UAAU;IAMvF,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,CAE5B;IACD,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAE7B;IACD,IAAI,YAAY,IAAI,IAAI,CAAC,MAAM,CAE9B;IAED,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,WAAW;IA8GnB,OAAO,CAAC,WAAW;CA4BpB"}

package/dist/proto-manager.js

@@ -0,0 +1,207 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtoManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+/**
+ * Manages inline proto definitions and loaded gRPC clients.
+ * Protos are written to a temp directory at construction and cleaned up on close().
+ */
+class ProtoManager {
+    constructor(endpoint, tls) {
+        this.endpoint = endpoint;
+        this.tls = tls;
+        this._nodeClient = null;
+        this._blockClient = null;
+        this._streamClient = null;
+        this.protoDir = fs.mkdtempSync(path.join(os.tmpdir(), "bnproto-"));
+        this.writeProtos();
+        this.loadClients();
+    }
+    get nodeClient() {
+        return this._nodeClient;
+    }
+    get blockClient() {
+        return this._blockClient;
+    }
+    get streamClient() {
+        return this._streamClient;
+    }
+    cleanup() {
+        try {
+            fs.rmSync(this.protoDir, { recursive: true, force: true });
+        }
+        catch (_) { }
+    }
+    write(rel, content) {
+        const full = path.join(this.protoDir, rel);
+        fs.mkdirSync(path.dirname(full), { recursive: true });
+        fs.writeFileSync(full, content);
+    }
+    writeProtos() {
+        // ── Shared stubs ────────────────────────────────────────────────────────
+        this.write("services/basic_types.proto", `
+syntax = "proto3"; package proto;
+message Timestamp       { int64 seconds = 1; int32 nanos = 2; }
+message AccountID       { uint64 shardNum = 1; uint64 realmNum = 2; oneof account { uint64 accountNum = 3; bytes alias = 4; } }
+message SemanticVersion { uint32 major = 1; uint32 minor = 2; uint32 patch = 3; }
+message TransferList    { repeated AccountAmount accountAmounts = 1; }
+message AccountAmount   { proto.AccountID accountID = 1; int64 amount = 2; bool is_approval = 3; }
+message NodeAddressBook { repeated NodeAddress nodeAddress = 1; }
+message NodeAddress     { bytes RSA_PubKey = 1; int64 nodeId = 2; }
+`);
+        // ── BlockItemSet (repeated bytes so inner decoding is handled manually) ──
+        this.write("block-node/api/shared_message_types.proto", `
+syntax = "proto3"; package org.hiero.block.api;
+message BlockItemSet { repeated bytes block_items = 1; }
+message BlockEnd     { uint64 block_number = 1; }
+`);
+        // ── Block (for getBlock response) — repeated bytes inner items ───────────
+        this.write("block/stream/block.proto", `
+syntax = "proto3"; package com.hedera.hapi.block.stream;
+message Block { repeated bytes items = 1; }
+`);
+        // ── NodeService ──────────────────────────────────────────────────────────
+        this.write("block-node/api/node_service.proto", `
+syntax = "proto3"; package org.hiero.block.api;
+import "services/basic_types.proto";
+
+message ServerStatusRequest {}
+message ServerStatusResponse {
+  uint64 first_available_block  = 1;
+  uint64 last_available_block   = 2;
+  bool   only_latest_state      = 3;
+  uint64 next_expected_block    = 4;
+}
+message BlockRange { uint64 range_start = 1; uint64 range_end = 2; }
+message PluginVersion {
+  string plugin_id = 1;
+  proto.SemanticVersion plugin_software_version = 2;
+  repeated string plugin_feature_names = 3;
+}
+message BlockNodeVersions {
+  proto.SemanticVersion stream_proto_version = 1;
+  proto.SemanticVersion block_node_version   = 2;
+  repeated PluginVersion installed_plugin_versions = 3;
+}
+message ServerStatusDetailResponse {
+  BlockNodeVersions      version_information  = 1;
+  repeated BlockRange    available_ranges     = 2;
+  bytes                  tss_data             = 3;
+  proto.NodeAddressBook  node_address_book    = 4;
+  repeated BlockRange    stored_ranges        = 5;
+}
+service BlockNodeService {
+  rpc serverStatus       (ServerStatusRequest) returns (ServerStatusResponse);
+  rpc serverStatusDetail (ServerStatusRequest) returns (ServerStatusDetailResponse);
+}
+`);
+        // ── BlockAccessService ───────────────────────────────────────────────────
+        this.write("block-node/api/block_access_service.proto", `
+syntax = "proto3"; package org.hiero.block.api;
+import "block/stream/block.proto";
+message BlockRequest {
+  oneof block_specifier {
+    uint64 block_number    = 1;
+    bool   retrieve_latest = 2;
+  }
+}
+message BlockResponse {
+  enum Code {
+    UNKNOWN = 0; SUCCESS = 1; INVALID_REQUEST = 2;
+    ERROR = 3; NOT_FOUND = 4; NOT_AVAILABLE = 5;
+  }
+  Code   status = 1;
+  com.hedera.hapi.block.stream.Block block = 2;
+}
+service BlockAccessService {
+  rpc getBlock (BlockRequest) returns (BlockResponse);
+}
+`);
+        // ── BlockStreamSubscribeService ──────────────────────────────────────────
+        this.write("block-node/api/block_stream_subscribe_service.proto", `
+syntax = "proto3"; package org.hiero.block.api;
+import "block-node/api/shared_message_types.proto";
+message SubscribeStreamRequest {
+  uint64 start_block_number = 1;
+  uint64 end_block_number   = 2;
+}
+message SubscribeStreamResponse {
+  enum Code {
+    UNKNOWN = 0; SUCCESS = 1; INVALID_REQUEST = 2; ERROR = 3;
+    INVALID_START_BLOCK_NUMBER = 4; INVALID_END_BLOCK_NUMBER = 5; NOT_AVAILABLE = 6;
+  }
+  oneof response {
+    Code                              status      = 1;
+    org.hiero.block.api.BlockItemSet  block_items = 2;
+    org.hiero.block.api.BlockEnd      end_of_block = 3;
+  }
+}
+service BlockStreamSubscribeService {
+  rpc subscribeBlockStream (SubscribeStreamRequest) returns (stream SubscribeStreamResponse);
+}
+`);
+    }
+    loadClients() {
+        const opts = {
+            keepCase: true,
+            longs: String,
+            enums: String,
+            defaults: true,
+            oneofs: true,
+            includeDirs: [this.protoDir],
+        };
+        const creds = this.tls === "insecure"
+            ? grpc.credentials.createInsecure()
+            : grpc.credentials.createSsl(null, null, null, {
+                checkServerIdentity: () => undefined,
+            });
+        const nodeDef = protoLoader.loadSync(path.join(this.protoDir, "block-node/api/node_service.proto"), opts);
+        const blockDef = protoLoader.loadSync(path.join(this.protoDir, "block-node/api/block_access_service.proto"), opts);
+        const streamDef = protoLoader.loadSync(path.join(this.protoDir, "block-node/api/block_stream_subscribe_service.proto"), opts);
+        const nodePkg = grpc.loadPackageDefinition(nodeDef)["org"]["hiero"]["block"]["api"];
+        const blockPkg = grpc.loadPackageDefinition(blockDef)["org"]["hiero"]["block"]["api"];
+        const streamPkg = grpc.loadPackageDefinition(streamDef)["org"]["hiero"]["block"]["api"];
+        this._nodeClient = new nodePkg.BlockNodeService(this.endpoint, creds);
+        this._blockClient = new blockPkg.BlockAccessService(this.endpoint, creds);
+        this._streamClient = new streamPkg.BlockStreamSubscribeService(this.endpoint, creds);
+    }
+}
+exports.ProtoManager = ProtoManager;
+//# sourceMappingURL=proto-manager.js.map

package/dist/proto-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-manager.js","sourceRoot":"","sources":["../src/proto-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,oDAAsC;AACtC,gEAAkD;AAElD;;;GAGG;AACH,MAAa,YAAY;IAMvB,YAA6B,QAAgB,EAAmB,GAAuB;QAA1D,aAAQ,GAAR,QAAQ,CAAQ;QAAmB,QAAG,GAAH,GAAG,CAAoB;QAJ/E,gBAAW,GAAuB,IAAI,CAAC;QACvC,iBAAY,GAAuB,IAAI,CAAC;QACxC,kBAAa,GAAuB,IAAI,CAAC;QAG/C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAY,CAAC;IAC3B,CAAC;IACD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAa,CAAC;IAC5B,CAAC;IACD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAc,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,GAAW,EAAE,OAAe;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAEO,WAAW;QACjB,2EAA2E;QAC3E,IAAI,CAAC,KAAK,CAAC,4BAA4B,EAAE;;;;;;;;;CAS5C,CAAC,CAAC;QAEC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,2CAA2C,EAAE;;;;CAI3D,CAAC,CAAC;QAEC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAAE;;;CAG1C,CAAC,CAAC;QAEC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCnD,CAAC,CAAC;QAEC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,2CAA2C,EAAE;;;;;;;;;;;;;;;;;;;;CAoB3D,CAAC,CAAC;QAEC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,qDAAqD,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBrE,CAAC,CAAC;IACD,CAAC;IAEO,WAAW;QACjB,MAAM,IAAI,GAAwB;YAChC,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC7B,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,UAAU;YACnC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE;YACnC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC3C,mBAAmB,EAAE,GAAG,EAAE,CAAC,SAAS;aACrC,CAAC,CAAC;QAEP,MAAM,OAAO,GAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mCAAmC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7G,MAAM,QAAQ,GAAK,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,2CAA2C,CAAC,EAAE,IAAI,CAAC,CAAC;QACrH,MAAM,SAAS,GAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qDAAqD,CAAC,EAAE,IAAI,CAAC,CAAC;QAE/H,MAAM,OAAO,GAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QACjG,MAAM,QAAQ,GAAK,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QACjG,MAAM,SAAS,GAAI,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QAEjG,IAAI,CAAC,WAAW,GAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxE,IAAI,CAAC,YAAY,GAAI,IAAI,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3E,IAAI,CAAC,aAAa,GAAG,IAAI,SAAS,CAAC,2BAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;CACF;AA5KD,oCA4KC"}

package/dist/types.d.ts

@@ -0,0 +1,192 @@
+export interface BlockNodeClientOptions {
+    /** gRPC endpoint, e.g. "s01.test.blk.ams.lat.ope.eng.hashgraph.io:40840" */
+    endpoint: string;
+    /**
+     * TLS mode.
+     *   "tls"      – TLS with self-signed cert tolerance (default)
+     *   "insecure" – plaintext (USE_INSECURE=1 equivalent)
+     */
+    tls?: "tls" | "insecure";
+    /** Timeout in ms for unary calls (serverStatus, getBlock). Default: 10000 */
+    timeout?: number;
+}
+export interface ServerStatusResponse {
+    firstAvailableBlock: bigint;
+    lastAvailableBlock: bigint;
+    nextExpectedBlock: bigint;
+    onlyLatestState: boolean;
+}
+export interface SemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+}
+export interface BlockRange {
+    rangeStart: bigint;
+    rangeEnd: bigint;
+}
+export interface PluginVersion {
+    pluginId: string;
+    pluginSoftwareVersion?: SemanticVersion;
+    pluginFeatureNames: string[];
+}
+export interface BlockNodeVersions {
+    streamProtoVersion?: SemanticVersion;
+    blockNodeVersion?: SemanticVersion;
+    installedPluginVersions: PluginVersion[];
+}
+export interface ServerStatusDetailResponse {
+    versionInformation?: BlockNodeVersions;
+    availableRanges: BlockRange[];
+    storedRanges: BlockRange[];
+    nodeAddressBook?: unknown;
+    tssData?: unknown;
+}
+export type BlockRequestSpecifier = {
+    blockNumber: bigint;
+} | {
+    retrieveLatest: true;
+};
+export declare enum BlockResponseCode {
+    UNKNOWN = 0,
+    SUCCESS = 1,
+    INVALID_REQUEST = 2,
+    ERROR = 3,
+    NOT_FOUND = 4,
+    NOT_AVAILABLE = 5
+}
+export interface AddressBookProof {
+    previousAddressBookHash: Buffer;
+    currentAddressBookHash: Buffer;
+    ledgerHash: Buffer;
+}
+/** A single decoded BlockItem from the stream or getBlock response */
+export interface BlockItem {
+    /** The discriminator name of the oneof field that was set */
+    kind: BlockItemKind;
+    /** Raw bytes of the inner message (before kind-specific decoding) */
+    raw: Buffer;
+    /** Decoded payload — shape depends on `kind` */
+    payload: BlockHeader | EventHeader | RoundHeader | EventTransaction | TransactionResult | StateChanges | FilteredItemHash | BlockProof | RecordFile | AddressBookProof | Record<string, unknown>;
+}
+export type BlockItemKind = "block_header" | "event_header" | "round_header" | "event_transaction" | "transaction_result" | "transaction_output" | "state_changes" | "filtered_item_hash" | "block_proof" | "record_file" | "address_book_proof" | "unknown";
+export interface BlockHeader {
+    number: bigint;
+    hapiProtoVersion?: SemanticVersion;
+    softwareVersion?: SemanticVersion;
+    previousBlockHash: Buffer;
+    firstTransactionConsensusTime?: Timestamp;
+    hashAlgorithm: number;
+}
+export interface EventHeader {
+    birthRound: bigint;
+    generation: bigint;
+    creatorNodeId: Buffer;
+}
+export interface RoundHeader {
+    roundNumber: bigint;
+}
+export interface TransactionId {
+    accountId?: AccountId;
+    transactionValidStart?: Timestamp;
+    scheduled: boolean;
+    nonce: number;
+    /** Canonical format: "0.0.X@seconds.nanos" */
+    toString(): string;
+}
+export interface AccountId {
+    shardNum: bigint;
+    realmNum: bigint;
+    accountNum: bigint;
+}
+export interface Timestamp {
+    seconds: bigint;
+    nanos: number;
+    toDate(): Date;
+}
+export interface EventTransaction {
+    kind: "application" | "system";
+    transactionId?: TransactionId;
+    type?: string;
+    memo?: string;
+    raw: Buffer;
+}
+export interface TransactionResult {
+    status: number;
+    statusName: string;
+    consensusTimestamp?: Timestamp;
+    transactionFee: bigint;
+    payerAccountId?: AccountId;
+    transactionHash: Buffer;
+    transfers: Transfer[];
+}
+export interface Transfer {
+    accountId?: AccountId;
+    amount: bigint;
+}
+export interface StateChange {
+    stateId: number;
+    stateName: string;
+}
+export interface StateChanges {
+    consensusTimestamp?: Timestamp;
+    changes: StateChange[];
+}
+export interface FilteredItemHash {
+    itemHash: Buffer;
+    filteredPath: bigint;
+}
+export interface BlockProof {
+    block: bigint;
+    previousBlockRootHash: Buffer;
+    startOfBlockStateRootHash: Buffer;
+    blockSignature: Buffer;
+    siblingHashes: Buffer[];
+}
+export interface RecordFile {
+    creationTime?: Timestamp;
+    number: bigint;
+    transactions: DecodedTransaction[];
+}
+export interface DecodedTransaction {
+    transactionId?: TransactionId;
+    type?: string;
+    memo?: string;
+}
+export interface GetBlockResponse {
+    status: BlockResponseCode;
+    statusName: string;
+    block?: BlockItem[];
+}
+export declare enum SubscribeStreamCode {
+    UNKNOWN = 0,
+    SUCCESS = 1,
+    INVALID_REQUEST = 2,
+    ERROR = 3,
+    INVALID_START_BLOCK_NUMBER = 4,
+    INVALID_END_BLOCK_NUMBER = 5,
+    NOT_AVAILABLE = 6
+}
+export interface BlockStreamOptions {
+    startBlockNumber: bigint | number;
+    /**
+     * End block. Omit or pass 0n for a live open-ended stream.
+     * The SDK automatically converts 0 to uint64_max for you.
+     */
+    endBlockNumber?: bigint | number;
+}
+export interface BlockStreamCallbacks {
+    /** Called once after the stream is opened — SUCCESS means items will follow */
+    onStatus?: (code: SubscribeStreamCode, name: string) => void;
+    /** Called once per complete block (after end_of_block is received) */
+    onBlock?: (blockNumber: bigint, items: BlockItem[]) => void;
+    /** Called on stream error */
+    onError?: (err: Error) => void;
+    /** Called when the stream ends (either bounded range finished or cancelled) */
+    onEnd?: () => void;
+}
+export interface StreamHandle {
+    /** Cancel the stream */
+    cancel(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,25 @@
+"use strict";
+// ─── Public types ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscribeStreamCode = exports.BlockResponseCode = void 0;
+var BlockResponseCode;
+(function (BlockResponseCode) {
+    BlockResponseCode[BlockResponseCode["UNKNOWN"] = 0] = "UNKNOWN";
+    BlockResponseCode[BlockResponseCode["SUCCESS"] = 1] = "SUCCESS";
+    BlockResponseCode[BlockResponseCode["INVALID_REQUEST"] = 2] = "INVALID_REQUEST";
+    BlockResponseCode[BlockResponseCode["ERROR"] = 3] = "ERROR";
+    BlockResponseCode[BlockResponseCode["NOT_FOUND"] = 4] = "NOT_FOUND";
+    BlockResponseCode[BlockResponseCode["NOT_AVAILABLE"] = 5] = "NOT_AVAILABLE";
+})(BlockResponseCode || (exports.BlockResponseCode = BlockResponseCode = {}));
+// ── Subscribe ─────────────────────────────────────────────────────────────────
+var SubscribeStreamCode;
+(function (SubscribeStreamCode) {
+    SubscribeStreamCode[SubscribeStreamCode["UNKNOWN"] = 0] = "UNKNOWN";
+    SubscribeStreamCode[SubscribeStreamCode["SUCCESS"] = 1] = "SUCCESS";
+    SubscribeStreamCode[SubscribeStreamCode["INVALID_REQUEST"] = 2] = "INVALID_REQUEST";
+    SubscribeStreamCode[SubscribeStreamCode["ERROR"] = 3] = "ERROR";
+    SubscribeStreamCode[SubscribeStreamCode["INVALID_START_BLOCK_NUMBER"] = 4] = "INVALID_START_BLOCK_NUMBER";
+    SubscribeStreamCode[SubscribeStreamCode["INVALID_END_BLOCK_NUMBER"] = 5] = "INVALID_END_BLOCK_NUMBER";
+    SubscribeStreamCode[SubscribeStreamCode["NOT_AVAILABLE"] = 6] = "NOT_AVAILABLE";
+})(SubscribeStreamCode || (exports.SubscribeStreamCode = SubscribeStreamCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AA+DjF,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,+DAAW,CAAA;IACX,+DAAW,CAAA;IACX,+EAAmB,CAAA;IACnB,2DAAS,CAAA;IACT,mEAAa,CAAA;IACb,2EAAiB,CAAA;AACnB,CAAC,EAPW,iBAAiB,iCAAjB,iBAAiB,QAO5B;AA0ID,iFAAiF;AAEjF,IAAY,mBAQX;AARD,WAAY,mBAAmB;IAC7B,mEAAW,CAAA;IACX,mEAAW,CAAA;IACX,mFAAmB,CAAA;IACnB,+DAAS,CAAA;IACT,yGAA8B,CAAA;IAC9B,qGAA4B,CAAA;IAC5B,+EAAiB,CAAA;AACnB,CAAC,EARW,mBAAmB,mCAAnB,mBAAmB,QAQ9B"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ohmpathorn/block-node-client",
+  "version": "0.1.0",
+  "description": "JavaScript SDK for the Hedera Block Node gRPC API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npx tsc",
+    "test": "node examples/basic.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hedera",
+    "hiero",
+    "block-node",
+    "grpc",
+    "blockchain"
+  ],
+  "author": "Hedera | Hiero",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@grpc/grpc-js": "^1.10.0",
+    "@grpc/proto-loader": "^0.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hiero-ledger/hiero-block-node-sdk.git"
+  }
+}