@hiero-ledger/sdk 2.71.0-beta.0 → 2.71.0

package/src/client/WebClient.js

@@ -3,12 +3,7 @@
 import Client from "./Client.js";
 import WebChannel from "../channel/WebChannel.js";
 import LedgerId from "../LedgerId.js";
-import {
-    MAINNET,
-    WEB_TESTNET,
-    WEB_PREVIEWNET,
-    MirrorNetwork,
-} from "../constants/ClientConstants.js";
+import { WebNetwork, MirrorNetwork } from "../constants/ClientConstants.js";
 import AddressBookQuery from "../network/AddressBookQueryWeb.js";
 import FileId from "../file/FileId.js";
 
@@ -17,32 +12,6 @@ import FileId from "../file/FileId.js";
  * @typedef {import("../account/AccountId.js").default} AccountId
  */
 
-export const Network = {
-    /**
-     * @param {string} name
-     * @returns {{[key: string]: (string | AccountId)}}
-     */
-    fromName(name) {
-        switch (name) {
-            case "mainnet":
-                return Network.MAINNET;
-
-            case "testnet":
-                return Network.TESTNET;
-
-            case "previewnet":
-                return Network.PREVIEWNET;
-
-            default:
-                throw new Error(`unknown network name: ${name}`);
-        }
-    },
-
-    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
@@ -61,19 +30,19 @@ export default class WebClient extends Client {
             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;
@@ -173,6 +142,56 @@ export default class WebClient extends Client {
         });
     }
 
