@firmachain/firma-js 0.3.1 → 0.3.3

package/README.md

@@ -5,20 +5,33 @@
 [![license](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/firmachain/firma-js/blob/master/LICENSE)
 [![](https://tokei.rs/b1/github/XAMPPRocky/tokei)](https://github.com/FirmaChain/firma-js)
 
-The Javascript & TypeScript SDK for FirmaChain
+**The Official JavaScript & TypeScript SDK for FirmaChain**
 
-Firma-js is a SDK for writing applications based on javascript & typescript. You can use it client web app or Node.js. This SDK is created inspired by cosmjs and several sdk. All functions of the FirmaChain can be accessed at the service level.
+Firma-js is a comprehensive SDK for building applications on the FirmaChain blockchain using JavaScript and TypeScript. Whether you're developing client-side web applications or server-side Node.js applications, this SDK provides seamless integration with FirmaChain's full suite of blockchain capabilities.
 
-## Features
- Most cosmos sdk features are supported
-- Wallet / Bank
-- Nft / Contract
-- Ipfs / Gov
-- Staking / Distribution
-- Feegrant ...and so one
+Built with inspiration from CosmJS and other leading Cosmos SDK implementations, firma-js offers a service-oriented architecture that provides direct access to all FirmaChain functionality while maintaining type safety and developer experience.
 
-</br>
+## Features
 
+**Core FirmaChain Integration**
+- **Wallet Management**: Create, import, and manage wallets with mnemonic and private key support
+- **Banking Operations**: Send, receive, and query FCT with full transaction control
+- **Staking & Delegation**: Stake tokens, delegate to validators, and manage rewards
+- **Authorization**: Grant and revoke permissions for account delegation
+- **Fee Grant**: Grant and revoke fee allowances for gasless transactions
+- **Governance**: Create proposals, vote, and query governance parameters
+
+**FirmaChain Ecosystem**
+- **Smart Contracts**: Deploy, execute, and query CosmWasm smart contracts with full parameter control
+- **IBC Operations**: Cross-chain transfers and communication protocols
+- **IPFS Integration**: Upload, pin, and retrieve files from IPFS with built-in gateway support
+- **NFT Operations**: Mint, transfer, burn, and query built-in NFTs with comprehensive metadata support
+
+**Developer Experience**
+- **TypeScript Support**: Full type definitions for enhanced IDE support and compile-time safety
+- **Modular Architecture**: Use only the modules you need for optimal bundle size
+- **Comprehensive Documentation**: Extensive examples and API documentation
+- **CosmJS Compatible**: Familiar patterns for developers experienced with Cosmos SDK
 
 ## Install
 You can install `firma-js` using [NPM](https://www.npmjs.com/package/@firmachain/firma-js)
@@ -30,6 +43,23 @@ or
 npm i @firmachain/firma-js
 ```
 
+## Conventions
+
+### Implementation Guidelines
+- **Data Structure Consistency**: We recommend preserving the original data structure from FirmaChain RPCs throughout your application and only processing/transforming the data immediately before transaction generation. This convention is also applied to `firma-js` itself.
+- **Chain Data Integrity**: This approach ensures consistency in chain data retrieval logic and maintains compatibility with upstream changes
+- **Transaction Processing**: All data transformations should occur at the transaction boundary to minimize potential inconsistencies
+
+### Governance Parameters
+- **Parameter Validation**: For governance proposals requiring multiple parameters, we perform dual validation by comparing submitted parameters against `fromPartial`-processed parameters to ensure identical values
+- **Validation Failure Handling**: If any discrepancy is detected between the original and processed parameters, the transaction will automatically revert to prevent malformed proposals
+- **Best Practice**: To ensure successful governance proposal submissions, use the provided helper functions:
+  - `getParamAsGovParams()` - Retrieve current governance parameters
+  - `getParamsAsStakingParams()` - Retrieve current staking parameters
+  
+  Modify only the specific fields you need to change while preserving all other existing parameter values 
+
+
 ## Usage
 ### Initializing SDK
 ```js
@@ -138,6 +168,10 @@ const tokenId = 1;
 let result = await firma.Nft.burn(wallet, tokenId);
 ```
 
-You can see everything usage of firma-js on the test folder.
-</br>
-https://github.com/FirmaChain/firma-js/tree/main/test
+## Complete Examples
+
+For comprehensive usage examples and test cases, please refer to the test suite:
+
+🔗 **[View Complete Examples](https://github.com/FirmaChain/firma-js/tree/main/test)**
+
+The test folder contains detailed examples for all SDK features including wallet management, token operations, NFT handling, smart contracts, governance, staking, and more.

package/dist/sdk/FirmaGovService.d.ts

@@ -1,11 +1,11 @@
-import { TxMisc, VotingOption, ProposalInfo, ProposalStatus, ProposalParam, CurrentVoteInfo } from "./firmachain/gov";
+import { TxMisc, VotingOption, ProposalStatus, CurrentVoteInfo, GovParamType } from "./firmachain/gov";
+import { DeliverTxResponse } from "./firmachain/common/stargateclient";
 import { FirmaWalletService } from "./FirmaWalletService";
 import { FirmaConfig } from "./FirmaConfig";
-import { DeliverTxResponse } from "./firmachain/common/stargateclient";
 import { Plan } from "cosmjs-types/cosmos/upgrade/v1beta1/upgrade";
 import { Coin } from "cosmjs-types/cosmos/base/v1beta1/coin";
-import { Params as StakingParams } from "cosmjs-types/cosmos/staking/v1beta1/staking";
-import { Params as GovParams } from "cosmjs-types/cosmos/gov/v1/gov";
+import { Proposal, Params as GovParams } from "@kintsugi-tech/cosmjs-types/cosmos/gov/v1/gov";
+import { Params as StakingParams } from "@kintsugi-tech/cosmjs-types/cosmos/staking/v1beta1/staking";
 export declare class FirmaGovService {
     private readonly config;
     static readonly GOV_AUTHORITY = "firma10d07y265gmmuvt4z0w9aw880jnsr700j53mj8f";
@@ -39,8 +39,9 @@ export declare class FirmaGovService {
     private getSignedTxDeposit;
     deposit(wallet: FirmaWalletService, proposalId: number, amount: number, txMisc?: TxMisc): Promise<DeliverTxResponse>;
     getCurrentVoteInfo(id: string): Promise<CurrentVoteInfo>;
-    getParam(): Promise<ProposalParam>;
-    getProposal(id: string): Promise<ProposalInfo>;
-    getProposalListByStatus(status: ProposalStatus): Promise<ProposalInfo[]>;
-    getProposalList(): Promise<ProposalInfo[]>;
+    getParam(): Promise<GovParamType>;
+    getParamAsGovParams(): Promise<GovParams>;
+    getProposal(id: string): Promise<Proposal>;
+    getProposalListByStatus(status: ProposalStatus): Promise<Proposal[]>;
+    getProposalList(): Promise<Proposal[]>;
 }

package/dist/sdk/FirmaGovService.js

@@ -35,17 +35,21 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FirmaGovService = void 0;
 var gov_1 = require("./firmachain/gov");
-var FirmaUtil_1 = require("./FirmaUtil");
 var any_1 = require("./firmachain/google/protobuf/any");
+var FirmaUtil_1 = require("./FirmaUtil");
 var gov_2 = require("cosmjs-types/cosmos/gov/v1beta1/gov");
-var tx_1 = require("@kintsugi-tech/cosmjs-types/cosmos/gov/v1/tx");
-var tx_2 = require("@kintsugi-tech/cosmjs-types/cosmos/upgrade/v1beta1/tx");
-var tx_3 = require("@kintsugi-tech/cosmjs-types/cosmos/distribution/v1beta1/tx");
-var tx_4 = require("cosmjs-types/cosmos/staking/v1beta1/tx");
-var tx_5 = require("cosmjs-types/cosmos/gov/v1/tx");
+var tx_1 = require("cosmjs-types/cosmos/staking/v1beta1/tx");
+var fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
+// temporarly using kintsugi-tech/cosmjs-types - this will be returned to original cosmjs-types after the PR is merged
+var tx_2 = require("@kintsugi-tech/cosmjs-types/cosmos/gov/v1/tx");
+var tx_3 = require("@kintsugi-tech/cosmjs-types/cosmos/upgrade/v1beta1/tx");
+var tx_4 = require("@kintsugi-tech/cosmjs-types/cosmos/distribution/v1beta1/tx");
 var FirmaGovService = /** @class */ (function () {
     function FirmaGovService(config) {
         this.config = config;
@@ -107,7 +111,7 @@ var FirmaGovService = /** @class */ (function () {
                         _a.trys.push([0, 3, , 4]);
                         message = {
                             typeUrl: "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
-                            value: tx_2.MsgSoftwareUpgrade.encode(tx_2.MsgSoftwareUpgrade.fromPartial({
+                            value: tx_3.MsgSoftwareUpgrade.encode(tx_3.MsgSoftwareUpgrade.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 plan: plan
                             })).finish()
@@ -130,14 +134,25 @@ var FirmaGovService = /** @class */ (function () {
         if (metadata === void 0) { metadata = ""; }
         if (txMisc === void 0) { txMisc = FirmaUtil_1.DefaultTxMisc; }
         return __awaiter(this, void 0, void 0, function () {
-            var message, txRaw, error_4;
+            var requestedParams, fromPartialParams, message, txRaw, error_4;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 3, , 4]);
+                        requestedParams = {
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        };
+                        fromPartialParams = tx_1.MsgUpdateParams.fromPartial({
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        });
+                        if (!fast_deep_equal_1.default(requestedParams.params, fromPartialParams.params)) {
+                            throw new Error("All staking parameters must be provided. Use Staking.getParamsAsStakingParams() to get current values and override only the parameters you want to change.");
+                        }
                         message = {
                             typeUrl: "/cosmos.staking.v1beta1.MsgUpdateParams",
-                            value: tx_4.MsgUpdateParams.encode(tx_4.MsgUpdateParams.fromPartial({
+                            value: tx_1.MsgUpdateParams.encode(tx_1.MsgUpdateParams.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 params: params
                             })).finish()
@@ -160,19 +175,30 @@ var FirmaGovService = /** @class */ (function () {
         if (metadata === void 0) { metadata = ""; }
         if (txMisc === void 0) { txMisc = FirmaUtil_1.DefaultTxMisc; }
         return __awaiter(this, void 0, void 0, function () {
-            var message, txRaw, error_5;
+            var requestedParams, fromPartialParams, message, txRaw, error_5;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 3, , 4]);
+                        requestedParams = {
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        };
+                        fromPartialParams = tx_2.MsgUpdateParams.fromPartial({
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        });
+                        if (!fast_deep_equal_1.default(requestedParams.params, fromPartialParams.params)) {
+                            throw new Error("All governance parameters must be provided. Use getParamAsGovParams() to get current values and override only the parameters you want to change.");
+                        }
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgUpdateParams",
-                            value: tx_5.MsgUpdateParams.encode(tx_5.MsgUpdateParams.fromPartial({
+                            value: tx_2.MsgUpdateParams.encode(tx_2.MsgUpdateParams.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 params: params
                             })).finish()
                         };
-                        return [4 /*yield*/, this.getSignedTxSubmitStakingParamsUpdateProposal(wallet, title, summary, initialDepositFCT, [message], metadata, txMisc)];
+                        return [4 /*yield*/, this.getSignedTxSubmitGovParamsUpdateProposal(wallet, title, summary, initialDepositFCT, [message], metadata, txMisc)];
                     case 1:
                         txRaw = _a.sent();
                         return [4 /*yield*/, FirmaUtil_1.FirmaUtil.estimateGas(txRaw)];
@@ -197,7 +223,7 @@ var FirmaGovService = /** @class */ (function () {
                         amount = FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(amountFCT);
                         message = {
                             typeUrl: "/cosmos.distribution.v1beta1.MsgCommunityPoolSpend",
-                            value: Uint8Array.from(tx_3.MsgCommunityPoolSpend.encode(tx_3.MsgCommunityPoolSpend.fromPartial({
+                            value: Uint8Array.from(tx_4.MsgCommunityPoolSpend.encode(tx_4.MsgCommunityPoolSpend.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 recipient: recipient,
                                 amount: [{
@@ -312,7 +338,7 @@ var FirmaGovService = /** @class */ (function () {
                         initialDeposit = [{ amount: FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(initialDepositFCT), denom: this.config.denom }];
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgSubmitProposal",
-                            value: tx_1.MsgSubmitProposal.fromPartial({
+                            value: tx_2.MsgSubmitProposal.fromPartial({
                                 title: title,
                                 summary: summary,
                                 metadata: metadata,
@@ -348,7 +374,7 @@ var FirmaGovService = /** @class */ (function () {
                         initialDeposit = [{ amount: FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(initialDepositFCT), denom: this.config.denom }];
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgSubmitProposal",
-                            value: tx_1.MsgSubmitProposal.fromPartial({
+                            value: tx_2.MsgSubmitProposal.fromPartial({
                                 title: title,
                                 summary: summary,
                                 metadata: metadata,
@@ -384,7 +410,7 @@ var FirmaGovService = /** @class */ (function () {
                         initialDeposit = [{ amount: FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(initialDepositFCT), denom: this.config.denom }];
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgSubmitProposal",
-                            value: tx_1.MsgSubmitProposal.fromPartial({
+                            value: tx_2.MsgSubmitProposal.fromPartial({
                                 title: title,
                                 summary: summary,
                                 metadata: metadata,
@@ -420,7 +446,7 @@ var FirmaGovService = /** @class */ (function () {
                         initialDeposit = [{ amount: FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(initialDepositFCT), denom: this.config.denom }];
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgSubmitProposal",
-                            value: tx_1.MsgSubmitProposal.fromPartial({
+                            value: tx_2.MsgSubmitProposal.fromPartial({
                                 title: title,
                                 summary: summary,
                                 metadata: metadata,
@@ -452,7 +478,7 @@ var FirmaGovService = /** @class */ (function () {
                         proposer = _a.sent();
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgCancelProposal",
-                            value: tx_1.MsgCancelProposal.fromPartial({
+                            value: tx_2.MsgCancelProposal.fromPartial({
                                 proposalId: BigInt(proposalId),
                                 proposer: proposer
                             })
@@ -475,7 +501,7 @@ var FirmaGovService = /** @class */ (function () {
                         _a.trys.push([0, 3, , 4]);
                         message = {
                             typeUrl: "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
-                            value: tx_2.MsgSoftwareUpgrade.encode(tx_2.MsgSoftwareUpgrade.fromPartial({
+                            value: tx_3.MsgSoftwareUpgrade.encode(tx_3.MsgSoftwareUpgrade.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 plan: plan
                             })).finish()
@@ -499,14 +525,25 @@ var FirmaGovService = /** @class */ (function () {
         if (metadata === void 0) { metadata = ""; }
         if (txMisc === void 0) { txMisc = FirmaUtil_1.DefaultTxMisc; }
         return __awaiter(this, void 0, void 0, function () {
-            var message, txRaw, txClient, error_15;
+            var requestedParams, fromPartialParams, message, txRaw, txClient, error_15;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 3, , 4]);
+                        requestedParams = {
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        };
+                        fromPartialParams = tx_1.MsgUpdateParams.fromPartial({
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        });
+                        if (!fast_deep_equal_1.default(requestedParams.params, fromPartialParams.params)) {
+                            throw new Error("All staking parameters must be provided. Use Staking.getParamsAsStakingParams() to get current values and override only the parameters you want to change.");
+                        }
                         message = {
                             typeUrl: "/cosmos.staking.v1beta1.MsgUpdateParams",
-                            value: tx_4.MsgUpdateParams.encode(tx_4.MsgUpdateParams.fromPartial({
+                            value: tx_1.MsgUpdateParams.encode(tx_1.MsgUpdateParams.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 params: params
                             })).finish()
@@ -530,14 +567,25 @@ var FirmaGovService = /** @class */ (function () {
         if (metadata === void 0) { metadata = ""; }
         if (txmisc === void 0) { txmisc = FirmaUtil_1.DefaultTxMisc; }
         return __awaiter(this, void 0, void 0, function () {
-            var message, txRaw, txClient, error_16;
+            var requestedParams, fromPartialParams, message, txRaw, txClient, error_16;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 3, , 4]);
+                        requestedParams = {
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        };
+                        fromPartialParams = tx_2.MsgUpdateParams.fromPartial({
+                            authority: FirmaGovService.GOV_AUTHORITY,
+                            params: params
+                        });
+                        if (!fast_deep_equal_1.default(requestedParams.params, fromPartialParams.params)) {
+                            throw new Error("All governance parameters must be provided. Use getParamAsGovParams() to get current values and override only the parameters you want to change.");
+                        }
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgUpdateParams",
-                            value: tx_5.MsgUpdateParams.encode(tx_5.MsgUpdateParams.fromPartial({
+                            value: tx_2.MsgUpdateParams.encode(tx_2.MsgUpdateParams.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 params: params
                             })).finish()
@@ -569,7 +617,7 @@ var FirmaGovService = /** @class */ (function () {
                         amount = FirmaUtil_1.FirmaUtil.getUFCTStringFromFCT(amountFCT);
                         message = {
                             typeUrl: "/cosmos.distribution.v1beta1.MsgCommunityPoolSpend",
-                            value: Uint8Array.from(tx_3.MsgCommunityPoolSpend.encode(tx_3.MsgCommunityPoolSpend.fromPartial({
+                            value: Uint8Array.from(tx_4.MsgCommunityPoolSpend.encode(tx_4.MsgCommunityPoolSpend.fromPartial({
                                 authority: FirmaGovService.GOV_AUTHORITY,
                                 recipient: recipient,
                                 amount: [{
@@ -629,7 +677,7 @@ var FirmaGovService = /** @class */ (function () {
                         proposer = _a.sent();
                         message = {
                             typeUrl: "/cosmos.gov.v1.MsgSubmitProposal",
-                            value: tx_1.MsgSubmitProposal.fromPartial({
+                            value: tx_2.MsgSubmitProposal.fromPartial({
                                 title: title,
                                 summary: summary,
                                 metadata: metadata,
@@ -816,7 +864,7 @@ var FirmaGovService = /** @class */ (function () {
             });
         });
     };
-    FirmaGovService.prototype.getProposal = function (id) {
+    FirmaGovService.prototype.getParamAsGovParams = function () {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_27;
             return __generator(this, function (_a) {
@@ -824,10 +872,28 @@ var FirmaGovService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new gov_1.GovQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryGetProposal(id)];
+                        return [4 /*yield*/, queryClient.queryGetParam()];
                     case 1:
                         result = _a.sent();
-                        return [2 /*return*/, result];
+                        // return as GovParams type
+                        return [2 /*return*/, {
+                                minDeposit: result.min_deposit,
+                                maxDepositPeriod: FirmaUtil_1.FirmaUtil.createDurationFromString(result.max_deposit_period),
+                                votingPeriod: FirmaUtil_1.FirmaUtil.createDurationFromString(result.voting_period),
+                                quorum: result.quorum,
+                                threshold: result.threshold,
+                                vetoThreshold: result.veto_threshold,
+                                minInitialDepositRatio: result.min_initial_deposit_ratio,
+                                proposalCancelRatio: result.proposal_cancel_ratio,
+                                proposalCancelDest: result.proposal_cancel_dest,
+                                expeditedVotingPeriod: FirmaUtil_1.FirmaUtil.createDurationFromString(result.expedited_voting_period),
+                                expeditedThreshold: result.expedited_threshold,
+                                expeditedMinDeposit: result.expedited_min_deposit,
+                                burnVoteQuorum: result.burn_vote_quorum,
+                                burnProposalDepositPrevote: result.burn_proposal_deposit_prevote,
+                                burnVoteVeto: result.burn_vote_veto,
+                                minDepositRatio: result.min_deposit_ratio
+                            }];
                     case 2:
                         error_27 = _a.sent();
                         FirmaUtil_1.FirmaUtil.printLog(error_27);
@@ -837,7 +903,7 @@ var FirmaGovService = /** @class */ (function () {
             });
         });
     };
-    FirmaGovService.prototype.getProposalListByStatus = function (status) {
+    FirmaGovService.prototype.getProposal = function (id) {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_28;
             return __generator(this, function (_a) {
@@ -845,7 +911,7 @@ var FirmaGovService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new gov_1.GovQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryGetProposalListByStatus(status)];
+                        return [4 /*yield*/, queryClient.queryGetProposal(id)];
                     case 1:
                         result = _a.sent();
                         return [2 /*return*/, result];
@@ -858,7 +924,7 @@ var FirmaGovService = /** @class */ (function () {
             });
         });
     };
-    FirmaGovService.prototype.getProposalList = function () {
+    FirmaGovService.prototype.getProposalListByStatus = function (status) {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_29;
             return __generator(this, function (_a) {
@@ -866,7 +932,7 @@ var FirmaGovService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new gov_1.GovQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryGetProposalList()];
+                        return [4 /*yield*/, queryClient.queryGetProposalListByStatus(status)];
                     case 1:
                         result = _a.sent();
                         return [2 /*return*/, result];
@@ -879,6 +945,27 @@ var FirmaGovService = /** @class */ (function () {
             });
         });
     };
+    FirmaGovService.prototype.getProposalList = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var queryClient, result, error_30;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        queryClient = new gov_1.GovQueryClient(this.config.restApiAddress);
+                        return [4 /*yield*/, queryClient.queryGetProposalList()];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, result];
+                    case 2:
+                        error_30 = _a.sent();
+                        FirmaUtil_1.FirmaUtil.printLog(error_30);
+                        throw error_30;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
     FirmaGovService.GOV_AUTHORITY = "firma10d07y265gmmuvt4z0w9aw880jnsr700j53mj8f";
     return FirmaGovService;
 }());

package/dist/sdk/FirmaStakingService.d.ts

@@ -1,9 +1,10 @@
-import { StakingTxClient, TxMisc, ValidatorDataType, PoolDataType, ParamsDataType, DelegationInfo, RedelegationInfo, UndelegationInfo, Pagination } from "./firmachain/staking";
+import { StakingTxClient, TxMisc, ValidatorDataType, PoolDataType, DelegationInfo, RedelegationInfo, UndelegationInfo, Pagination, StakingParamType } from "./firmachain/staking";
 import { FirmaWalletService } from "./FirmaWalletService";
 import { FirmaConfig } from "./FirmaConfig";
 import { DeliverTxResponse } from "./firmachain/common/stargateclient";
 import { Description } from "cosmjs-types/cosmos/staking/v1beta1/staking";
 import { MsgCreateValidator } from "cosmjs-types/cosmos/staking/v1beta1/tx";
+import { Params as StakingParams } from "@kintsugi-tech/cosmjs-types/cosmos/staking/v1beta1/staking";
 export declare enum StakingValidatorStatus {
     ALL = "",
     BONDED = "BOND_STATUS_BONDED",
@@ -43,7 +44,8 @@ export declare class FirmaStakingService {
         dataList: DelegationInfo[];
         pagination: Pagination;
     }>;
-    getParams(): Promise<ParamsDataType>;
+    getParams(): Promise<StakingParamType>;
+    getParamsAsStakingParams(): Promise<StakingParams>;
     getPool(): Promise<PoolDataType>;
     getValidator(valoperAddress: string): Promise<ValidatorDataType>;
     getValidatorList(status?: StakingValidatorStatus, paginationKey?: string): Promise<{

package/dist/sdk/FirmaStakingService.js

@@ -549,7 +549,7 @@ var FirmaStakingService = /** @class */ (function () {
             });
         });
     };
-    FirmaStakingService.prototype.getPool = function () {
+    FirmaStakingService.prototype.getParamsAsStakingParams = function () {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_22;
             return __generator(this, function (_a) {
@@ -557,10 +557,17 @@ var FirmaStakingService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new staking_1.StakingQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryGetPool()];
+                        return [4 /*yield*/, queryClient.queryGetParams()];
                     case 1:
                         result = _a.sent();
-                        return [2 /*return*/, result];
+                        return [2 /*return*/, {
+                                unbondingTime: FirmaUtil_1.FirmaUtil.createDurationFromString(result.unbonding_time),
+                                maxValidators: result.max_validators,
+                                maxEntries: result.max_entries,
+                                historicalEntries: result.historical_entries,
+                                bondDenom: result.bond_denom,
+                                minCommissionRate: result.min_commission_rate
+                            }];
                     case 2:
                         error_22 = _a.sent();
                         FirmaUtil_1.FirmaUtil.printLog(error_22);
@@ -570,7 +577,7 @@ var FirmaStakingService = /** @class */ (function () {
             });
         });
     };
-    FirmaStakingService.prototype.getValidator = function (valoperAddress) {
+    FirmaStakingService.prototype.getPool = function () {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_23;
             return __generator(this, function (_a) {
@@ -578,7 +585,7 @@ var FirmaStakingService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new staking_1.StakingQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryValidator(valoperAddress)];
+                        return [4 /*yield*/, queryClient.queryGetPool()];
                     case 1:
                         result = _a.sent();
                         return [2 /*return*/, result];
@@ -591,9 +598,7 @@ var FirmaStakingService = /** @class */ (function () {
             });
         });
     };
-    FirmaStakingService.prototype.getValidatorList = function (status, paginationKey) {
-        if (status === void 0) { status = StakingValidatorStatus.ALL; }
-        if (paginationKey === void 0) { paginationKey = ""; }
+    FirmaStakingService.prototype.getValidator = function (valoperAddress) {
         return __awaiter(this, void 0, void 0, function () {
             var queryClient, result, error_24;
             return __generator(this, function (_a) {
@@ -601,7 +606,7 @@ var FirmaStakingService = /** @class */ (function () {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
                         queryClient = new staking_1.StakingQueryClient(this.config.restApiAddress);
-                        return [4 /*yield*/, queryClient.queryValidators(status.toString(), paginationKey)];
+                        return [4 /*yield*/, queryClient.queryValidator(valoperAddress)];
                     case 1:
                         result = _a.sent();
                         return [2 /*return*/, result];
@@ -614,6 +619,29 @@ var FirmaStakingService = /** @class */ (function () {
             });
         });
     };
+    FirmaStakingService.prototype.getValidatorList = function (status, paginationKey) {
+        if (status === void 0) { status = StakingValidatorStatus.ALL; }
+        if (paginationKey === void 0) { paginationKey = ""; }
+        return __awaiter(this, void 0, void 0, function () {
+            var queryClient, result, error_25;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        queryClient = new staking_1.StakingQueryClient(this.config.restApiAddress);
+                        return [4 /*yield*/, queryClient.queryValidators(status.toString(), paginationKey)];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, result];
+                    case 2:
+                        error_25 = _a.sent();
+                        FirmaUtil_1.FirmaUtil.printLog(error_25);
+                        throw error_25;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
     return FirmaStakingService;
 }());
 exports.FirmaStakingService = FirmaStakingService;

package/dist/sdk/FirmaUtil.d.ts

@@ -7,6 +7,7 @@ import { FirmaWalletService } from "./FirmaWalletService";
 import { ArbitraryVerifyData } from "./firmachain/common/signingstargateclient";
 import { Any } from "./firmachain/google/protobuf/any";
 import { CommonTxClient } from "./firmachain/common/CommonTxClient";
+import { Duration } from "cosmjs-types/google/protobuf/duration";
 export declare class FirmaUtil {
     static config: FirmaConfig;
     static readonly FctDecimal: number;
@@ -49,6 +50,33 @@ export declare class FirmaUtil {
     static makeSignDocWithStringify(signerAddress: string, pubkey: string, messages: readonly EncodeObject[], txMisc?: TxMisc): Promise<string>;
     static getAnyData(registry: Registry, message: EncodeObject): Any;
     static getCommonTxClient(aliceWallet: FirmaWalletService): CommonTxClient;
+    /**
+     * Parses a duration string to a Duration object.
+     * Supports formats like "336h0m0s", "21d", "1000ms", "1s", "1m", "1h", "1ns", "1µs"/"1us"
+     *
+     * @param durationStr - Duration string to parse (e.g., "336h0m0s", "21d")
+     * @returns Duration object with seconds and nanos fields
+     */
+    static parseDurationString(durationStr: string): {
+        seconds: bigint;
+        nanos: number;
+    };
+    /**
+     * Creates a Duration object from a duration string.
+     * This is a convenience method that combines parseDurationString with Duration.fromPartial.
+     *
+     * @param durationStr - Duration string to parse (e.g., "336h0m0s", "21d")
+     * @returns Duration object ready to use with protobuf
+     */
+    static createDurationFromString(durationStr: string): Duration;
+    /**
+     * Safely processes commission rate strings to prevent big.Int conversion errors.
+     * Converts decimal commission rates to Cosmos SDK atomics format (integer representation).
+     *
+     * @param commissionRate - Commission rate string from staking params
+     * @returns Processed commission rate string safe for protobuf usage (atomics format or empty string)
+     */
+    static processCommissionRateAsDecimal(commissionRate: string): string;
 }
 export declare const DefaultTxMisc: {
     memo: string;