@hiero-ledger/sdk 2.70.0 → 2.71.0

package/README.md

@@ -16,7 +16,7 @@
 
 ## Install
 
-**NOTE**: v1 of the SDK is deprecated and support will be discontinued after October 2021. Please install the latest version 2.x or migrate from v1 to the latest 2.x version. You can reference the [migration documentation](/MIGRATING_V1.md).
+**NOTE**: v1 of the SDK is deprecated and support will be discontinued after October 2021. Please install the latest version 2.x or migrate from v1 to the latest 2.x version. You can reference the [migration documentation](./manual//MIGRATING_V1.md).
 
 ```
 # with NPM
@@ -103,7 +103,7 @@ Then, rebuild the iOS project.
 ⚠️ ✅ Hiero Javascript SDK Version 2.59 and Below
 For projects using SDK version 2.59 and below, Expo SDK Version 49 and below is supported, keep in mind that the SDK uses some functionalities provided from ethers/ethersproject and there is an issue using parts of ethers.js in this environment. A [shims](https://www.npmjs.com/package/@ethersproject/shims) package has to be installed and imported before importing the SDK in your project.
 
-- Useful information: [here](https://github.com/ethers-io/ethers.js/discussions/3652) and [here](https://docs.ethers.org/v5/cookbook/react-native/)
+-   Useful information: [here](https://github.com/ethers-io/ethers.js/discussions/3652) and [here](https://docs.ethers.org/v5/cookbook/react-native/)
 
 ```bash
 npm install @ethersproject/shims
@@ -124,7 +124,7 @@ import {
 
 The Hiero JavaScript SDK does not currently support the following:
 
-- React Native Bare
+-   React Native Bare
 
 ## Usage
 
@@ -139,7 +139,7 @@ Every example can be executed using the following command from the root director
 
 ## Configuration
 
-For detailed information on configuring the SDK, including environment variables and client settings, please refer to the [CONFIGURATION.md](CONFIGURATION.md) file.
+For detailed information on configuring the SDK, including environment variables and client settings, please refer to the [CONFIGURATION.md](./manual/CONFIGURATION.md) file.
 
 ## Start tests
 

package/dist/umd.js

@@ -36822,6 +36822,26 @@
    */
   function decode$2(text) {
       const str = text.startsWith("0x") ? text.substring(2) : text;
+
+      if (str.length % 2 !== 0) {
+          throw new Error(
+              "Invalid hex string: Must have an even number of characters.",
+          );
+      }
+
+      if (/[^0-9a-fA-F]/.test(str)) {
+          throw new Error(
+              "Invalid hex string: Contains non-hexadecimal characters.",
+          );
+      }
+
+      const bytes = new Uint8Array(str.length / 2);
+
+      for (let i = 0; i < str.length; i += 2) {
+          const byte = parseInt(str.substring(i, i + 2), 16);
+          bytes[i / 2] = byte;
+      }
+
       return Buffer.from(str, "hex");
   }
 
@@ -64059,11 +64079,11 @@
               case "3":
                   return LedgerId.LOCAL_NODE;
               default: {
-                  let ledgerIdDecoded = decode$8(ledgerId);
-                  if (ledgerIdDecoded.length == 0 && ledgerId.length != 0) {
-                      throw new Error("Default reached for fromString");
-                  } else {
+                  try {
+                      let ledgerIdDecoded = decode$8(ledgerId);
                       return new LedgerId(ledgerIdDecoded);
+                  } catch (error) {
+                      throw new Error("Default reached for fromString");
                   }
               }
           }
@@ -71937,7 +71957,9 @@
       setGas(gas) {
           this._requireNotFrozen();
           this._gas = gas instanceof Long ? gas : Long.fromValue(gas);
-
+          if (this._gas.lessThan(0)) {
+              throw new Error("Gas cannot be negative number");
+          }
           return this;
       }
 
@@ -72085,7 +72107,7 @@
               typeof stakedAccountId === "string"
                   ? AccountId.fromString(stakedAccountId)
                   : stakedAccountId;
-
+          this._stakedNodeId = null;
           return this;
       }
 
@@ -72103,7 +72125,7 @@
       setStakedNodeId(stakedNodeId) {
           this._requireNotFrozen();
           this._stakedNodeId = Long.fromValue(stakedNodeId);
-
+          this._stakedAccountId = null;
           return this;
       }
 
@@ -72832,6 +72854,7 @@
        * @param {ContractId | string} [props.contractId]
        * @param {ContractId | string} [props.transferContractId]
        * @param {AccountId | string} [props.transferAccountId]
+       * @param {boolean} [props.permanentRemoval]
        */
       constructor(props = {}) {
           super();
@@ -72854,6 +72877,12 @@
            */
           this._transferContractId = null;
 
+          /**
+           * @private
+           * @type {boolean}
+           */
+          this._permanentRemoval = false;
+
           if (props.contractId != null) {
               this.setContractId(props.contractId);
           }
@@ -72865,6 +72894,10 @@
           if (props.transferContractId != null) {
               this.setTransferContractId(props.transferContractId);
           }
+
+          if (props.permanentRemoval != null) {
+              this.setPermanentRemoval(props.permanentRemoval);
+          }
       }
 
       /**
@@ -72915,6 +72948,7 @@
                                 ),
                             )
                           : undefined,
+                  permanentRemoval: contractDelete.permanentRemoval ?? false,
               }),
               transactions,
               signedTransactions,
@@ -72966,6 +73000,7 @@
               transferContractId instanceof ContractId
                   ? transferContractId
                   : ContractId.fromString(transferContractId);
+          this._transferAccountId = null;
 
           return this;
       }
@@ -72989,7 +73024,27 @@
               transferAccountId instanceof AccountId
                   ? transferAccountId
                   : AccountId.fromString(transferAccountId);
+          this._transferContractId = null;
+
+          return this;
+      }
+
+      /**
+       * @returns {boolean}
+       */
+      get permanentRemoval() {
+          return this._permanentRemoval;
+      }
 
+      /**
+       * Sets the permanent removal flag.
+       *
+       * @param {boolean} permanentRemoval
+       * @returns {ContractDeleteTransaction}
+       */
+      setPermanentRemoval(permanentRemoval) {
+          this._requireNotFrozen();
+          this._permanentRemoval = permanentRemoval;
           return this;
       }
 
@@ -73048,6 +73103,7 @@
                   this._transferContractId != null
                       ? this._transferContractId._toProtobuf()
                       : null,
+              permanentRemoval: this._permanentRemoval,
           };
       }
 
