@zuhaibnoor/zigchain-sdk 1.1.1 → 1.1.2

package/dist/consensus/ChainConsensusApi.d.ts

@@ -1,4 +1,5 @@
 import type { NetworkEndpoints } from '../networks/endpoints.js';
+import type { NodeInfoResponse, SyncingResponse, ValidatorSetResponse } from './types.js';
 export declare class ChainConsensusApi {
     private client;
     constructor(endpoints: NetworkEndpoints);
@@ -8,5 +9,9 @@ export declare class ChainConsensusApi {
     fetchConsensusParams(options?: {
         height?: number;
     }): Promise<import("./types.js").ConsensusParams>;
+    fetchNodeInfo(): Promise<NodeInfoResponse>;
+    fetchSyncing(): Promise<SyncingResponse>;
+    fetchLatestValidatorSets(): Promise<ValidatorSetResponse>;
+    fetchValidatorSetAt(height: number | string): Promise<ValidatorSetResponse>;
 }
 //# sourceMappingURL=ChainConsensusApi.d.ts.map

package/dist/consensus/ChainConsensusApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainConsensusApi.d.ts","sourceRoot":"","sources":["../../src/consensus/ChainConsensusApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAGhE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAY;gBAEd,SAAS,EAAE,gBAAgB;IAIvC;;OAEG;IACG,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAazD"}
+{"version":3,"file":"ChainConsensusApi.d.ts","sourceRoot":"","sources":["../../src/consensus/ChainConsensusApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EAEpB,MAAM,YAAY,CAAA;AAEpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAY;gBAEd,SAAS,EAAE,gBAAgB;IAIvC;;OAEG;IACG,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAclD,aAAa;IAKb,YAAY;IAKZ,wBAAwB;IAKxB,mBAAmB,CAAC,MAAM,EAAG,MAAM,GAAG,MAAM;CAKnD"}

package/dist/consensus/ChainConsensusApi.js

@@ -14,5 +14,21 @@ export class ChainConsensusApi {
         const data = await this.client.get('/cosmos/consensus/v1/params', headers);
         return data.params;
     }
+    async fetchNodeInfo() {
+        const node_info = await this.client.get(`/cosmos/base/tendermint/v1beta1/node_info`);
+        return node_info;
+    }
+    async fetchSyncing() {
+        const syncing = await this.client.get(`/cosmos/base/tendermint/v1beta1/syncing`);
+        return syncing;
+    }
+    async fetchLatestValidatorSets() {
+        const validators = await this.client.get(`/cosmos/base/tendermint/v1beta1/validatorsets/latest`);
+        return validators;
+    }
+    async fetchValidatorSetAt(height) {
+        const validators = await this.client.get(`/cosmos/base/tendermint/v1beta1/validatorsets/${height}`);
+        return validators;
+    }
 }
 //# sourceMappingURL=ChainConsensusApi.js.map

package/dist/consensus/ChainConsensusApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChainConsensusApi.js","sourceRoot":"","sources":["../../src/consensus/ChainConsensusApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAI9C,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAY;IAE1B,YAAY,SAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAA6B;QACtD,MAAM,OAAO,GACX,OAAO,EAAE,MAAM,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACrD,CAAC,CAAC,SAAS,CAAA;QAEf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAChC,6BAA6B,EAC7B,OAAO,CACR,CAAA;QAED,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF"}
+{"version":3,"file":"ChainConsensusApi.js","sourceRoot":"","sources":["../../src/consensus/ChainConsensusApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAU9C,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAY;IAE1B,YAAY,SAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAA6B;QACtD,MAAM,OAAO,GACX,OAAO,EAAE,MAAM,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACrD,CAAC,CAAC,SAAS,CAAA;QAEf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAChC,6BAA6B,EAC7B,OAAO,CACR,CAAA;QAED,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAmB,2CAA2C,CAAC,CAAA;QACtG,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAkB,yCAAyC,CAAC,CAAA;QACjG,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,MAAM,UAAU,GAAG,MAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAuB,sDAAsD,CAAC,CAAA;QACvH,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAAwB;QAChD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAuB,iDAAiD,MAAM,EAAE,CAAC,CAAA;QACzH,OAAO,UAAU,CAAA;IACnB,CAAC;CAEF"}

package/dist/consensus/types.d.ts

@@ -15,4 +15,59 @@ export interface ConsensusParams {
         pub_key_types: string[];
     };
 }
+export interface NodeInfoResponse {
+    application_version: {
+        app_name: string;
+        build_deps: [
+            {
+                path: string;
+                sum: string;
+                version: string;
+            }
+        ];
+        build_tags: string;
+        cosmos_sdk_version: string;
+        git_commit: string;
+        go_version: string;
+        name: string;
+        version: string;
+    };
+    default_node_info: {
+        channels: string;
+        default_node_id: string;
+        listen_addr: string;
+        moniker: string;
+        network: string;
+        other: {
+            rpc_address: string;
+            tx_index: string;
+        };
+        protocol_version: {
+            app: string;
+            block: string;
+            p2p: string;
+        };
+        version: string;
+    };
+}
+export interface SyncingResponse {
+    syncing: boolean;
+}
+export interface ValidatorSetResponse {
+    block_height: string;
+    pagination: {
+        next_key: string;
+        total: string;
+    };
+    validators: [
+        {
+            address: string;
+            proposer_priority: string;
+            pub_key: {
+                '@type': string;
+            };
+            voting_power: string;
+        }
+    ];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/consensus/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/consensus/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,MAAM,CAAA;QAC1B,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,SAAS,EAAE;QACT,aAAa,EAAE,MAAM,EAAE,CAAA;KACxB,CAAA;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/consensus/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,MAAM,CAAA;QAC1B,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,SAAS,EAAE;QACT,aAAa,EAAE,MAAM,EAAE,CAAA;KACxB,CAAA;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,MAAM,CAAC;gBACb,GAAG,EAAE,MAAM,CAAC;gBACZ,OAAO,EAAE,MAAM,CAAA;aAChB;SACF,CAAC;QACF,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC;IACF,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE;YACL,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAC;QACF,gBAAgB,EAAE;YAChB,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAA;SACZ,CAAC;QACF,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAA;KACd,CAAC;IACF,UAAU,EAAE;QACV;YACE,OAAO,EAAE,MAAM,CAAC;YAChB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,OAAO,EAAE;gBACP,OAAO,EAAE,MAAM,CAAA;aAChB,CAAC;YACF,YAAY,EAAE,MAAM,CAAA;SACrB;KACF,CAAA;CACF"}

package/docs/consensus.md

@@ -0,0 +1,600 @@
+# Consensus Module
+
+## What is the Consensus Module?
+
+The **Consensus module** allows you to query information about the blockchain's consensus mechanism and current validator set.
+
+---
+
+# Important Terminology
+
+Before documenting functions, let's define key terms.
+
+### Consensus Parameters
+
+**Consensus Parameters** are the rules that govern how blocks are created and validated on the blockchain.
+
+They include:
+* Maximum block size
+* Maximum gas per block
+* Evidence handling rules
+* Validator public key types
+
+---
+
+### Validator Set
+
+The **Validator Set** is the current list of validators responsible for creating blocks and reaching consensus.
+
+Each validator has:
+* **Address** – Consensus address (validator operator)
+* **Public Key** – Key for signing blocks
+* **Voting Power** – Stake-weighted power in consensus
+* **Proposer Priority** – Used to rotate block proposers
+
+---
+
+### Voting Power
+
+**Voting Power** represents a validator's influence in reaching consensus.
+
+Usually proportional to the validator's stake. Higher voting power means more influence on which blocks are canonical.
+
+---
+
+### Node Info
+
+**Node Info** contains metadata about a node, including:
+* Node ID
+* Network name
+* Application version
+* Build information
+
+---
+
+### Syncing Status
+
+The **Syncing Status** indicates whether a node is catching up to the latest blocks.
+
+* `true` – Node is syncing (behind)
+* `false` – Node is caught up to the latest height
+
+---
+
+# Functions Documentation
+
+Setup:
+```ts
+import {
+  ChainConsensusApi,
+  getNetworkEndpoints,
+  Network
+} from '@zuhaibnoor/zigchain-sdk'
+
+const endpoints = getNetworkEndpoints(Network.Testnet)
+const consensusApi = new ChainConsensusApi(endpoints)
+```
+
+---
+
+# 1️⃣ fetchConsensusParams
+
+## Method
+
+```ts
+async fetchConsensusParams(options?: { height?: number })
+```
+
+## CLI Equivalent
+
+```bash
+zigchaind query consensus params
+```
+
+## Description
+
+Fetches the **consensus parameters** that govern block production and validation.
+
+Returns the current consensus rules including block size limits, gas limits, and evidence parameters.
+
+Optionally query parameters at a specific historical height.
+
+## Parameters
+
+| Name       | Type                    | Description                         |
+| ---------- | ----------------------- | ----------------------------------- |
+| options    | object (optional)       | Optional query options              |
+| height     | number (optional)       | Block height for historical query   |
+
+## Usage Example
+
+### Current Consensus Parameters
+
+```ts
+const params = await consensusApi.fetchConsensusParams()
+console.dir(params, { depth: null })
+```
+
+### Parameters at Specific Height
+
+```ts
+const paramsAtHeight = await consensusApi.fetchConsensusParams({
+  height: 4141776
+})
+console.dir(paramsAtHeight, { depth: null })
+```
+
+## Example Response
+
+```json
+{
+  "block": {
+    "max_bytes": "5000000",
+    "max_gas": "100000000"
+  },
+  "evidence": {
+    "max_age_num_blocks": "100000",
+    "max_age_duration": "172800s",
+    "max_bytes": "1048576"
+  },
+  "validator": {
+    "pub_key_types": ["ed25519"]
+  },
+  "version": {
+    "app": "0"
+  },
+  "abci": {
+    "vote_extensions_enable_height": "0"
+  }
+}
+```
+
+## Response Field Explanation
+
+### `block`
+
+Block production parameters.
+
+| Field    | Description                  |
+| -------- | ---------------------------- |
+| max_bytes | Maximum block size in bytes  |
+| max_gas  | Maximum gas per block        |
+
+### `evidence`
+
+Parameters for handling misbehavior evidence.
+
+| Field              | Description                            |
+| ------------------ | -------------------------------------- |
+| max_age_num_blocks | Max age of evidence in blocks          |
+| max_age_duration   | Max age of evidence in time duration   |
+| max_bytes          | Max evidence bytes per block           |
+
+### `validator`
+
+Validator configuration.
+
+| Field        | Description                   |
+| ------------ | ----------------------------- |
+| pub_key_types | Allowed public key types     |
+
+In this example, only Ed25519 keys are allowed.
+
+### `version`
+
+Version parameters.
+
+| Field | Description              |
+| ----- | ------------------------ |
+| app   | Application version      |
+
+### `abci`
+
+ABCI (Application Blockchain Interface) parameters.
+
+| Field                      | Description                    |
+| -------------------------- | ------------------------------ |
+| vote_extensions_enable_height | Height at which vote extensions enabled |
+
+## Time Format
+
+All time durations are in seconds with `s` suffix.
+
+Example: `172800s` = 172800 seconds = 2 days
+
+Convert to seconds: Remove the `s` and parse as number.
+
+## When to Use
+
+* Verifying consensus rules
+* Understanding block constraints
+* Monitoring governance parameter changes
+* Building chain status dashboards
+* Comparing parameters across networks
+
+---
+
+# 2️⃣ fetchNodeInfo
+
+## Method
+
+```ts
+async fetchNodeInfo()
+```
+
+## CLI Equivalent
+
+```bash
+zigchaind query consensus node-info
+```
+
+## Description
+
+Fetches **information about the node** including software versions and configuration.
+
+Returns:
+* Node ID and network details
+* Application version and git commit
+* Dependencies and build information
+
+## Parameters
+
+None.
+
+## Usage Example
+
+```ts
+const nodeInfo = await consensusApi.fetchNodeInfo()
+console.dir(nodeInfo, { depth: null })
+```
+
+## Example Response
+
+```json
+{
+  "default_node_info": {
+    "protocol_version": {
+      "p2p": "8",
+      "block": "11",
+      "app": "0"
+    },
+    "default_node_id": "fafae5272113e3ff754b796e01790051526d1526",
+    "listen_addr": "0.0.0.0:26684",
+    "network": "zig-test-2",
+    "version": "0.38.19",
+    "channels": "QCAhIiMwOGBhAA==",
+    "moniker": "node-1",
+    "other": {
+      "tx_index": "on",
+      "rpc_address": "tcp://0.0.0.0:26657"
+    }
+  },
+  "application_version": {
+    "name": "zigchain",
+    "app_name": "zigchaind",
+    "version": "v3.0.0",
+    "git_commit": "d6bdf03a01b32c0fd16ac5564a48e9ab0e03c0c4",
+    "build_tags": "muslc,ledger",
+    "go_version": "go version go1.25.5 linux/amd64",
+    "cosmos_sdk_version": "v0.53.4",
+    "build_deps": [...]
+  }
+}
+```
+
+## Response Field Explanation
+
+### `default_node_info`
+
+Network and node configuration.
+
+| Field              | Description                            |
+| ------------------ | -------------------------------------- |
+| protocol_version   | P2P, block, and app protocol versions |
+| default_node_id    | Unique node identifier                 |
+| listen_addr        | P2P listen address                     |
+| network            | Network name (e.g., `zig-test-2`)     |
+| version            | Tendermint version                     |
+| moniker            | Node name/identifier                   |
+| other              | Additional configuration               |
+
+### `protocol_version`
+
+Protocol versions for different layers.
+
+| Field | Description                       |
+| ----- | --------------------------------- |
+| p2p   | Peer-to-peer protocol version    |
+| block | Block protocol version            |
+| app   | Application protocol version      |
+
+### `application_version`
+
+Application software information.
+
+| Field                  | Description                          |
+| ---------------------- | ------------------------------------ |
+| name                   | Application name                    |
+| app_name               | Binary name (e.g., `zigchaind`)    |
+| version                | Application version (e.g., `v3.0.0`) |
+| git_commit             | Git commit hash of build            |
+| build_tags             | Build tags/features enabled         |
+| go_version             | Go compiler version                 |
+| cosmos_sdk_version     | Cosmos SDK version                  |
+| build_deps             | Array of build dependencies         |
+
+### `other`
+
+Additional node configuration.
+
+| Field       | Description              |
+| ----------- | ------------------------ |
+| tx_index    | Transaction indexing enabled |
+| rpc_address | RPC endpoint address     |
+
+## When to Use
+
+* Identifying node software versions
+* Checking node configuration
+* Verifying network name
+* Building node status dashboards
+* Monitoring software compatibility
+
+---
+
+# 3️⃣ fetchSyncing
+
+## Method
+
+```ts
+async fetchSyncing()
+```
+
+## CLI Equivalent
+
+```bash
+zigchaind query consensus syncing
+```
+
+## Description
+
+Checks if the **node is currently synchronizing** with the blockchain.
+
+Returns:
+* `true` – Node is behind and catching up
+* `false` – Node is caught up to latest height
+
+## Parameters
+
+None.
+
+## Usage Example
+
+```ts
+const syncStatus = await consensusApi.fetchSyncing()
+console.dir(syncStatus, { depth: null })
+```
+
+## Example Response
+
+### Node Caught Up
+
+```json
+{
+  "syncing": false
+}
+```
+
+### Node Syncing
+
+```json
+{
+  "syncing": true
+}
+```
+
+## Response Field Explanation
+
+| Field   | Description           |
+| ------- | --------------------- |
+| syncing | Synchronization status |
+
+## When to Use
+
+* Health checks for nodes
+* Determining if node is ready for queries
+* Monitoring node participation
+* Building node dashboards
+* Waiting for nodes to catch up
+
+---
+
+# 4️⃣ fetchLatestValidatorSets
+
+## Method
+
+```ts
+async fetchLatestValidatorSets()
+```
+
+## CLI Equivalent
+
+```bash
+zigchaind query consensus latest-validator-sets
+```
+
+## Description
+
+Fetches the **current active validator set**.
+
+Returns all validators currently participating in consensus with their voting power and keys.
+
+## Parameters
+
+None.
+
+## Usage Example
+
+```ts
+const validators = await consensusApi.fetchLatestValidatorSets()
+console.dir(validators, { depth: null })
+```
+
+## Example Response
+
+```json
+{
+  "block_height": "4649701",
+  "validators": [
+    {
+      "address": "zigvalcons15hcvyh2h0rrzrsswzu67s83z2v462rantszqnx",
+      "pub_key": {
+        "@type": "/cosmos.crypto.ed25519.PubKey",
+        "key": "f+akljJ8Y0dKwWz3bKkRN+RDz9EM+yA/j7Gre+Hn02c="
+      },
+      "voting_power": "25350159",
+      "proposer_priority": "13937913"
+    },
+    {
+      "address": "zigvalcons13atuu9t8ryjaq6a5a3twjc2nudh7l6uemvgmes",
+      "pub_key": {
+        "@type": "/cosmos.crypto.ed25519.PubKey",
+        "key": "SBjHwAbgG2ZfZtbBMJgcr+z+S/2BuPQZROVLnvS4QHM="
+      },
+      "voting_power": "25227820",
+      "proposer_priority": "-16758936"
+    }
+  ],
+  "pagination": {
+    "next_key": null,
+    "total": "8"
+  }
+}
+```
+
+## Response Field Explanation
+
+### `block_height`
+
+The block height at which this validator set is active.
+
+### `validators`
+
+Array of active validators.
+
+Each validator contains:
+
+| Field             | Description                        |
+| ----------------- | ---------------------------------- |
+| address           | Validator consensus address        |
+| pub_key           | Public key for signing blocks      |
+| voting_power      | Stake-weighted power in consensus |
+| proposer_priority | Priority for block proposal rotation |
+
+### `pub_key`
+
+The validator's public key for cryptographic operations.
+
+| Field | Description                    |
+| ----- | ------------------------------ |
+| @type | Key type (`/cosmos.crypto.ed25519.PubKey`) |
+| key   | Base64-encoded public key bytes |
+
+### `voting_power`
+
+The validator's influence in consensus, typically proportional to stake.
+
+Higher values = more influence = more blocks proposed.
+
+### `proposer_priority`
+
+Score used to fairly rotate block proposals among validators.
+
+Increases when a validator proposes, decreases as others propose.
+
+
+## When to Use
+
+* Monitoring active validator set
+* Building explorer dashboards
+* Validator set health monitoring
+
+---
+
+# 5️⃣ fetchValidatorSetAt
+
+## Method
+
+```ts
+async fetchValidatorSetAt(height: number | string)
+```
+
+## CLI Equivalent
+
+```bash
+zigchaind query consensus validator-set <height>
+```
+
+## Description
+
+Fetches the **validator set at a specific historical height**.
+
+Allows you to see which validators were active at any point in the blockchain's history.
+
+## Parameters
+
+| Name   | Type              | Description           |
+| ------ | ----------------- | --------------------- |
+| height | number \| string  | Block height to query |
+
+## Usage Example
+
+```ts
+const validatorsAtHeight = await consensusApi.fetchValidatorSetAt(4141776)
+console.dir(validatorsAtHeight, { depth: null })
+```
+
+## Example Response
+
+```json
+{
+  "block_height": "4141776",
+  "validators": [
+    {
+      "address": "zigvalcons15hcvyh2h0rrzrsswzu67s83z2v462rantszqnx",
+      "pub_key": {
+        "@type": "/cosmos.crypto.ed25519.PubKey",
+        "key": "f+akljJ8Y0dKwWz3bKkRN+RDz9EM+yA/j7Gre+Hn02c="
+      },
+      "voting_power": "25346024",
+      "proposer_priority": "65554751"
+    },
+    {
+      "address": "zigvalcons13atuu9t8ryjaq6a5a3twjc2nudh7l6uemvgmes",
+      "pub_key": {
+        "@type": "/cosmos.crypto.ed25519.PubKey",
+        "key": "SBjHwAbgG2ZfZtbBMJgcr+z+S/2BuPQZROVLnvS4QHM="
+      },
+      "voting_power": "25227954",
+      "proposer_priority": "-2728799"
+    }
+  ],
+  "pagination": {
+    "next_key": null,
+    "total": "7"
+  }
+}
+```
+
+## Response Field Explanation
+
+Same as `fetchLatestValidatorSets()` response.
+
+The `block_height` field will reflect the queried height, and validator data will be the set at that historical point.
+
+## When to Use
+
+* Analyzing historical validator changes
+* Investigating validator set transitions
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuhaibnoor/zigchain-sdk",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",