quantumcoin 7.0.11 → 7.0.12

package/examples/node_modules/quantum-coin-js-sdk/index.js

@@ -56,6 +56,7 @@ const BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA = 64;
 const MIN_PASSPHRASE_LENGTH = 12;
 const INVALID_KEY_TYPE = -1001;
 const CIRCL_CRYPTO_FAILURE = -1002;
+const EXPECTED_WASM_SHA256 = "bcab6389db37af9cc6538fb54a872f416131392d3ad5ea23a0969d8aac3b1c85";
 
 /**
  * @class
@@ -122,9 +123,10 @@ class Wallet {
      * Creates a Wallet class. The constructor does not verify the wallet. To verify a wallet, call the verifyWallet function explicitly.
      * @param {string} address - Address of the wallet
      * @param {number[]} privateKey - Private Key byte array of the wallet
-     * @param {number[]} publicKey - The chain id of the blockchain. Mainnet chainId is 123123. Testnet T4 chainId is 310324.
+     * @param {number[]} publicKey - Public Key byte array of the wallet
+     * @param {Uint8Array|number[]|null} [preExpansionSeed=null] - Optional pre-expansion seed bytes. Non-null only for seed-derived wallets.
      */
-    constructor(address, privateKey, publicKey) {
+    constructor(address, privateKey, publicKey, preExpansionSeed) {
 
         /**
          * Address of the wallet. Is 66 bytes in length including 0x (if the wallet is valid).
@@ -146,6 +148,13 @@ class Wallet {
          * @public
         */
         this.publicKey = publicKey;
+
+        /**
+         * Pre-expansion seed bytes. Can be null if the wallet was not created from a seed.
+         * @type {Uint8Array|number[]|null}
+         * @public
+        */
+        this.preExpansionSeed = preExpansionSeed || null;
     }
 }
 
@@ -841,6 +850,10 @@ function isLargeNumber(val) {
     return false;
 }
 
+function getGlobalObject() {
+    return (typeof globalThis !== 'undefined' ? globalThis : typeof global !== 'undefined' ? global : typeof window !== 'undefined' ? window : this);
+}
+
 async function InitAccountsWebAssembly() {
     const go = new global.Go();
     let mod, inst;
@@ -851,14 +864,75 @@ async function InitAccountsWebAssembly() {
         throw new Error("Error parsing base64");
     }
     const wasmBytes = Uint8Array.from(atob(base64wasm), c => c.charCodeAt(0));
+
+    const hashHex = crypto.createHash('sha256').update(wasmBytes).digest('hex');
+    if (hashHex !== EXPECTED_WASM_SHA256) {
+        throw new Error("WASM integrity check failed");
+    }
+
+    const g = getGlobalObject();
+    if (g) {
+        delete g.circl;
+    }
+
     let result = await WebAssembly.instantiate(wasmBytes, go.importObject);
     mod = result.module;
     inst = result.instance;
     go.run(inst);
-    const g = (typeof globalThis !== 'undefined' ? globalThis : typeof global !== 'undefined' ? global : typeof window !== 'undefined' ? window : this);
+
     if (g && g.circl) {
         circl = g.circl;
+        delete g.circl;
+        if (circl.hybridedmldsaslhdsa) Object.freeze(circl.hybridedmldsaslhdsa);
+        if (circl.hybridedmldsaslhdsa5) Object.freeze(circl.hybridedmldsaslhdsa5);
+        if (circl.hybridedmldsaslhds5) Object.freeze(circl.hybridedmldsaslhds5);
+        if (circl.hybrideds) Object.freeze(circl.hybrideds);
+        Object.freeze(circl);
+    }
+}
+
+function validateCryptoRandom() {
+    if (!circl || !circl.cryptoRandom) {
+        return false;
+    }
+
+    const sampleSize = 64;
+    const res1 = circl.cryptoRandom(sampleSize);
+    const res2 = circl.cryptoRandom(sampleSize);
+
+    if (!res1 || res1.error || !res1.result || res1.result.length !== sampleSize) {
+        return false;
+    }
+    if (!res2 || res2.error || !res2.result || res2.result.length !== sampleSize) {
+        return false;
+    }
+
+    const a = res1.result instanceof Uint8Array ? res1.result : new Uint8Array(res1.result);
+    const b = res2.result instanceof Uint8Array ? res2.result : new Uint8Array(res2.result);
+
+    let identical = true;
+    for (let i = 0; i < sampleSize; i++) {
+        if (a[i] !== b[i]) { identical = false; break; }
+    }
+    if (identical) {
+        return false;
+    }
+
+    let aAllZero = true, bAllZero = true;
+    for (let i = 0; i < sampleSize; i++) {
+        if (a[i] !== 0) aAllZero = false;
+        if (b[i] !== 0) bAllZero = false;
+    }
+    if (aAllZero || bAllZero) {
+        return false;
+    }
+
+    const seen = new Set(a);
+    if (seen.size < 48) {
+        return false;
     }
+
+    return true;
 }
 
 /**
@@ -879,7 +953,10 @@ async function initialize(clientConfig) {
     if (clientConfig.readUrl === null || clientConfig.writeUrl === null || clientConfig.chainId === null) {
         return false;
     }
-    await InitAccountsWebAssembly();    
+    await InitAccountsWebAssembly();
+    if (!validateCryptoRandom()) {
+        throw new Error("CSPRNG validation failed");
+    }
     config = clientConfig;
     isInitialized = await seedwords.initialize();
 
@@ -1004,13 +1081,13 @@ function newWallet(keyType) {
 }
 
 /**
- * The newWalletSeed function creates a new Wallet seed word list. The return array can then be passed to the openWalletFromSeedWords function to create a new wallet.
+ * The newWalletSeedWords function creates a new wallet seed word list. The returned array can then be passed to the openWalletFromSeedWords function to create a new wallet.
  *
- * @function newWalletSeed
+ * @function newWalletSeedWords
  * @param {number|null} keyType - Optional. KEY_TYPE_HYBRIDEDMLDSASLHDSA (3) or KEY_TYPE_HYBRIDEDMLDSASLHDSA5 (5). null/undefined defaults to 3.
- * @return {array|number|null} Returns an array of seed words (32 or 36 words). Returns -1000 if not initialized, null on failure.
+ * @return {string[]|number|null} Returns an array of seed words (32 or 36 words depending on keyType). Returns -1000 if not initialized, null on failure.
  */
