@gnolang/tm2-js-client 1.3.3 → 2.0.1

package/dist/provider/provider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.cjs","names":["uint8ArrayToBase64","Tx","extractSimulateFromResponse","adaptAbciQueryResponse","constructRequestError","extractBalanceFromResponse","adaptBlockResponse","adaptBlockResultsResponse","adaptConsensusParamsResponse","adaptNetInfoResponse","extractSequenceFromResponse","extractAccountNumberFromResponse","extractAccountFromResponse","adaptStatusResponse","adaptTxResponse","TransactionEndpoint","adaptBroadcastTxSyncResponse","ABCIErrorKey","adaptBroadcastTxCommitResponse","waitForTransaction"],"sources":["../../src/provider/provider.ts"],"sourcesContent":["import {\n  Tm2Client,\n} from \"@gnolang/tm2-rpc\";\n\nimport {\n  Tx,\n} from \"../proto/index.js\";\nimport {\n  TransactionEndpoint,\n} from \"./endpoints.js\";\nimport {\n  ABCIAccount,\n  ABCIErrorKey,\n  ABCIResponse,\n  BlockInfo,\n  BlockResult,\n  BroadcastAsGeneric,\n  BroadcastTransactionMap,\n  BroadcastTxCommitResult,\n  BroadcastTxSyncResult,\n  ConsensusParams,\n  NetworkInfo,\n  Status,\n  TxResult,\n} from \"./types/index.js\";\nimport {\n  constructRequestError,\n} from \"./utility/errors.utility.js\";\nimport {\n  adaptAbciQueryResponse,\n  adaptBlockResponse,\n  adaptBlockResultsResponse,\n  adaptBroadcastTxCommitResponse,\n  adaptBroadcastTxSyncResponse,\n  adaptConsensusParamsResponse,\n  adaptNetInfoResponse,\n  adaptStatusResponse,\n  adaptTxResponse,\n  extractAccountFromResponse,\n  extractAccountNumberFromResponse,\n  extractBalanceFromResponse,\n  extractSequenceFromResponse,\n  extractSimulateFromResponse,\n  uint8ArrayToBase64,\n  waitForTransaction,\n} from \"./utility/index.js\";\n\n/**\n * Read-only abstraction for accessing blockchain data\n */\nexport interface Provider {\n  // Account-specific methods //\n\n  /**\n   * Fetches the denomination balance of the account\n   * @param {string} address the bech32 address of the account\n   * @param {string} [denomination=ugnot] the balance denomination\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   */\n  getBalance(\n    address: string,\n    denomination?: string,\n    height?: number\n  ): Promise<number>\n\n  /**\n   * Fetches the account sequence\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used.\n   * @deprecated use {@link getAccount} instead\n   */\n  getAccountSequence(address: string, height?: number): Promise<number>\n\n  /**\n   * Fetches the account number. Errors out if the account\n   * is not initialized\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   * @deprecated use {@link getAccount} instead\n   */\n  getAccountNumber(address: string, height?: number): Promise<number>\n\n  /**\n   * Fetches the account. Errors out if the account\n   * is not initialized\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   */\n  getAccount(address: string, height?: number): Promise<ABCIAccount>\n\n  /**\n   * Fetches the block at the specific height, if any\n   * @param {number} height the height for querying\n   */\n  getBlock(height: number): Promise<BlockInfo>\n\n  /**\n   * Fetches the block at the specific height, if any\n   * @param {number} height the height for querying\n   */\n  getBlockResult(height: number): Promise<BlockResult>\n\n  /**\n   * Fetches the latest block number from the chain\n   */\n  getBlockNumber(): Promise<number>\n\n  // Network-specific methods //\n\n  /**\n   * Fetches the network information\n   */\n  getNetwork(): Promise<NetworkInfo>\n\n  /**\n   * Fetches the consensus params for the specific block height\n   * @param {number} height the height for querying\n   */\n  getConsensusParams(height: number): Promise<ConsensusParams>\n\n  /**\n   * Fetches the current node status\n   */\n  getStatus(): Promise<Status>\n\n  /**\n   * Fetches the current (recommended) average gas price\n   */\n  getGasPrice(): Promise<number>\n\n  /**\n   * Estimates the gas limit for the transaction\n   * @param {Tx} tx the transaction that needs estimating\n   */\n  estimateGas(tx: Tx): Promise<bigint>\n\n  // Transaction specific methods //\n\n  /**\n   * Sends the transaction to the node. If the type of endpoint\n   * is a broadcast commit, waits for the transaction to be committed to the chain.\n   * The transaction needs to be signed beforehand.\n   * Returns the transaction broadcast result.\n   * @param {string} tx the base64-encoded signed transaction\n   * @param {BroadcastType} endpoint the transaction broadcast type (sync / commit)\n   */\n  sendTransaction<K extends keyof BroadcastTransactionMap>(\n    tx: string,\n    endpoint: K\n  ): Promise<BroadcastAsGeneric<K>[\"result\"]>\n\n  /**\n   * Waits for the transaction to be committed on the chain.\n   * NOTE: This method will not take in the fromHeight parameter once\n   * proper transaction indexing is added - the implementation should\n   * simply try to fetch the transaction first to see if it's included in a block\n   * before starting to wait for it; Until then, this method should be used\n   * in the sequence:\n   * get latest block -> send transaction -> waitForTransaction(block before send)\n   * @param {string} hash The transaction hash\n   * @param {number} [fromHeight=latest] The block height used to begin the search\n   * @param {number} [timeout=15000] Optional wait timeout in MS\n   */\n  waitForTransaction(\n    hash: string,\n    fromHeight?: number,\n    timeout?: number\n  ): Promise<Tx>\n}\n\n/**\n * Base provider implementation backed by a Tm2Client.\n * Subclasses only need to provide a static `create()` factory.\n */\nexport abstract class BaseTm2Provider implements Provider {\n  protected readonly client: Tm2Client;\n\n  protected constructor(client: Tm2Client) {\n    this.client = client;\n  }\n\n  async estimateGas(tx: Tx): Promise<bigint> {\n    const encodedTx = uint8ArrayToBase64(Tx.encode(tx).finish());\n    const rpcResponse = await this.client.abciQuery({\n      path: \".app/simulate\",\n      data: new TextEncoder().encode(encodedTx),\n      height: 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    const simulateResult = extractSimulateFromResponse(abciResponse);\n\n    const resultErrorKey = simulateResult.response_base?.error?.type_url;\n    if (resultErrorKey) {\n      throw constructRequestError(resultErrorKey);\n    }\n\n    return simulateResult.gas_used;\n  }\n\n  async getBalance(\n    address: string,\n    denomination?: string,\n    height?: number,\n  ): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `bank/balances/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n\n    return extractBalanceFromResponse(\n      abciResponse.response.ResponseBase.Data,\n      denomination ? denomination : \"ugnot\",\n    );\n  }\n\n  async getBlock(height: number): Promise<BlockInfo> {\n    const rpcResponse = await this.client.block(height);\n    return adaptBlockResponse(rpcResponse);\n  }\n\n  async getBlockResult(height: number): Promise<BlockResult> {\n    const rpcResponse = await this.client.blockResults(height);\n    return adaptBlockResultsResponse(rpcResponse);\n  }\n\n  async getBlockNumber(): Promise<number> {\n    const status = await this.getStatus();\n    return parseInt(status.sync_info.latest_block_height);\n  }\n\n  async getConsensusParams(height: number): Promise<ConsensusParams> {\n    const rpcResponse = await this.client.consensusParams(height);\n    return adaptConsensusParamsResponse(rpcResponse);\n  }\n\n  getGasPrice(): Promise<number> {\n    return Promise.reject(\"not supported\");\n  }\n\n  async getNetwork(): Promise<NetworkInfo> {\n    const rpcResponse = await this.client.netInfo();\n    return adaptNetInfoResponse(rpcResponse);\n  }\n\n  async getAccountSequence(address: string, height?: number): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractSequenceFromResponse(abciResponse.response.ResponseBase.Data);\n  }\n\n  async getAccountNumber(address: string, height?: number): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractAccountNumberFromResponse(\n      abciResponse.response.ResponseBase.Data,\n    );\n  }\n\n  async getAccount(address: string, height?: number): Promise<ABCIAccount> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractAccountFromResponse(abciResponse.response.ResponseBase.Data);\n  }\n\n  async getStatus(): Promise<Status> {\n    const rpcResponse = await this.client.status();\n    return adaptStatusResponse(rpcResponse);\n  }\n\n  async getTransaction(hash: string): Promise<TxResult> {\n    const hashBytes = Uint8Array.from(\n      (hash.match(/.{1,2}/g) ?? []).map(byte => parseInt(byte, 16)),\n    );\n    const rpcResponse = await this.client.tx({\n      hash: hashBytes,\n    });\n    return adaptTxResponse(rpcResponse);\n  }\n\n  async sendTransaction<K extends keyof BroadcastTransactionMap>(\n    tx: string,\n    endpoint: K,\n  ): Promise<BroadcastTransactionMap[K][\"result\"]> {\n    const txBytes = Uint8Array.from(Buffer.from(tx, \"base64\"));\n\n    switch (endpoint) {\n      case TransactionEndpoint.BROADCAST_TX_COMMIT:\n        return this.broadcastTxCommit(txBytes);\n      case TransactionEndpoint.BROADCAST_TX_SYNC:\n      default:\n        return this.broadcastTxSync(txBytes);\n    }\n  }\n\n  private async broadcastTxSync(\n    txBytes: Uint8Array,\n  ): Promise<BroadcastTxSyncResult> {\n    const rpcResponse = await this.client.broadcastTxSync({\n      tx: txBytes,\n    });\n    const response = adaptBroadcastTxSyncResponse(rpcResponse);\n\n    if (response.error) {\n      const errType: string = response.error[ABCIErrorKey];\n      const log: string = response.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    return response;\n  }\n\n  private async broadcastTxCommit(\n    txBytes: Uint8Array,\n  ): Promise<BroadcastTxCommitResult> {\n    const rpcResponse = await this.client.broadcastTxCommit({\n      tx: txBytes,\n    });\n    const response = adaptBroadcastTxCommitResponse(rpcResponse);\n\n    const {\n      check_tx, deliver_tx,\n    } = response;\n\n    if (check_tx.ResponseBase.Error) {\n      const errType: string = check_tx.ResponseBase.Error[ABCIErrorKey];\n      const log: string = check_tx.ResponseBase.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    if (deliver_tx.ResponseBase.Error) {\n      const errType: string = deliver_tx.ResponseBase.Error[ABCIErrorKey];\n      const log: string = deliver_tx.ResponseBase.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    return response;\n  }\n\n  async waitForTransaction(\n    hash: string,\n    fromHeight?: number,\n    timeout?: number,\n  ): Promise<Tx> {\n    return waitForTransaction(this, hash, fromHeight, timeout);\n  }\n}\n"],"mappings":"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"}