+    /**
+     * 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.
@@ -181,9 +200,7 @@ export default class WebClient extends Client {
      * @returns {Promise<WebClient>}
      */
     static async forMirrorNetwork(mirrorNetwork) {
-        const client = new WebClient();
-
-        client.setMirrorNetwork(mirrorNetwork);
+        const client = new WebClient({ mirrorNetwork: mirrorNetwork });
 
         await client.updateNetwork();
 
@@ -198,13 +215,13 @@ export default class WebClient extends Client {
         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);
@@ -242,11 +259,11 @@ export default class WebClient extends Client {
 
     /**
      * @override
-     * @returns {Promise<void>}
+     * @returns {Promise<this>}
      */
     async updateNetwork() {
         if (this._isUpdatingNetwork) {
-            return;
+            return this;
         }
 
         this._isUpdatingNetwork = true;
@@ -280,6 +297,8 @@ export default class WebClient extends Client {
         } finally {
             this._isUpdatingNetwork = false;
         }
+
+        return this;
     }
 
     /**

package/src/constants/ClientConstants.js

@@ -53,14 +53,6 @@ export const WEB_PREVIEWNET = {
     "previewnet-node06-00-grpc.hedera.com:443": new AccountId(9),
 };
 
-export const NATIVE_TESTNET = {
-    "testnet-node00-00-grpc.hedera.com:443": new AccountId(3),
-};
-
-export const NATIVE_PREVIEWNET = {
-    "previewnet-node00-00-grpc.hedera.com:443": new AccountId(3),
-};
-
 /**
  * @type {Record<string, AccountId>}
  */
@@ -202,3 +194,29 @@ export const MirrorNetwork = {
     PREVIEWNET: ["previewnet.mirrornode.hedera.com:443"],
     LOCAL_NODE: ["127.0.0.1:5600"],
 };
+
+export const WebNetwork = {
+    /**
+     * @param {string} name
+     * @returns {{[key: string]: (string | AccountId)}}
+     */
+    fromName(name) {
+        switch (name) {
+            case "mainnet":
+                return WebNetwork.MAINNET;
+
+            case "testnet":
+                return WebNetwork.TESTNET;
+
+            case "previewnet":
+                return WebNetwork.PREVIEWNET;
+
+            default:
+                throw new Error(`unknown network name: ${name}`);
+        }
+    },
+
+    MAINNET: MAINNET,
+    TESTNET: WEB_TESTNET,
+    PREVIEWNET: WEB_PREVIEWNET,
+};

package/src/contract/ContractCreateTransaction.js

@@ -377,7 +377,9 @@ export default class ContractCreateTransaction extends Transaction {
     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;
     }
 
@@ -525,7 +527,7 @@ export default class ContractCreateTransaction extends Transaction {
             typeof stakedAccountId === "string"
                 ? AccountId.fromString(stakedAccountId)
                 : stakedAccountId;
-
+        this._stakedNodeId = null;
         return this;
     }
 
@@ -543,7 +545,7 @@ export default class ContractCreateTransaction extends Transaction {
     setStakedNodeId(stakedNodeId) {
         this._requireNotFrozen();
         this._stakedNodeId = Long.fromValue(stakedNodeId);
-
+        this._stakedAccountId = null;
         return this;
     }
 

package/src/contract/ContractDeleteTransaction.js

@@ -54,6 +54,7 @@ export default class ContractDeleteTransaction extends Transaction {
      * @param {ContractId | string} [props.contractId]
      * @param {ContractId | string} [props.transferContractId]
      * @param {AccountId | string} [props.transferAccountId]
+     * @param {boolean} [props.permanentRemoval]
      */
     constructor(props = {}) {
         super();
@@ -76,6 +77,12 @@ export default class ContractDeleteTransaction extends Transaction {
          */
         this._transferContractId = null;
 
+        /**
+         * @private
+         * @type {boolean}
+         */
+        this._permanentRemoval = false;
+
         if (props.contractId != null) {
             this.setContractId(props.contractId);
         }
@@ -87,6 +94,10 @@ export default class ContractDeleteTransaction extends Transaction {
         if (props.transferContractId != null) {
             this.setTransferContractId(props.transferContractId);
         }
+
+        if (props.permanentRemoval != null) {
+            this.setPermanentRemoval(props.permanentRemoval);
+        }
     }
 
     /**
@@ -137,6 +148,7 @@ export default class ContractDeleteTransaction extends Transaction {
                               ),
                           )
                         : undefined,
+                permanentRemoval: contractDelete.permanentRemoval ?? false,
             }),
             transactions,
             signedTransactions,
@@ -188,6 +200,7 @@ export default class ContractDeleteTransaction extends Transaction {
             transferContractId instanceof ContractId
                 ? transferContractId
                 : ContractId.fromString(transferContractId);
+        this._transferAccountId = null;
 
         return this;
     }
@@ -211,7 +224,27 @@ export default class ContractDeleteTransaction extends Transaction {
             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;
     }
 
@@ -270,6 +303,7 @@ export default class ContractDeleteTransaction extends Transaction {
                 this._transferContractId != null
                     ? this._transferContractId._toProtobuf()
                     : null,
+            permanentRemoval: this._permanentRemoval,
         };
     }
 

package/src/contract/ContractUpdateTransaction.js

@@ -10,6 +10,7 @@ import Duration from "../Duration.js";
 import Timestamp from "../Timestamp.js";
 import Key from "../Key.js";
 import Long from "long";
+import * as Proto from "@hashgraph/proto";
 
 /**
  * @namespace proto
@@ -642,7 +643,9 @@ export default class ContractUpdateTransaction extends Transaction {
                     : null,
             autoRenewAccountId:
                 this._autoRenewAccountId != null
-                    ? this._autoRenewAccountId._toProtobuf()
+                    ? this._autoRenewAccountId.toString() == "0.0.0"
+                        ? Proto.proto.AccountID.create()
+                        : this._autoRenewAccountId._toProtobuf()
                     : null,
         };
     }

package/src/encoding/hex.js

@@ -14,6 +14,26 @@ export function encode(data) {
  */
 export function decode(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");
 }
 

package/src/native.js

@@ -7,4 +7,4 @@
 export * from "./exports.js";
 
 export { default as Client } from "./client/NativeClient.js";
-export { default as AddressBookQuery } from "./network/AddressBookQuery.js";
+export { default as AddressBookQuery } from "./network/AddressBookQueryWeb.js";