-function newWalletSeed(keyType) {
+function newWalletSeedWords(keyType) {
     if (isInitialized === false) {
         return -1000;
     }
@@ -1046,7 +1123,7 @@ function newWalletSeed(keyType) {
  *
  * @function openWalletFromSeed
  * @param {Array<number>|Uint8Array} seedArray - The raw seed bytes. Length 96, 72, or 64 depending on scheme.
- * @return {Wallet|number} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
+ * @return {Wallet|number|null} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
  */
 function openWalletFromSeed(seedArray) {
     if (isInitialized === false) {
@@ -1092,7 +1169,7 @@ function openWalletFromSeed(seedArray) {
     const publicKey = keyPairRes.result.publicKey instanceof Uint8Array ? Array.from(keyPairRes.result.publicKey) : keyPairRes.result.publicKey;
     const privateKey = keyPairRes.result.privateKey instanceof Uint8Array ? Array.from(keyPairRes.result.privateKey) : keyPairRes.result.privateKey;
     const address = PublicKeyToAddress(publicKey);
-    return new Wallet(address, privateKey, publicKey);
+    return new Wallet(address, privateKey, publicKey, seedU8);
 }
 
 /**
@@ -1100,8 +1177,8 @@ function openWalletFromSeed(seedArray) {
  * Supports 48 words (hybrideds), 36 words (hybrid5), or 32 words (hybrid) per seed length.
  *
  * @function openWalletFromSeedWords
- * @param {array} seedWordList - An array of seed words. Length 48, 36, or 32 depending on scheme.
- * @return {Wallet|number} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
+ * @param {string[]} seedWordList - An array of seed words. Length 48, 36, or 32 depending on scheme.
+ * @return {Wallet|number|null} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
  */
 function openWalletFromSeedWords(seedWordList) {
     if (isInitialized === false) {
@@ -1115,7 +1192,7 @@ function openWalletFromSeedWords(seedWordList) {
         return null;
     }
     const seedArray = seedwords.getSeedArrayFromWordList(seedWordList);
-    if (seedArray == null || seedArray.length == null) {
+    if (seedArray == null || seedArray.length === undefined) {
         return null;
     }
     return openWalletFromSeed(seedArray);
@@ -1131,26 +1208,22 @@ function openWalletFromSeedWords(seedWordList) {
  */
 function deserializeEncryptedWallet(walletJsonString, passphrase) {
     if (isInitialized === false) {
-        console.error('deserializeEncryptedWallet: SDK not initialized');
         return -1000;
     }
 
     if (walletJsonString == null || passphrase == null) {
-        console.error('deserializeEncryptedWallet: walletJsonString or passphrase is null');
         return null;
     }
 
     if (typeof walletJsonString === 'string' || walletJsonString instanceof String) {
 
     } else {
-        console.error('deserializeEncryptedWallet: walletJsonString is not a string');
         return null;
     }
 
     if (typeof passphrase === 'string' || passphrase instanceof String) {
 
     } else {
-        console.error('deserializeEncryptedWallet: passphrase is not a string');
         return null;
     }
 
@@ -1158,54 +1231,50 @@ function deserializeEncryptedWallet(walletJsonString, passphrase) {
     try {
         walletJsonObj = JSON.parse(walletJsonString);
     } catch (e) {
-        console.error('deserializeEncryptedWallet: JSON parse failed', e.message);
         return null;
     }
 
     if (walletJsonObj == null) {
-        console.error('deserializeEncryptedWallet: parsed JSON is null');
         return null;
     }
 
     if (walletJsonObj.address == null) {
-        console.error('deserializeEncryptedWallet: wallet JSON missing address');
         return null;
     }
 
     let keyPairString = JsonToWalletKeyPair(walletJsonString, passphrase);
     if (keyPairString == null) {
-        console.error('deserializeEncryptedWallet: failed to derive key pair (wrong passphrase or invalid crypto)');
         return null;
     }
 
     let keyPairSplit = keyPairString.split(",");
     if (keyPairSplit.length < 2) {
-        console.error('deserializeEncryptedWallet: key pair format invalid');
         return null;
     }
 
     let privateKeyArray = base64ToBytes(keyPairSplit[0]);
     let publicKeyArray = base64ToBytes(keyPairSplit[1]);
+    let preExpansionSeed = null;
+    if (keyPairSplit.length >= 3 && keyPairSplit[2].length > 0) {
+        preExpansionSeed = base64ToBytes(keyPairSplit[2]);
+    }
     let address = PublicKeyToAddress(publicKeyArray);
     if (address == null) {
-        console.error('deserializeEncryptedWallet: failed to derive address from public key');
         return null;
     }
 
     if (typeof address === 'string' || address instanceof String) {
 
     } else {
-        console.error('deserializeEncryptedWallet: address is not a string');
         return null;
     }
 
     let addressCheck = "0x" + walletJsonObj.address.toLowerCase();
-    if (addressCheck != address.toLowerCase()) {
-        console.error('deserializeEncryptedWallet: address mismatch with wallet JSON');
+    if (addressCheck !== address.toLowerCase()) {
         return null;
     }
 
-    let wallet = new Wallet(address, privateKeyArray, publicKeyArray);
+    let wallet = new Wallet(address, privateKeyArray, publicKeyArray, preExpansionSeed);
 
     return wallet;
 }
@@ -1237,11 +1306,21 @@ function serializeEncryptedWallet(wallet, passphrase) {
         return null;
     }
 
-    let walletJsonString = KeyPairToWalletJson(wallet.privateKey, wallet.publicKey, passphrase);
+    let walletJsonString;
+    if (wallet.preExpansionSeed != null && wallet.preExpansionSeed.length > 0) {
+        const seedU8 = wallet.preExpansionSeed instanceof Uint8Array ? wallet.preExpansionSeed : new Uint8Array(wallet.preExpansionSeed);
+        const result = EncryptPreExpansionSeed(seedU8, passphrase);
+        if (result == null || result instanceof Error) {
+            return null;
+        }
+        walletJsonString = result;
+    } else {
+        walletJsonString = KeyPairToWalletJson(wallet.privateKey, wallet.publicKey, passphrase);
+    }
 
     let walletJson = JSON.parse(walletJsonString);
     let addressCheck = "0x" + walletJson.address;
-    if (addressCheck.toLowerCase() != wallet.address.toLowerCase()) {
+    if (addressCheck.toLowerCase() !== wallet.address.toLowerCase()) {
         return null;
     }
 
@@ -1319,43 +1398,34 @@ function isByteArray(array) {
  */
 function verifyWallet(wallet) {
     if (isInitialized === false) {
-        console.log('[verifyWallet] FAIL: not initialized');
         return -1000;
     }
     if (wallet === null || wallet.address === null || wallet.privateKey === null || wallet.publicKey === null) {
-        console.log('[verifyWallet] FAIL: wallet or wallet.address/privateKey/publicKey is null');
         return false;
     }
     if (isAddressValid(wallet.address) === false) {
-        console.log('[verifyWallet] FAIL: isAddressValid(wallet.address) === false');
         return false;
     }
     if (isByteArray(wallet.privateKey) === false) {
-        console.log('[verifyWallet] FAIL: isByteArray(wallet.privateKey) === false');
         return false;
     }
     if (isByteArray(wallet.publicKey) === false) {
-        console.log('[verifyWallet] FAIL: isByteArray(wallet.publicKey) === false');
         return false;
     }
     const keyType = getKeyTypeFromPrivateKey(wallet.privateKey);
     if (keyType == null) {
-        console.log('[verifyWallet] FAIL: getKeyTypeFromPrivateKey returned null (privateKey.length=' + wallet.privateKey.length + ', circl.hybridedmldsaslhdsa.PrivateKeySize=' + (circl && circl.hybridedmldsaslhdsa ? circl.hybridedmldsaslhdsa.PrivateKeySize : 'N/A') + ', hybrid5.PrivateKeySize=' + (circl && (circl.hybridedmldsaslhdsa5 || circl.hybridedmldsaslhds5) ? (circl.hybridedmldsaslhdsa5 || circl.hybridedmldsaslhds5).PrivateKeySize : 'N/A') + ')');
         return false;
     }
     const hybridNs = circl && circl.hybridedmldsaslhdsa;
     const hybrid5Ns = circl && (circl.hybridedmldsaslhdsa5 || circl.hybridedmldsaslhds5);
     if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA && hybridNs && wallet.privateKey.length !== hybridNs.PrivateKeySize) {
-        console.log('[verifyWallet] FAIL: keyType 3 but privateKey.length !== hybridNs.PrivateKeySize');
         return false;
     }
     if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA5 && hybrid5Ns && wallet.privateKey.length !== hybrid5Ns.PrivateKeySize) {
-        console.log('[verifyWallet] FAIL: keyType 5 but privateKey.length !== hybrid5Ns.PrivateKeySize');
         return false;
     }
     const address = PublicKeyToAddress(wallet.publicKey);
     if (address !== wallet.address) {
-        console.log('[verifyWallet] FAIL: PublicKeyToAddress(wallet.publicKey) !== wallet.address');
         return false;
     }
     const message = new TextEncoder().encode("verifyverifyverifyverifyverifyok");
@@ -1366,27 +1436,22 @@ function verifyWallet(wallet) {
     if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA && hybridNs) {
         sigRes = hybridNs.sign(privU8, message);
         if (sigRes && sigRes.error) {
-            console.log('[verifyWallet] FAIL: hybridNs.sign returned error:', sigRes.error);
             return false;
         }
         verRes = hybridNs.verify(pubU8, message, sigRes.result);
     } else if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA5 && hybrid5Ns) {
         sigRes = hybrid5Ns.sign(privU8, message);
         if (sigRes && sigRes.error) {
-            console.log('[verifyWallet] FAIL: hybrid5Ns.sign returned error:', sigRes.error);
             return false;
         }
         verRes = hybrid5Ns.verify(pubU8, message, sigRes.result);
     } else {
-        console.log('[verifyWallet] FAIL: no CIRCL namespace for keyType (keyType=' + keyType + ', hybridNs=' + !!hybridNs + ', hybrid5Ns=' + !!hybrid5Ns + ')');
         return false;
     }
     if (verRes && verRes.error) {
-        console.log('[verifyWallet] FAIL: verify returned error:', verRes.error);
         return false;
     }
     if (!(verRes && verRes.result === true)) {
-        console.log('[verifyWallet] FAIL: verRes.result !== true (verRes=', verRes, ')');
         return false;
     }
     return true;
@@ -1414,6 +1479,10 @@ function serializeWallet(wallet) {
         "publicKey": bytesToBase64(wallet.publicKey),
     }
 
+    if (wallet.preExpansionSeed != null && wallet.preExpansionSeed.length > 0) {
+        walletJson.preExpansionSeed = bytesToBase64(wallet.preExpansionSeed);
+    }
+
     return JSON.stringify(walletJson);
 }
 
@@ -1421,23 +1490,35 @@ function serializeWallet(wallet) {
  * The deserializeWallet function creates a Wallet object from a JSON string. 
  *
  * @function deserializeWallet
- * @param {string} walletJson - A Wallet object representing the wallet to deserialize.
- * @return {Wallet} Returns the Wallet corresponding to the walletJson. If the wallet is invalid, null is returned.
+ * @param {string} walletJson - A JSON string representing the wallet to deserialize.
+ * @return {Wallet|null} Returns the Wallet corresponding to the walletJson. If the wallet is invalid or the JSON is malformed, null is returned.
  */
 function deserializeWallet(walletJson) {
     if (isInitialized === false) {
         return -1000;
     }
 
-    var tempWallet = JSON.parse(walletJson);
+    try {
+        var tempWallet = JSON.parse(walletJson);
+        if (tempWallet == null || typeof tempWallet !== 'object') {
+            return null;
+        }
+
+        var preExpansionSeed = null;
+        if (tempWallet.preExpansionSeed != null && tempWallet.preExpansionSeed.length > 0) {
+            preExpansionSeed = base64ToBytes(tempWallet.preExpansionSeed);
+        }
+
+        var wallet = new Wallet(tempWallet.address, base64ToBytes(tempWallet.privateKey), base64ToBytes(tempWallet.publicKey), preExpansionSeed);
 
-    var wallet = new Wallet(tempWallet.address, base64ToBytes(tempWallet.privateKey), base64ToBytes(tempWallet.publicKey));
+        if (verifyWallet(wallet) === false) {
+            return null;
+        }
 
-    if (verifyWallet(wallet) == false) {
+        return wallet;
+    } catch (e) {
         return null;
     }
-
-    return wallet;
 }
 
 function transactionGetSigningHash(fromaddress, nonce, toaddress, amount, gas, chainid, data) {
@@ -1482,7 +1563,6 @@ function transactionGetData(fromaddress, nonce, toaddress, amount, gas, chainid,
 function transactionGetSigningHash2(fromaddress, nonce, toaddress, valueInWeiHex, gas, chainid, data, remarks, signingContext) {
     let messageDataReturn = TxnSigningHash2(fromaddress, nonce, toaddress, valueInWeiHex, gas, chainid, data, remarks, signingContext);
     if (messageDataReturn && messageDataReturn.error) {
-        console.log('[transactionGetSigningHash2] FAIL: messageDataReturn returned error:', messageDataReturn.error);
         return null;
     }
     var messageData = messageDataReturn.result;
@@ -1506,7 +1586,6 @@ function transactionGetTransactionHash2(fromaddress, nonce, toaddress, valueInWe
     }
     var txnHashReturn = TxnHash2(fromaddress, nonce, toaddress, valueInWeiHex, gas, chainid, data, remarks, signingContext, typedPkArray, typedSigArray)
     if (txnHashReturn && txnHashReturn.error) {
-        console.log('[transactionGetTransactionHash2] FAIL: TxnHash2 returned error:', txnHashReturn.error);
         return null;
     }
     return txnHashReturn.result;
@@ -1525,7 +1604,6 @@ function transactionGetData2(fromaddress, nonce, toaddress, valueInWeiHex, gas,
     }
     var txnDataReturn = TxnData2(fromaddress, nonce, toaddress, valueInWeiHex, gas, chainid, data, remarks, signingContext, typedPkArray, typedSigArray)
     if (txnDataReturn && txnDataReturn.error) {
-        console.log('[transactionGetData2] FAIL: TxnData2 returned error:', txnDataReturn.error);
         return null;
     }
     return txnDataReturn.result;
@@ -1573,7 +1651,7 @@ async function postTransaction(txnData) {
             return new SendResult(-601, null, null, requestId);
         }
 
-        if (response.status == 200 || response.status == 204) {
+        if (response.status === 200 || response.status === 204) {
             return new SendResult(0, null, response, requestId);
         }
 
@@ -1588,7 +1666,7 @@ async function postTransaction(txnData) {
  *
  * @async
  * @function getLatestBlockDetails
- * @return {Promise<LatestBlockDetailsResult>}  Returns a promise of an object of type BlockDetailsResult.
+ * @return {Promise<LatestBlockDetailsResult>}  Returns a promise of an object of type LatestBlockDetailsResult.
  */
 async function getLatestBlockDetails() {
     if (isInitialized === false) {
@@ -1634,7 +1712,7 @@ async function getLatestBlockDetails() {
         }
 
         let blockNumber = parseInt(result.blockNumber);
-        if (Number.isInteger(blockNumber) == false) {
+        if (Number.isInteger(blockNumber) === false) {
             return new LatestBlockDetailsResult(-105, null, response, requestId);
         }
 
@@ -1661,7 +1739,7 @@ async function getAccountDetails(address) {
     if (address == null) {
         return new AccountDetailsResult(-200, null, null, null);
     }
-    if (isAddressValid(address) == false) {
+    if (isAddressValid(address) === false) {
         return new AccountDetailsResult(-201, null, null, null);
     }
 
@@ -1706,7 +1784,7 @@ async function getAccountDetails(address) {
         }
 
         let blockNumber = parseInt(result.blockNumber);
-        if (Number.isInteger(blockNumber) == false) {
+        if (Number.isInteger(blockNumber) === false) {
             return new AccountDetailsResult(-207, null, response, requestId);
         }
 
@@ -1714,7 +1792,7 @@ async function getAccountDetails(address) {
             nonce = 0;
         } else {
             let tempNonce = parseInt(result.nonce);
-            if (Number.isInteger(tempNonce) == true) {
+            if (Number.isInteger(tempNonce) === true) {
                 nonce = tempNonce;
                 if (nonce < 0) {
                     return new AccountDetailsResult(-208, null, response, requestId);
@@ -1725,7 +1803,7 @@ async function getAccountDetails(address) {
         }
 
         if (result.balance != null) {
-            if (isLargeNumber(result.balance) == false) {
+            if (isLargeNumber(result.balance) === false) {
                 return new AccountDetailsResult(-210, null, response, requestId);
             } else {
                 balance = result.balance;
@@ -1736,7 +1814,7 @@ async function getAccountDetails(address) {
         return new AccountDetailsResult(0, accountDetails, response, requestId);
 
      } catch (error) {
-        return new AccountDetailsResult(0, null, null, requestId, error);
+        return new AccountDetailsResult(-10000, null, null, requestId, error);
     }
 }
 
@@ -1750,7 +1828,7 @@ async function getAccountDetails(address) {
  * @async
  * @function getTransactionDetails
  * @param {string} txnHash - The hash of the transaction to retrieve.
- * @return {Promise<TransactionDetailsResult>}  Returns a promise of type type TransactionDetailsResult. 
+ * @return {Promise<TransactionDetailsResult>}  Returns a promise of type TransactionDetailsResult.
  */
 async function getTransactionDetails(txnHash) {
     if (isInitialized === false) {
@@ -1760,7 +1838,7 @@ async function getTransactionDetails(txnHash) {
     if (txnHash == null) {
         return new TransactionDetailsResult(-300, null, null, null);
     }
-    if (isAddressValid(txnHash) == false) {
+    if (isAddressValid(txnHash) === false) {
         return new TransactionDetailsResult(-301, null, null, null);
     }
 
@@ -1802,7 +1880,7 @@ async function getTransactionDetails(txnHash) {
 
         if (result.blockNumber !== null) {
             let tempBlockNumber = parseInt(result.blockNumber);
-            if (Number.isInteger(tempBlockNumber) == true) {
+            if (Number.isInteger(tempBlockNumber) === true) {
                 transactionDetails.blockNumber = tempBlockNumber;
             }
             if (tempBlockNumber < 0) {
@@ -1832,7 +1910,7 @@ async function getTransactionDetails(txnHash) {
         
         return new TransactionDetailsResult(0, transactionDetails, response, requestId);
     } catch (error) {
-        return new TransactionDetailsResult(0, null, null, requestId, error);
+        return new TransactionDetailsResult(-10000, null, null, requestId, error);
     }
 }
 
@@ -1841,14 +1919,14 @@ async function getTransactionDetails(txnHash) {
  * Transactions may take a while to get registered in the blockchain. After a transaction is submitted, it may take a while before it is available for listing.
  * Some transactions that have lower balance than the minimum required for gas fees may be discarded. 
  * In these cases, the transactions may not be returned when invoking the listAccountTransactions function. 
- * You should consider the transaction as succeeded only if the status field AccountDetailsCompact object is 0x1 (success). 
+ * You should consider the transaction as succeeded only if the status field of the AccountTransactionCompact object is 0x1 (success).
  * Both transactions from and transactions to the address will be returned in the list.
  * Use the getTransactionDetails function, passing the hash of the transaction to get detailed information about the transaction.
  * @async
  * @function listAccountTransactions
  * @param {string} address - The address for which the transactions have to be listed.
  * @param {number} pageNumber - The page number for which the transactions has to be listed for the account. Pass 0 to list the latest page. Pass 1 to list the oldest page. A maximum of 20 transactions are returned in each page. The response of this API includes a field that shows the pageCount (total number of pages available). You can pass any number between 1 to pageCount to get the corresponding page.
- * @return {Promise<ListAccountTransactionsResponse>}  Returns a promise of type type ListAccountTransactionsResponse. 
+ * @return {Promise<AccountTransactionsResult>}  Returns a promise of type AccountTransactionsResult.
  */
 async function listAccountTransactions(address, pageNumber) {
     if (isInitialized === false) {
@@ -1929,7 +2007,7 @@ async function listAccountTransactions(address, pageNumber) {
 
         return new AccountTransactionsResult(0, listAccountDetailsResponse, response, requestId);
     } catch (error) {
-        return new AccountTransactionsResult(0, null, null, requestId, error);
+        return new AccountTransactionsResult(-10000, null, null, requestId, error);
     }
 }
 
@@ -1945,7 +2023,7 @@ async function listAccountTransactions(address, pageNumber) {
  * @param {string} toAddress - The address to which the coins should be sent. 
  * @param {string} coins - The string representing the number of coins (in ether) to send. To convert between ethers and wei, see https://docs.ethers.org/v4/api-utils.html#ether-strings-and-wei
  * @param {number} nonce - The nonce of the account retrieved by invoking the getAccountDetails function. You have to carefully manage state of the nonce to avoid sending the coins multiple times, such as when retrying sendCoins after a network error.
- * @return {SignResult}  Returns a promise of type SignResult. 
+ * @return {Promise<SignResult>}  Returns a promise of type SignResult.
  */
 async function signSendCoinTransaction(wallet, toAddress, coins, nonce) {
     if (isInitialized === false) {
@@ -1956,20 +2034,20 @@ async function signSendCoinTransaction(wallet, toAddress, coins, nonce) {
         return new SignResult(-500, null, null);
     }
 
-    if (isAddressValid(toAddress) == false) {
+    if (isAddressValid(toAddress) === false) {
         return new SignResult(-501, null, null);
     }
 
-    if (verifyWallet(wallet) == false) {
+    if (verifyWallet(wallet) === false) {
         return new SignResult(-502, null, null);
     }
 
-    if (isLargeNumber(coins) == false) {
+    if (isLargeNumber(coins) === false) {
         return new SignResult(-503, null, null);
     }
 
     let tempNonce = parseInt(nonce);
-    if (Number.isInteger(tempNonce) == false) {
+    if (Number.isInteger(tempNonce) === false) {
         return new SignResult(-504, null, null);
     }
     nonce = tempNonce;
@@ -2026,8 +2104,8 @@ async function signSendCoinTransaction(wallet, toAddress, coins, nonce) {
  * @param {string} toAddress - The address to which the coins should be sent.
  * @param {string} coins - The string representing the number of coins (in ether) to send. To convert between ethers and wei, see https://docs.ethers.org/v4/api-utils.html#ether-strings-and-wei
  * @param {number} nonce - The nonce of the account retrieved by invoking the getAccountDetails function. You have to carefully manage state of the nonce to avoid sending the coins multiple times, such as when retrying sendCoins after a network error.
- * @param {number} data - The data to be signed.
- * @return {SignResult}  Returns a promise of type SignResult.
+ * @param {string} data - Ignored. This parameter is accepted but not used. Use signRawTransaction to pass contract data.
+ * @return {Promise<SignResult>}  Returns a promise of type SignResult.
  */
 async function signTransaction(wallet, toAddress, coins, nonce, data) {
     if (isInitialized === false) {
@@ -2038,20 +2116,20 @@ async function signTransaction(wallet, toAddress, coins, nonce, data) {
         return new SignResult(-500, null, null);
     }
 
-    if (isAddressValid(toAddress) == false) {
+    if (isAddressValid(toAddress) === false) {
         return new SignResult(-501, null, null);
     }
 
-    if (verifyWallet(wallet) == false) {
+    if (verifyWallet(wallet) === false) {
         return new SignResult(-502, null, null);
     }
 
-    if (isLargeNumber(coins) == false) {
+    if (isLargeNumber(coins) === false) {
         return new SignResult(-503, null, null);
     }
 
     let tempNonce = parseInt(nonce);
-    if (Number.isInteger(tempNonce) == false) {
+    if (Number.isInteger(tempNonce) === false) {
         return new SignResult(-504, null, null);
     }
     nonce = tempNonce;
@@ -2112,6 +2190,10 @@ function hexStringToUint8Array(hex) {
         hex = hex.slice(2);
     }
 
+    if (/[^0-9a-fA-F]/.test(hex)) {
+        return new Uint8Array(0);
+    }
+
     // Ensure even length (pad with leading zero if needed)
     if (hex.length % 2 !== 0) {
         hex = '0' + hex;
@@ -2162,7 +2244,7 @@ function signRawTransaction(transactionSigningRequest) {
             // Convert BigInt to hex string
             valueInWeiHex = '0x' + transactionSigningRequest.valueInWei.toString(16);
         } else if (typeof transactionSigningRequest.valueInWei === 'string') {
-            if (transactionSigningRequest.valueInWei.startsWith('0x') === false) {
+            if (transactionSigningRequest.valueInWei.startsWith('0x') === false || /[^0-9a-fA-F]/.test(transactionSigningRequest.valueInWei.slice(2))) {
                 return new SignResult(-903, null, null);
             }
             valueInWeiHex = transactionSigningRequest.valueInWei;
@@ -2182,7 +2264,7 @@ function signRawTransaction(transactionSigningRequest) {
 
     let data = null;
     if (transactionSigningRequest.data !== null) {
-        if (typeof transactionSigningRequest.data !== 'string' || transactionSigningRequest.data.startsWith('0x') === false) {
+        if (typeof transactionSigningRequest.data !== 'string' || transactionSigningRequest.data.startsWith('0x') === false || /[^0-9a-fA-F]/.test(transactionSigningRequest.data.slice(2))) {
             return new SignResult(-906, null, null);
         }
         data = hexStringToUint8Array(transactionSigningRequest.data);
@@ -2199,7 +2281,7 @@ function signRawTransaction(transactionSigningRequest) {
 
     let remarks = null;
     if (transactionSigningRequest.remarks !== null) {
-        if (typeof transactionSigningRequest.remarks !== 'string' || transactionSigningRequest.remarks.startsWith('0x') === false) {
+        if (typeof transactionSigningRequest.remarks !== 'string' || transactionSigningRequest.remarks.startsWith('0x') === false || /[^0-9a-fA-F]/.test(transactionSigningRequest.remarks.slice(2))) {
             return new SignResult(-909, null, null);
         }
         remarks = hexStringToUint8Array(transactionSigningRequest.remarks);
@@ -2399,20 +2481,20 @@ async function sendCoins(wallet, toAddress, coins, nonce) {
         return new SendResult(-1, null, null, null);
     }
 
-    if (isAddressValid(toAddress) == false) {
+    if (isAddressValid(toAddress) === false) {
         return new SendResult(-2, null, null, null);
     }
 
-    if (verifyWallet(wallet) == false) {
+    if (verifyWallet(wallet) === false) {
         return new SendResult(-3, null, null, null);
     }
 
-    if (isLargeNumber(coins) == false) {
+    if (isLargeNumber(coins) === false) {
         return new SendResult(-4, null, null, null);
     }
 
     let tempNonce = parseInt(nonce);
-    if (Number.isInteger(tempNonce) == false) {
+    if (Number.isInteger(tempNonce) === false) {
         return new SendResult(-5, null, null, null);
     }
     nonce = tempNonce;
@@ -3037,7 +3119,7 @@ module.exports = {
     AccountTransactionsResult, 
     ListAccountTransactionsResponse, 
     AccountTransactionCompact,
-    newWalletSeed,
+    newWalletSeedWords,
     openWalletFromSeed,
     openWalletFromSeedWords,
     publicKeyFromSignature,