@@ -73404,6 +73460,7 @@
        * @param {TokenRelationshipMap} props.tokenRelationships
        * @param {LedgerId|null} props.ledgerId
        * @param {?StakingInfo} props.stakingInfo
+       * @param {Long} props.maxAutomaticTokenAssociations
        */
       constructor(props) {
           /**
@@ -73502,6 +73559,13 @@
            */
           this.tokenRelationships = props.tokenRelationships;
 
+          /**
+           * The maximum number of automatic token associations allowed for this contract.
+           * @readonly
+           */
+          this.maxAutomaticTokenAssociations =
+              props.maxAutomaticTokenAssociations;
+
           /**
            * The ledger ID the response was returned from; please see <a href="https://github.com/hashgraph/hedera-improvement-proposal/blob/master/HIP/hip-198.md">HIP-198</a> for the network-specific IDs.
            */
@@ -73569,6 +73633,12 @@
                   info.stakingInfo != null
                       ? StakingInfo._fromProtobuf(info.stakingInfo)
                       : null,
+              maxAutomaticTokenAssociations:
+                  info.maxAutomaticTokenAssociations != null
+                      ? Long.isLong(info.maxAutomaticTokenAssociations)
+                          ? info.maxAutomaticTokenAssociations
+                          : Long.fromValue(info.maxAutomaticTokenAssociations)
+                      : Long.ZERO,
           });
       }
 
@@ -73605,6 +73675,8 @@
                   this.stakingInfo != null
                       ? this.stakingInfo._toProtobuf()
                       : null,
+              maxAutomaticTokenAssociations:
+                  this.maxAutomaticTokenAssociations.toNumber(),
           };
       }
 
@@ -74448,7 +74520,9 @@
                       : null,
               autoRenewAccountId:
                   this._autoRenewAccountId != null
-                      ? this._autoRenewAccountId._toProtobuf()
+                      ? this._autoRenewAccountId.toString() == "0.0.0"
+                          ? libExports.proto.AccountID.create()
+                          : this._autoRenewAccountId._toProtobuf()
                       : null,
           };
       }
@@ -96134,7 +96208,7 @@
   /**
    * @augments {ManagedNetwork<Channel, Node, AccountId>}
    */
-  let Network$1 = class Network extends ManagedNetwork {
+  class Network extends ManagedNetwork {
       /**
        * @param {(address: string) => Channel} createNetworkChannel
        */
@@ -96418,7 +96492,7 @@
               this.getNumberOfNodesForTransaction(),
           ).map((node) => node.accountId);
       }
-  };
+  }
 
   // SPDX-License-Identifier: Apache-2.0
 
@@ -96601,14 +96675,6 @@
       "previewnet-node06-00-grpc.hedera.com:443": new AccountId(9),
   };
 
-  ({
-      "testnet-node00-00-grpc.hedera.com:443": new AccountId(3),
-  });
-
-  ({
-      "previewnet-node00-00-grpc.hedera.com:443": new AccountId(3),
-  });
-
   /**
    * @type {Record<string, AccountId>}
    */
@@ -96625,6 +96691,12 @@
       LOCAL_NODE: ["127.0.0.1:5600"],
   };
 
+  const WebNetwork = {
+      MAINNET: MAINNET,
+      TESTNET: WEB_TESTNET,
+      PREVIEWNET: WEB_PREVIEWNET,
+  };
+
   // SPDX-License-Identifier: Apache-2.0
 
 
@@ -97073,7 +97145,7 @@
            * @internal
            * @type {Network}
            */