package/dist/provider/provider.d.cts

@@ -0,0 +1,130 @@
+import { Tx } from "../proto/tm2/tx.cjs";
+import { ABCIAccount } from "./types/abci.cjs";
+import { BlockInfo, BlockResult, BroadcastAsGeneric, BroadcastTransactionMap, ConsensusParams, NetworkInfo, Status, TxResult } from "./types/common.cjs";
+import { Tm2Client } from "@gnolang/tm2-rpc";
+
+//#region src/provider/provider.d.ts
+/**
+ * Read-only abstraction for accessing blockchain data
+ */
+interface Provider {
+  /**
+   * Fetches the denomination balance of the account
+   * @param {string} address the bech32 address of the account
+   * @param {string} [denomination=ugnot] the balance denomination
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   */
+  getBalance(address: string, denomination?: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account sequence
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used.
+   * @deprecated use {@link getAccount} instead
+   */
+  getAccountSequence(address: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account number. Errors out if the account
+   * is not initialized
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   * @deprecated use {@link getAccount} instead
+   */
+  getAccountNumber(address: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account. Errors out if the account
+   * is not initialized
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   */
+  getAccount(address: string, height?: number): Promise<ABCIAccount>;
+  /**
+   * Fetches the block at the specific height, if any
+   * @param {number} height the height for querying
+   */
+  getBlock(height: number): Promise<BlockInfo>;
+  /**
+   * Fetches the block at the specific height, if any
+   * @param {number} height the height for querying
+   */
+  getBlockResult(height: number): Promise<BlockResult>;
+  /**
+   * Fetches the latest block number from the chain
+   */
+  getBlockNumber(): Promise<number>;
+  /**
+   * Fetches the network information
+   */
+  getNetwork(): Promise<NetworkInfo>;
+  /**
+   * Fetches the consensus params for the specific block height
+   * @param {number} height the height for querying
+   */
+  getConsensusParams(height: number): Promise<ConsensusParams>;
+  /**
+   * Fetches the current node status
+   */
+  getStatus(): Promise<Status>;
+  /**
+   * Fetches the current (recommended) average gas price
+   */
+  getGasPrice(): Promise<number>;
+  /**
+   * Estimates the gas limit for the transaction
+   * @param {Tx} tx the transaction that needs estimating
+   */
+  estimateGas(tx: Tx): Promise<bigint>;
+  /**
+   * Sends the transaction to the node. If the type of endpoint
+   * is a broadcast commit, waits for the transaction to be committed to the chain.
+   * The transaction needs to be signed beforehand.
+   * Returns the transaction broadcast result.
+   * @param {string} tx the base64-encoded signed transaction
+   * @param {BroadcastType} endpoint the transaction broadcast type (sync / commit)
+   */
+  sendTransaction<K extends keyof BroadcastTransactionMap>(tx: string, endpoint: K): Promise<BroadcastAsGeneric<K>["result"]>;
+  /**
+   * Waits for the transaction to be committed on the chain.
+   * NOTE: This method will not take in the fromHeight parameter once
+   * proper transaction indexing is added - the implementation should
+   * simply try to fetch the transaction first to see if it's included in a block
+   * before starting to wait for it; Until then, this method should be used
+   * in the sequence:
+   * get latest block -> send transaction -> waitForTransaction(block before send)
+   * @param {string} hash The transaction hash
+   * @param {number} [fromHeight=latest] The block height used to begin the search
+   * @param {number} [timeout=15000] Optional wait timeout in MS
+   */
+  waitForTransaction(hash: string, fromHeight?: number, timeout?: number): Promise<Tx>;
+}
+/**
+ * Base provider implementation backed by a Tm2Client.
+ * Subclasses only need to provide a static `create()` factory.
+ */
+declare abstract class BaseTm2Provider implements Provider {
+  protected readonly client: Tm2Client;
+  protected constructor(client: Tm2Client);
+  estimateGas(tx: Tx): Promise<bigint>;
+  getBalance(address: string, denomination?: string, height?: number): Promise<number>;
+  getBlock(height: number): Promise<BlockInfo>;
+  getBlockResult(height: number): Promise<BlockResult>;
+  getBlockNumber(): Promise<number>;
+  getConsensusParams(height: number): Promise<ConsensusParams>;
+  getGasPrice(): Promise<number>;
+  getNetwork(): Promise<NetworkInfo>;
+  getAccountSequence(address: string, height?: number): Promise<number>;
+  getAccountNumber(address: string, height?: number): Promise<number>;
+  getAccount(address: string, height?: number): Promise<ABCIAccount>;
+  getStatus(): Promise<Status>;
+  getTransaction(hash: string): Promise<TxResult>;
+  sendTransaction<K extends keyof BroadcastTransactionMap>(tx: string, endpoint: K): Promise<BroadcastTransactionMap[K]["result"]>;
+  private broadcastTxSync;
+  private broadcastTxCommit;
+  waitForTransaction(hash: string, fromHeight?: number, timeout?: number): Promise<Tx>;
+}
+//#endregion
+export { BaseTm2Provider, Provider };
+//# sourceMappingURL=provider.d.cts.map

package/dist/provider/provider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.cts","names":[],"sources":["../../src/provider/provider.ts"],"mappings":";;;;;;;;;UAkDiB,QAAA;EAAA;;;;;;;EAUf,UAAA,CACE,OAAA,UACA,YAAA,WACA,MAAA,YACC,OAAA;EAkC+B;;;;;;;EAzBlC,kBAAA,CAAmB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAiDlB;;;;;;;;EAvCpC,gBAAA,CAAiB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAsEzC;;;;;;;EA7DX,UAAA,CAAW,OAAA,UAAiB,MAAA,YAAkB,OAAA,CAAQ,WAAA;EA9BpD;;;;EAoCF,QAAA,CAAS,MAAA,WAAiB,OAAA,CAAQ,SAAA;EAzBE;;;;EA+BpC,cAAA,CAAe,MAAA,WAAiB,OAAA,CAAQ,WAAA;EArBY;;;EA0BpD,cAAA,IAAkB,OAAA;EAjB4B;;;EAwB9C,UAAA,IAAc,OAAA,CAAQ,WAAA;EAlBI;;;;EAwB1B,kBAAA,CAAmB,MAAA,WAAiB,OAAA,CAAQ,eAAA;EAlBJ;;;EAuBxC,SAAA,IAAa,OAAA,CAAQ,MAAA;EAXP;;;EAgBd,WAAA,IAAe,OAAA;EAVqB;;;;EAgBpC,WAAA,CAAY,EAAA,EAAI,EAAA,GAAK,OAAA;EANrB;;;;;;;;EAkBA,eAAA,iBAAgC,uBAAA,EAC9B,EAAA,UACA,QAAA,EAAU,CAAA,GACT,OAAA,CAAQ,kBAAA,CAAmB,CAAA;EAF5B;;;;;;;;;;;;EAgBF,kBAAA,CACE,IAAA,UACA,UAAA,WACA,OAAA,YACC,OAAA,CAAQ,EAAA;AAAA;AAOb;;;;AAAA,uBAAsB,eAAA,YAA2B,QAAA;EAAA,mBAC5B,MAAA,EAAQ,SAAA;EAAA,UAElB,WAAA,CAAa,MAAA,EAAQ,SAAA;EAIxB,WAAA,CAAY,EAAA,EAAI,EAAA,GAAK,OAAA;EAoBrB,UAAA,CACJ,OAAA,UACA,YAAA,WACA,MAAA,YACC,OAAA;EAgBG,QAAA,CAAS,MAAA,WAAiB,OAAA,CAAQ,SAAA;EAKlC,cAAA,CAAe,MAAA,WAAiB,OAAA,CAAQ,WAAA;EAKxC,cAAA,CAAA,GAAkB,OAAA;EAKlB,kBAAA,CAAmB,MAAA,WAAiB,OAAA,CAAQ,eAAA;EAKlD,WAAA,CAAA,GAAe,OAAA;EAIT,UAAA,CAAA,GAAc,OAAA,CAAQ,WAAA;EAKtB,kBAAA,CAAmB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAYtD,gBAAA,CAAiB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAcpD,UAAA,CAAW,OAAA,UAAiB,MAAA,YAAkB,OAAA,CAAQ,WAAA;EAYtD,SAAA,CAAA,GAAa,OAAA,CAAQ,MAAA;EAKrB,cAAA,CAAe,IAAA,WAAe,OAAA,CAAQ,QAAA;EAUtC,eAAA,iBAAgC,uBAAA,CAAA,CACpC,EAAA,UACA,QAAA,EAAU,CAAA,GACT,OAAA,CAAQ,uBAAA,CAAwB,CAAA;EAAA,QAYrB,eAAA;EAAA,QAkBA,iBAAA;EA6BR,kBAAA,CACJ,IAAA,UACA,UAAA,WACA,OAAA,YACC,OAAA,CAAQ,EAAA;AAAA"}

package/dist/provider/provider.d.mts

@@ -0,0 +1,130 @@
+import { Tx } from "../proto/tm2/tx.mjs";
+import { ABCIAccount } from "./types/abci.mjs";
+import { BlockInfo, BlockResult, BroadcastAsGeneric, BroadcastTransactionMap, ConsensusParams, NetworkInfo, Status, TxResult } from "./types/common.mjs";
+import { Tm2Client } from "@gnolang/tm2-rpc";
+
+//#region src/provider/provider.d.ts
+/**
+ * Read-only abstraction for accessing blockchain data
+ */
+interface Provider {
+  /**
+   * Fetches the denomination balance of the account
+   * @param {string} address the bech32 address of the account
+   * @param {string} [denomination=ugnot] the balance denomination
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   */
+  getBalance(address: string, denomination?: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account sequence
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used.
+   * @deprecated use {@link getAccount} instead
+   */
+  getAccountSequence(address: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account number. Errors out if the account
+   * is not initialized
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   * @deprecated use {@link getAccount} instead
+   */
+  getAccountNumber(address: string, height?: number): Promise<number>;
+  /**
+   * Fetches the account. Errors out if the account
+   * is not initialized
+   * @param {string} address the bech32 address of the account
+   * @param {number} [height=0] the height for querying.
+   * If omitted, the latest height is used
+   */
+  getAccount(address: string, height?: number): Promise<ABCIAccount>;
+  /**
+   * Fetches the block at the specific height, if any
+   * @param {number} height the height for querying
+   */
+  getBlock(height: number): Promise<BlockInfo>;
+  /**
+   * Fetches the block at the specific height, if any
+   * @param {number} height the height for querying
+   */
+  getBlockResult(height: number): Promise<BlockResult>;
+  /**
+   * Fetches the latest block number from the chain
+   */
+  getBlockNumber(): Promise<number>;
+  /**
+   * Fetches the network information
+   */
+  getNetwork(): Promise<NetworkInfo>;
+  /**
+   * Fetches the consensus params for the specific block height
+   * @param {number} height the height for querying
+   */
+  getConsensusParams(height: number): Promise<ConsensusParams>;
+  /**
+   * Fetches the current node status
+   */
+  getStatus(): Promise<Status>;
+  /**
+   * Fetches the current (recommended) average gas price
+   */
+  getGasPrice(): Promise<number>;
+  /**
+   * Estimates the gas limit for the transaction
+   * @param {Tx} tx the transaction that needs estimating
+   */
+  estimateGas(tx: Tx): Promise<bigint>;
+  /**
+   * Sends the transaction to the node. If the type of endpoint
+   * is a broadcast commit, waits for the transaction to be committed to the chain.
+   * The transaction needs to be signed beforehand.
+   * Returns the transaction broadcast result.
+   * @param {string} tx the base64-encoded signed transaction
+   * @param {BroadcastType} endpoint the transaction broadcast type (sync / commit)
+   */
+  sendTransaction<K extends keyof BroadcastTransactionMap>(tx: string, endpoint: K): Promise<BroadcastAsGeneric<K>["result"]>;
+  /**
+   * Waits for the transaction to be committed on the chain.
+   * NOTE: This method will not take in the fromHeight parameter once
+   * proper transaction indexing is added - the implementation should
+   * simply try to fetch the transaction first to see if it's included in a block
+   * before starting to wait for it; Until then, this method should be used
+   * in the sequence:
+   * get latest block -> send transaction -> waitForTransaction(block before send)
+   * @param {string} hash The transaction hash
+   * @param {number} [fromHeight=latest] The block height used to begin the search
+   * @param {number} [timeout=15000] Optional wait timeout in MS
+   */
+  waitForTransaction(hash: string, fromHeight?: number, timeout?: number): Promise<Tx>;
+}
+/**
+ * Base provider implementation backed by a Tm2Client.
+ * Subclasses only need to provide a static `create()` factory.
+ */
+declare abstract class BaseTm2Provider implements Provider {
+  protected readonly client: Tm2Client;
+  protected constructor(client: Tm2Client);
+  estimateGas(tx: Tx): Promise<bigint>;
+  getBalance(address: string, denomination?: string, height?: number): Promise<number>;
+  getBlock(height: number): Promise<BlockInfo>;
+  getBlockResult(height: number): Promise<BlockResult>;
+  getBlockNumber(): Promise<number>;
+  getConsensusParams(height: number): Promise<ConsensusParams>;
+  getGasPrice(): Promise<number>;
+  getNetwork(): Promise<NetworkInfo>;
+  getAccountSequence(address: string, height?: number): Promise<number>;
+  getAccountNumber(address: string, height?: number): Promise<number>;
+  getAccount(address: string, height?: number): Promise<ABCIAccount>;
+  getStatus(): Promise<Status>;
+  getTransaction(hash: string): Promise<TxResult>;
+  sendTransaction<K extends keyof BroadcastTransactionMap>(tx: string, endpoint: K): Promise<BroadcastTransactionMap[K]["result"]>;
+  private broadcastTxSync;
+  private broadcastTxCommit;
+  waitForTransaction(hash: string, fromHeight?: number, timeout?: number): Promise<Tx>;
+}
+//#endregion
+export { BaseTm2Provider, Provider };
+//# sourceMappingURL=provider.d.mts.map

package/dist/provider/provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../../src/provider/provider.ts"],"mappings":";;;;;;;;;UAkDiB,QAAA;EAAA;;;;;;;EAUf,UAAA,CACE,OAAA,UACA,YAAA,WACA,MAAA,YACC,OAAA;EAkC+B;;;;;;;EAzBlC,kBAAA,CAAmB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAiDlB;;;;;;;;EAvCpC,gBAAA,CAAiB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAsEzC;;;;;;;EA7DX,UAAA,CAAW,OAAA,UAAiB,MAAA,YAAkB,OAAA,CAAQ,WAAA;EA9BpD;;;;EAoCF,QAAA,CAAS,MAAA,WAAiB,OAAA,CAAQ,SAAA;EAzBE;;;;EA+BpC,cAAA,CAAe,MAAA,WAAiB,OAAA,CAAQ,WAAA;EArBY;;;EA0BpD,cAAA,IAAkB,OAAA;EAjB4B;;;EAwB9C,UAAA,IAAc,OAAA,CAAQ,WAAA;EAlBI;;;;EAwB1B,kBAAA,CAAmB,MAAA,WAAiB,OAAA,CAAQ,eAAA;EAlBJ;;;EAuBxC,SAAA,IAAa,OAAA,CAAQ,MAAA;EAXP;;;EAgBd,WAAA,IAAe,OAAA;EAVqB;;;;EAgBpC,WAAA,CAAY,EAAA,EAAI,EAAA,GAAK,OAAA;EANrB;;;;;;;;EAkBA,eAAA,iBAAgC,uBAAA,EAC9B,EAAA,UACA,QAAA,EAAU,CAAA,GACT,OAAA,CAAQ,kBAAA,CAAmB,CAAA;EAF5B;;;;;;;;;;;;EAgBF,kBAAA,CACE,IAAA,UACA,UAAA,WACA,OAAA,YACC,OAAA,CAAQ,EAAA;AAAA;AAOb;;;;AAAA,uBAAsB,eAAA,YAA2B,QAAA;EAAA,mBAC5B,MAAA,EAAQ,SAAA;EAAA,UAElB,WAAA,CAAa,MAAA,EAAQ,SAAA;EAIxB,WAAA,CAAY,EAAA,EAAI,EAAA,GAAK,OAAA;EAoBrB,UAAA,CACJ,OAAA,UACA,YAAA,WACA,MAAA,YACC,OAAA;EAgBG,QAAA,CAAS,MAAA,WAAiB,OAAA,CAAQ,SAAA;EAKlC,cAAA,CAAe,MAAA,WAAiB,OAAA,CAAQ,WAAA;EAKxC,cAAA,CAAA,GAAkB,OAAA;EAKlB,kBAAA,CAAmB,MAAA,WAAiB,OAAA,CAAQ,eAAA;EAKlD,WAAA,CAAA,GAAe,OAAA;EAIT,UAAA,CAAA,GAAc,OAAA,CAAQ,WAAA;EAKtB,kBAAA,CAAmB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAYtD,gBAAA,CAAiB,OAAA,UAAiB,MAAA,YAAkB,OAAA;EAcpD,UAAA,CAAW,OAAA,UAAiB,MAAA,YAAkB,OAAA,CAAQ,WAAA;EAYtD,SAAA,CAAA,GAAa,OAAA,CAAQ,MAAA;EAKrB,cAAA,CAAe,IAAA,WAAe,OAAA,CAAQ,QAAA;EAUtC,eAAA,iBAAgC,uBAAA,CAAA,CACpC,EAAA,UACA,QAAA,EAAU,CAAA,GACT,OAAA,CAAQ,uBAAA,CAAwB,CAAA;EAAA,QAYrB,eAAA;EAAA,QAkBA,iBAAA;EA6BR,kBAAA,CACJ,IAAA,UACA,UAAA,WACA,OAAA,YACC,OAAA,CAAQ,EAAA;AAAA"}

package/dist/provider/provider.mjs

@@ -0,0 +1,130 @@
+import { Tx } from "../proto/tm2/tx.mjs";
+import "../proto/index.mjs";
+import { TransactionEndpoint } from "./endpoints.mjs";
+import { _defineProperty } from "../_virtual/_@oxc-project_runtime@0.122.0/helpers/defineProperty.mjs";
+import { ABCIErrorKey } from "./types/abci.mjs";
+import { constructRequestError } from "./utility/errors.utility.mjs";
+import { adaptAbciQueryResponse, adaptBlockResponse, adaptBlockResultsResponse, adaptBroadcastTxCommitResponse, adaptBroadcastTxSyncResponse, adaptConsensusParamsResponse, adaptNetInfoResponse, adaptStatusResponse, adaptTxResponse } from "./utility/adapters.mjs";
+import { uint8ArrayToBase64 } from "./utility/requests.utility.mjs";
+import { extractAccountFromResponse, extractAccountNumberFromResponse, extractBalanceFromResponse, extractSequenceFromResponse, extractSimulateFromResponse, waitForTransaction } from "./utility/provider.utility.mjs";
+import "./utility/index.mjs";
+//#region src/provider/provider.ts
+/**
+* Base provider implementation backed by a Tm2Client.
+* Subclasses only need to provide a static `create()` factory.
+*/
+var BaseTm2Provider = class {
+	constructor(client) {
+		_defineProperty(this, "client", void 0);
+		this.client = client;
+	}
+	async estimateGas(tx) {
+		const encodedTx = uint8ArrayToBase64(Tx.encode(tx).finish());
+		const simulateResult = extractSimulateFromResponse(adaptAbciQueryResponse(await this.client.abciQuery({
+			path: ".app/simulate",
+			data: new TextEncoder().encode(encodedTx),
+			height: 0,
+			prove: false
+		})));
+		const resultErrorKey = simulateResult.response_base?.error?.type_url;
+		if (resultErrorKey) throw constructRequestError(resultErrorKey);
+		return simulateResult.gas_used;
+	}
+	async getBalance(address, denomination, height) {
+		return extractBalanceFromResponse(adaptAbciQueryResponse(await this.client.abciQuery({
+			path: `bank/balances/${address}`,
+			data: new Uint8Array(),
+			height: height ? height : 0,
+			prove: false
+		})).response.ResponseBase.Data, denomination ? denomination : "ugnot");
+	}
+	async getBlock(height) {
+		return adaptBlockResponse(await this.client.block(height));
+	}
+	async getBlockResult(height) {
+		return adaptBlockResultsResponse(await this.client.blockResults(height));
+	}
+	async getBlockNumber() {
+		const status = await this.getStatus();
+		return parseInt(status.sync_info.latest_block_height);
+	}
+	async getConsensusParams(height) {
+		return adaptConsensusParamsResponse(await this.client.consensusParams(height));
+	}
+	getGasPrice() {
+		return Promise.reject("not supported");
+	}
+	async getNetwork() {
+		return adaptNetInfoResponse(await this.client.netInfo());
+	}
+	async getAccountSequence(address, height) {
+		return extractSequenceFromResponse(adaptAbciQueryResponse(await this.client.abciQuery({
+			path: `auth/accounts/${address}`,
+			data: new Uint8Array(),
+			height: height ? height : 0,
+			prove: false
+		})).response.ResponseBase.Data);
+	}
+	async getAccountNumber(address, height) {
+		return extractAccountNumberFromResponse(adaptAbciQueryResponse(await this.client.abciQuery({
+			path: `auth/accounts/${address}`,
+			data: new Uint8Array(),
+			height: height ? height : 0,
+			prove: false
+		})).response.ResponseBase.Data);
+	}
+	async getAccount(address, height) {
+		return extractAccountFromResponse(adaptAbciQueryResponse(await this.client.abciQuery({
+			path: `auth/accounts/${address}`,
+			data: new Uint8Array(),
+			height: height ? height : 0,
+			prove: false
+		})).response.ResponseBase.Data);
+	}
+	async getStatus() {
+		return adaptStatusResponse(await this.client.status());
+	}
+	async getTransaction(hash) {
+		const hashBytes = Uint8Array.from((hash.match(/.{1,2}/g) ?? []).map((byte) => parseInt(byte, 16)));
+		return adaptTxResponse(await this.client.tx({ hash: hashBytes }));
+	}
+	async sendTransaction(tx, endpoint) {
+		const txBytes = Uint8Array.from(Buffer.from(tx, "base64"));
+		switch (endpoint) {
+			case TransactionEndpoint.BROADCAST_TX_COMMIT: return this.broadcastTxCommit(txBytes);
+			case TransactionEndpoint.BROADCAST_TX_SYNC:
+			default: return this.broadcastTxSync(txBytes);
+		}
+	}
+	async broadcastTxSync(txBytes) {
+		const response = adaptBroadcastTxSyncResponse(await this.client.broadcastTxSync({ tx: txBytes }));
+		if (response.error) {
+			const errType = response.error[ABCIErrorKey];
+			const log = response.Log;
+			throw constructRequestError(errType, log);
+		}
+		return response;
+	}
+	async broadcastTxCommit(txBytes) {
+		const response = adaptBroadcastTxCommitResponse(await this.client.broadcastTxCommit({ tx: txBytes }));
+		const { check_tx, deliver_tx } = response;
+		if (check_tx.ResponseBase.Error) {
+			const errType = check_tx.ResponseBase.Error[ABCIErrorKey];
+			const log = check_tx.ResponseBase.Log;
+			throw constructRequestError(errType, log);
+		}
+		if (deliver_tx.ResponseBase.Error) {
+			const errType = deliver_tx.ResponseBase.Error[ABCIErrorKey];
+			const log = deliver_tx.ResponseBase.Log;
+			throw constructRequestError(errType, log);
+		}
+		return response;
+	}
+	async waitForTransaction(hash, fromHeight, timeout) {
+		return waitForTransaction(this, hash, fromHeight, timeout);
+	}
+};
+//#endregion
+export { BaseTm2Provider };
+
+//# sourceMappingURL=provider.mjs.map

package/dist/provider/provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.mjs","names":[],"sources":["../../src/provider/provider.ts"],"sourcesContent":["import {\n  Tm2Client,\n} from \"@gnolang/tm2-rpc\";\n\nimport {\n  Tx,\n} from \"../proto/index.js\";\nimport {\n  TransactionEndpoint,\n} from \"./endpoints.js\";\nimport {\n  ABCIAccount,\n  ABCIErrorKey,\n  ABCIResponse,\n  BlockInfo,\n  BlockResult,\n  BroadcastAsGeneric,\n  BroadcastTransactionMap,\n  BroadcastTxCommitResult,\n  BroadcastTxSyncResult,\n  ConsensusParams,\n  NetworkInfo,\n  Status,\n  TxResult,\n} from \"./types/index.js\";\nimport {\n  constructRequestError,\n} from \"./utility/errors.utility.js\";\nimport {\n  adaptAbciQueryResponse,\n  adaptBlockResponse,\n  adaptBlockResultsResponse,\n  adaptBroadcastTxCommitResponse,\n  adaptBroadcastTxSyncResponse,\n  adaptConsensusParamsResponse,\n  adaptNetInfoResponse,\n  adaptStatusResponse,\n  adaptTxResponse,\n  extractAccountFromResponse,\n  extractAccountNumberFromResponse,\n  extractBalanceFromResponse,\n  extractSequenceFromResponse,\n  extractSimulateFromResponse,\n  uint8ArrayToBase64,\n  waitForTransaction,\n} from \"./utility/index.js\";\n\n/**\n * Read-only abstraction for accessing blockchain data\n */\nexport interface Provider {\n  // Account-specific methods //\n\n  /**\n   * Fetches the denomination balance of the account\n   * @param {string} address the bech32 address of the account\n   * @param {string} [denomination=ugnot] the balance denomination\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   */\n  getBalance(\n    address: string,\n    denomination?: string,\n    height?: number\n  ): Promise<number>\n\n  /**\n   * Fetches the account sequence\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used.\n   * @deprecated use {@link getAccount} instead\n   */\n  getAccountSequence(address: string, height?: number): Promise<number>\n\n  /**\n   * Fetches the account number. Errors out if the account\n   * is not initialized\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   * @deprecated use {@link getAccount} instead\n   */\n  getAccountNumber(address: string, height?: number): Promise<number>\n\n  /**\n   * Fetches the account. Errors out if the account\n   * is not initialized\n   * @param {string} address the bech32 address of the account\n   * @param {number} [height=0] the height for querying.\n   * If omitted, the latest height is used\n   */\n  getAccount(address: string, height?: number): Promise<ABCIAccount>\n\n  /**\n   * Fetches the block at the specific height, if any\n   * @param {number} height the height for querying\n   */\n  getBlock(height: number): Promise<BlockInfo>\n\n  /**\n   * Fetches the block at the specific height, if any\n   * @param {number} height the height for querying\n   */\n  getBlockResult(height: number): Promise<BlockResult>\n\n  /**\n   * Fetches the latest block number from the chain\n   */\n  getBlockNumber(): Promise<number>\n\n  // Network-specific methods //\n\n  /**\n   * Fetches the network information\n   */\n  getNetwork(): Promise<NetworkInfo>\n\n  /**\n   * Fetches the consensus params for the specific block height\n   * @param {number} height the height for querying\n   */\n  getConsensusParams(height: number): Promise<ConsensusParams>\n\n  /**\n   * Fetches the current node status\n   */\n  getStatus(): Promise<Status>\n\n  /**\n   * Fetches the current (recommended) average gas price\n   */\n  getGasPrice(): Promise<number>\n\n  /**\n   * Estimates the gas limit for the transaction\n   * @param {Tx} tx the transaction that needs estimating\n   */\n  estimateGas(tx: Tx): Promise<bigint>\n\n  // Transaction specific methods //\n\n  /**\n   * Sends the transaction to the node. If the type of endpoint\n   * is a broadcast commit, waits for the transaction to be committed to the chain.\n   * The transaction needs to be signed beforehand.\n   * Returns the transaction broadcast result.\n   * @param {string} tx the base64-encoded signed transaction\n   * @param {BroadcastType} endpoint the transaction broadcast type (sync / commit)\n   */\n  sendTransaction<K extends keyof BroadcastTransactionMap>(\n    tx: string,\n    endpoint: K\n  ): Promise<BroadcastAsGeneric<K>[\"result\"]>\n\n  /**\n   * Waits for the transaction to be committed on the chain.\n   * NOTE: This method will not take in the fromHeight parameter once\n   * proper transaction indexing is added - the implementation should\n   * simply try to fetch the transaction first to see if it's included in a block\n   * before starting to wait for it; Until then, this method should be used\n   * in the sequence:\n   * get latest block -> send transaction -> waitForTransaction(block before send)\n   * @param {string} hash The transaction hash\n   * @param {number} [fromHeight=latest] The block height used to begin the search\n   * @param {number} [timeout=15000] Optional wait timeout in MS\n   */\n  waitForTransaction(\n    hash: string,\n    fromHeight?: number,\n    timeout?: number\n  ): Promise<Tx>\n}\n\n/**\n * Base provider implementation backed by a Tm2Client.\n * Subclasses only need to provide a static `create()` factory.\n */\nexport abstract class BaseTm2Provider implements Provider {\n  protected readonly client: Tm2Client;\n\n  protected constructor(client: Tm2Client) {\n    this.client = client;\n  }\n\n  async estimateGas(tx: Tx): Promise<bigint> {\n    const encodedTx = uint8ArrayToBase64(Tx.encode(tx).finish());\n    const rpcResponse = await this.client.abciQuery({\n      path: \".app/simulate\",\n      data: new TextEncoder().encode(encodedTx),\n      height: 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    const simulateResult = extractSimulateFromResponse(abciResponse);\n\n    const resultErrorKey = simulateResult.response_base?.error?.type_url;\n    if (resultErrorKey) {\n      throw constructRequestError(resultErrorKey);\n    }\n\n    return simulateResult.gas_used;\n  }\n\n  async getBalance(\n    address: string,\n    denomination?: string,\n    height?: number,\n  ): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `bank/balances/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n\n    return extractBalanceFromResponse(\n      abciResponse.response.ResponseBase.Data,\n      denomination ? denomination : \"ugnot\",\n    );\n  }\n\n  async getBlock(height: number): Promise<BlockInfo> {\n    const rpcResponse = await this.client.block(height);\n    return adaptBlockResponse(rpcResponse);\n  }\n\n  async getBlockResult(height: number): Promise<BlockResult> {\n    const rpcResponse = await this.client.blockResults(height);\n    return adaptBlockResultsResponse(rpcResponse);\n  }\n\n  async getBlockNumber(): Promise<number> {\n    const status = await this.getStatus();\n    return parseInt(status.sync_info.latest_block_height);\n  }\n\n  async getConsensusParams(height: number): Promise<ConsensusParams> {\n    const rpcResponse = await this.client.consensusParams(height);\n    return adaptConsensusParamsResponse(rpcResponse);\n  }\n\n  getGasPrice(): Promise<number> {\n    return Promise.reject(\"not supported\");\n  }\n\n  async getNetwork(): Promise<NetworkInfo> {\n    const rpcResponse = await this.client.netInfo();\n    return adaptNetInfoResponse(rpcResponse);\n  }\n\n  async getAccountSequence(address: string, height?: number): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractSequenceFromResponse(abciResponse.response.ResponseBase.Data);\n  }\n\n  async getAccountNumber(address: string, height?: number): Promise<number> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractAccountNumberFromResponse(\n      abciResponse.response.ResponseBase.Data,\n    );\n  }\n\n  async getAccount(address: string, height?: number): Promise<ABCIAccount> {\n    const rpcResponse = await this.client.abciQuery({\n      path: `auth/accounts/${address}`,\n      data: new Uint8Array(),\n      height: height ? height : 0,\n      prove: false,\n    });\n\n    const abciResponse: ABCIResponse = adaptAbciQueryResponse(rpcResponse);\n    return extractAccountFromResponse(abciResponse.response.ResponseBase.Data);\n  }\n\n  async getStatus(): Promise<Status> {\n    const rpcResponse = await this.client.status();\n    return adaptStatusResponse(rpcResponse);\n  }\n\n  async getTransaction(hash: string): Promise<TxResult> {\n    const hashBytes = Uint8Array.from(\n      (hash.match(/.{1,2}/g) ?? []).map(byte => parseInt(byte, 16)),\n    );\n    const rpcResponse = await this.client.tx({\n      hash: hashBytes,\n    });\n    return adaptTxResponse(rpcResponse);\n  }\n\n  async sendTransaction<K extends keyof BroadcastTransactionMap>(\n    tx: string,\n    endpoint: K,\n  ): Promise<BroadcastTransactionMap[K][\"result\"]> {\n    const txBytes = Uint8Array.from(Buffer.from(tx, \"base64\"));\n\n    switch (endpoint) {\n      case TransactionEndpoint.BROADCAST_TX_COMMIT:\n        return this.broadcastTxCommit(txBytes);\n      case TransactionEndpoint.BROADCAST_TX_SYNC:\n      default:\n        return this.broadcastTxSync(txBytes);\n    }\n  }\n\n  private async broadcastTxSync(\n    txBytes: Uint8Array,\n  ): Promise<BroadcastTxSyncResult> {\n    const rpcResponse = await this.client.broadcastTxSync({\n      tx: txBytes,\n    });\n    const response = adaptBroadcastTxSyncResponse(rpcResponse);\n\n    if (response.error) {\n      const errType: string = response.error[ABCIErrorKey];\n      const log: string = response.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    return response;\n  }\n\n  private async broadcastTxCommit(\n    txBytes: Uint8Array,\n  ): Promise<BroadcastTxCommitResult> {\n    const rpcResponse = await this.client.broadcastTxCommit({\n      tx: txBytes,\n    });\n    const response = adaptBroadcastTxCommitResponse(rpcResponse);\n\n    const {\n      check_tx, deliver_tx,\n    } = response;\n\n    if (check_tx.ResponseBase.Error) {\n      const errType: string = check_tx.ResponseBase.Error[ABCIErrorKey];\n      const log: string = check_tx.ResponseBase.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    if (deliver_tx.ResponseBase.Error) {\n      const errType: string = deliver_tx.ResponseBase.Error[ABCIErrorKey];\n      const log: string = deliver_tx.ResponseBase.Log;\n\n      throw constructRequestError(errType, log);\n    }\n\n    return response;\n  }\n\n  async waitForTransaction(\n    hash: string,\n    fromHeight?: number,\n    timeout?: number,\n  ): Promise<Tx> {\n    return waitForTransaction(this, hash, fromHeight, timeout);\n  }\n}\n"],"mappings":"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"}

package/dist/provider/types/abci.cjs

@@ -0,0 +1,6 @@
+//#region src/provider/types/abci.ts
+const ABCIErrorKey = "@type";
+//#endregion
+exports.ABCIErrorKey = ABCIErrorKey;
+
+//# sourceMappingURL=abci.cjs.map

package/dist/provider/types/abci.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abci.cjs","names":[],"sources":["../../../src/provider/types/abci.ts"],"sourcesContent":["export interface ABCIResponse {\n  response: {\n    ResponseBase: ABCIResponseBase\n    Key: string | null\n    Value: string | null\n    Proof: MerkleProof | null\n    Height: string\n  }\n}\n\nexport interface ABCIResponseBase {\n  Error: {\n    // ABCIErrorKey\n    [key: string]: string\n  } | null\n  Data: string | null\n  Events: string | null\n  Log: string\n  Info: string\n}\n\ninterface MerkleProof {\n  ops: {\n    type: string\n    key: string | null\n    data: string | null\n  }[]\n}\n\nexport interface ABCIAccount {\n  BaseAccount: {\n    // the associated account address\n    address: string\n    // the balance list\n    coins: string\n    // the public key info\n    public_key: {\n      // type of public key\n      \"@type\": string\n      // public key value\n      value: string\n    } | null\n    // the account number (state-dependent) (decimal)\n    account_number: string\n    // the account sequence / nonce (decimal)\n    sequence: string\n  }\n}\n\nexport const ABCIErrorKey = \"@type\";\n"],"mappings":";AAiDA,MAAa,eAAe"}

package/dist/provider/types/abci.d.cts

@@ -0,0 +1,42 @@
+//#region src/provider/types/abci.d.ts
+interface ABCIResponse {
+  response: {
+    ResponseBase: ABCIResponseBase;
+    Key: string | null;
+    Value: string | null;
+    Proof: MerkleProof | null;
+    Height: string;
+  };
+}
+interface ABCIResponseBase {
+  Error: {
+    [key: string]: string;
+  } | null;
+  Data: string | null;
+  Events: string | null;
+  Log: string;
+  Info: string;
+}
+interface MerkleProof {
+  ops: {
+    type: string;
+    key: string | null;
+    data: string | null;
+  }[];
+}
+interface ABCIAccount {
+  BaseAccount: {
+    address: string;
+    coins: string;
+    public_key: {
+      "@type": string;
+      value: string;
+    } | null;
+    account_number: string;
+    sequence: string;
+  };
+}
+declare const ABCIErrorKey = "@type";
+//#endregion
+export { ABCIAccount, ABCIErrorKey, ABCIResponse, ABCIResponseBase };
+//# sourceMappingURL=abci.d.cts.map

package/dist/provider/types/abci.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abci.d.cts","names":[],"sources":["../../../src/provider/types/abci.ts"],"mappings":";UAAiB,YAAA;EACf,QAAA;IACE,YAAA,EAAc,gBAAA;IACd,GAAA;IACA,KAAA;IACA,KAAA,EAAO,WAAA;IACP,MAAA;EAAA;AAAA;AAAA,UAIa,gBAAA;EACf,KAAA;IAAA,CAEG,GAAA;EAAA;EAEH,IAAA;EACA,MAAA;EACA,GAAA;EACA,IAAA;AAAA;AAAA,UAGQ,WAAA;EACR,GAAA;IACE,IAAA;IACA,GAAA;IACA,IAAA;EAAA;AAAA;AAAA,UAIa,WAAA;EACf,WAAA;IAEE,OAAA;IAEA,KAAA;IAEA,UAAA;MAEE,OAAA;MAEA,KAAA;IAAA;IAGF,cAAA;IAEA,QAAA;EAAA;AAAA;AAAA,cAIS,YAAA"}

package/dist/provider/types/abci.d.mts

@@ -0,0 +1,42 @@
+//#region src/provider/types/abci.d.ts
+interface ABCIResponse {
+  response: {
+    ResponseBase: ABCIResponseBase;
+    Key: string | null;
+    Value: string | null;
+    Proof: MerkleProof | null;
+    Height: string;
+  };
+}
+interface ABCIResponseBase {
+  Error: {
+    [key: string]: string;
+  } | null;
+  Data: string | null;
+  Events: string | null;
+  Log: string;
+  Info: string;
+}
+interface MerkleProof {
+  ops: {
+    type: string;
+    key: string | null;
+    data: string | null;
+  }[];
+}
+interface ABCIAccount {
+  BaseAccount: {
+    address: string;
+    coins: string;
+    public_key: {
+      "@type": string;
+      value: string;
+    } | null;
+    account_number: string;
+    sequence: string;
+  };
+}
+declare const ABCIErrorKey = "@type";
+//#endregion
+export { ABCIAccount, ABCIErrorKey, ABCIResponse, ABCIResponseBase };
+//# sourceMappingURL=abci.d.mts.map

package/dist/provider/types/abci.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abci.d.mts","names":[],"sources":["../../../src/provider/types/abci.ts"],"mappings":";UAAiB,YAAA;EACf,QAAA;IACE,YAAA,EAAc,gBAAA;IACd,GAAA;IACA,KAAA;IACA,KAAA,EAAO,WAAA;IACP,MAAA;EAAA;AAAA;AAAA,UAIa,gBAAA;EACf,KAAA;IAAA,CAEG,GAAA;EAAA;EAEH,IAAA;EACA,MAAA;EACA,GAAA;EACA,IAAA;AAAA;AAAA,UAGQ,WAAA;EACR,GAAA;IACE,IAAA;IACA,GAAA;IACA,IAAA;EAAA;AAAA;AAAA,UAIa,WAAA;EACf,WAAA;IAEE,OAAA;IAEA,KAAA;IAEA,UAAA;MAEE,OAAA;MAEA,KAAA;IAAA;IAGF,cAAA;IAEA,QAAA;EAAA;AAAA;AAAA,cAIS,YAAA"}

package/dist/provider/types/abci.mjs

@@ -0,0 +1,6 @@
+//#region src/provider/types/abci.ts
+const ABCIErrorKey = "@type";
+//#endregion
+export { ABCIErrorKey };
+
+//# sourceMappingURL=abci.mjs.map

package/dist/provider/types/abci.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abci.mjs","names":[],"sources":["../../../src/provider/types/abci.ts"],"sourcesContent":["export interface ABCIResponse {\n  response: {\n    ResponseBase: ABCIResponseBase\n    Key: string | null\n    Value: string | null\n    Proof: MerkleProof | null\n    Height: string\n  }\n}\n\nexport interface ABCIResponseBase {\n  Error: {\n    // ABCIErrorKey\n    [key: string]: string\n  } | null\n  Data: string | null\n  Events: string | null\n  Log: string\n  Info: string\n}\n\ninterface MerkleProof {\n  ops: {\n    type: string\n    key: string | null\n    data: string | null\n  }[]\n}\n\nexport interface ABCIAccount {\n  BaseAccount: {\n    // the associated account address\n    address: string\n    // the balance list\n    coins: string\n    // the public key info\n    public_key: {\n      // type of public key\n      \"@type\": string\n      // public key value\n      value: string\n    } | null\n    // the account number (state-dependent) (decimal)\n    account_number: string\n    // the account sequence / nonce (decimal)\n    sequence: string\n  }\n}\n\nexport const ABCIErrorKey = \"@type\";\n"],"mappings":";AAiDA,MAAa,eAAe"}