-          this._network = new Network$1(this._createNetworkChannel());
+          this._network = new Network(this._createNetworkChannel());
 
           /**
            * @internal
@@ -97725,11 +97797,11 @@
 
       /**
        * Update the network address book.
-       * @returns {Promise<void>}
+       * @returns {Promise<this>}
        */
       async updateNetwork() {
           if (this._isUpdatingNetwork) {
-              return;
+              return this;
           }
 
           this._isUpdatingNetwork = true;
@@ -97752,6 +97824,8 @@
           } finally {
               this._isUpdatingNetwork = false;
           }
+
+          return this;
       }
 
       /**
@@ -97866,7 +97940,7 @@
 
   const SDK_NAME = "hiero-sdk-js";
   const SDK_VERSION =
-      "2.70.0" ;
+      "2.71.0" ;
 
   // SPDX-License-Identifier: Apache-2.0
 
@@ -98309,12 +98383,6 @@
    * @typedef {import("../account/AccountId.js").default} AccountId
    */
 
-  const Network = {
-      MAINNET: MAINNET,
-      TESTNET: WEB_TESTNET,
-      PREVIEWNET: WEB_PREVIEWNET,
-  };
-
   /**
    * Represents a client for interacting with the Hedera network over the web.
    * The `WebClient` class extends the base `Client` class and provides methods
@@ -98333,19 +98401,19 @@
               if (typeof props.network === "string") {
                   switch (props.network) {
                       case "mainnet":
-                          this.setNetwork(Network.MAINNET);
-                          this.setMirrorNetwork(MirrorNetwork.MAINNET);
+                          this.setNetwork(WebNetwork.MAINNET);
                           this.setLedgerId(LedgerId.MAINNET);
+                          this.setMirrorNetwork(MirrorNetwork.MAINNET);
                           break;
 
                       case "testnet":
-                          this.setNetwork(Network.TESTNET);
+                          this.setNetwork(WebNetwork.TESTNET);
                           this.setLedgerId(LedgerId.TESTNET);
                           this.setMirrorNetwork(MirrorNetwork.TESTNET);
                           break;
 
                       case "previewnet":
-                          this.setNetwork(Network.PREVIEWNET);
+                          this.setNetwork(WebNetwork.PREVIEWNET);
                           this.setLedgerId(LedgerId.PREVIEWNET);
                           this.setMirrorNetwork(MirrorNetwork.PREVIEWNET);
                           break;
@@ -98445,6 +98513,56 @@
           });
       }
 
+      /**
+       * Construct a Hedera client pre-configured for Mainnet access with network update.
+       *
+       * @returns {Promise<WebClient>}
+       */
+      static async forMainnetAsync() {
+          return new WebClient({
+              network: "mainnet",
+          }).updateNetwork();
+      }
+
+      /**
+       * Construct a Hedera client pre-configured for Testnet access with network update.
+       *
+       * @returns {Promise<WebClient>}
+       */
+      static async forTestnetAsync() {
+          return new WebClient({
+              network: "testnet",
+          }).updateNetwork();
+      }
+
+      /**
+       * Construct a Hedera client pre-configured for Previewnet access with network update.
+       *
+       * @returns {Promise<WebClient>}
+       */
+      static async forPreviewnetAsync() {
+          return new WebClient({
+              network: "previewnet",
+          }).updateNetwork();
+      }
+
+      /**
+       * Construct a client for a specific network with optional network update.
+       * Updates network only if the network is not "local-node".
+       *
+       * @param {string} network
+       * @returns {Promise<WebClient>}
+       */
+      static async forNameAsync(network) {
+          const client = new WebClient({ network });
+
+          if (network !== "local-node") {
+              await client.updateNetwork();
+          }
+
+          return client;
+      }
+
       /**
        * Construct a client configured to use mirror nodes.
        * This will query the address book to get the network nodes.
@@ -98453,9 +98571,7 @@
        * @returns {Promise<WebClient>}
        */
       static async forMirrorNetwork(mirrorNetwork) {
-          const client = new WebClient();
-
-          client.setMirrorNetwork(mirrorNetwork);
+          const client = new WebClient({ mirrorNetwork: mirrorNetwork });
 
           await client.updateNetwork();
 
@@ -98470,13 +98586,13 @@
           if (typeof network === "string") {
               switch (network) {
                   case "previewnet":
-                      this._network.setNetwork(Network.PREVIEWNET);
+                      this._network.setNetwork(WebNetwork.PREVIEWNET);
                       break;
                   case "testnet":
-                      this._network.setNetwork(Network.TESTNET);
+                      this._network.setNetwork(WebNetwork.TESTNET);
                       break;
                   case "mainnet":
-                      this._network.setNetwork(Network.MAINNET);
+                      this._network.setNetwork(WebNetwork.MAINNET);
               }
           } else {
               this._network.setNetwork(network);
@@ -98514,11 +98630,11 @@
 
       /**
        * @override
-       * @returns {Promise<void>}
+       * @returns {Promise<this>}
        */
       async updateNetwork() {
           if (this._isUpdatingNetwork) {
-              return;
+              return this;
           }
 
           this._isUpdatingNetwork = true;
@@ -98552,6 +98668,8 @@
           } finally {
               this._isUpdatingNetwork = false;
           }
+
+          return this;
       }
 
       /**