quantumcoin 7.0.9 → 7.0.11

package/examples/node_modules/quantum-coin-js-sdk/example/README.md

@@ -0,0 +1,14 @@
+## Quantum Coin SDK Example
+
+Example for using Quantum Coin SDK
+
+Requires Node.js version v20.18.1 or higher
+
+To run the project:
+
+     npm install
+
+
+     node example.js
+
+The example contains many async API calls, hence you might notice that the log output will be skewed.

package/examples/node_modules/quantum-coin-js-sdk/example/conversion-example.js

@@ -0,0 +1,19 @@
+const ethers = require('ethers');
+
+let hexValue = "0xDE0B6B3A7640000";
+
+//Convert hex to wei
+let weiValueExample = BigInt(hexValue).toString();
+console.log("hex to wei example: hex:" + hexValue + ", wei: " + weiValueExample);
+
+//Convert wei to eth
+let ethValueExample = ethers.formatEther(weiValueExample);
+console.log("wei to eth example: wei:" + weiValueExample + ", eth (coins): " + ethValueExample);
+
+//Convert eth to wei
+let weiValueExample2 = ethers.parseUnits(ethValueExample, "ether");
+console.log("eth to wei example: eth (coins):" + ethValueExample + ", wei: " + weiValueExample2);
+
+//Convert wei to hex
+let hexValue2 =  ethers.toBeHex(weiValueExample2);
+console.log("wei to hex example : hex: " + hexValue2 + ", wei: " + weiValueExample2);

package/examples/node_modules/quantum-coin-js-sdk/example/example-create-contract.js

@@ -0,0 +1,396 @@
+const qcsdk = require('quantum-coin-js-sdk');
+const readline = require('readline');
+
+/**
+ * Example: Creating a Smart Contract using signRawTransaction
+ * 
+ * This example demonstrates how to create a smart contract on the Quantum Coin blockchain
+ * using signRawTransaction and sendRawTransaction.
+ * 
+ * STEPS TO COMPILE THE SOLIDITY CONTRACT:
+ * 
+ * 1. Download the Solidity compiler (solc.exe) from:
+ *    https://github.com/quantumcoinproject/Solidity/releases/tag/v32b.8.12
+ * 
+ * 2. Save the Solidity contract code below to a file (e.g., SimpleStorage.sol)
+ * 
+ * 3. Compile the contract using the following command:
+ *    c:\solc\solc.exe --bin SimpleStorage.sol
+ * 
+ *    This will output the bytecode. Look for the "Binary:" section in the output.
+ * 
+ * 4. Copy the bytecode (without the 0x prefix if present) and paste it into the
+ *    CONTRACT_BYTECODE variable below, ensuring it starts with "0x"
+ * 
+ * Example compilation output format:
+ *    ======= SimpleStorage.sol:SimpleStorage =======
+ *    Binary:
+ *    608060405234801561001057600080fd5b50...
+ * 
+ * 5. Replace the CONTRACT_BYTECODE placeholder below with the actual compiled bytecode
+ */
+
+/**
+ * Simple Solidity Contract Example:
+ 
+  Save this to a file named SimpleStorage.sol for compilation
+  
+ // SPDX-License-Identifier: MIT
+  pragma solidity ^0.7.6;
+ 
+  contract SimpleStorage {
+    uint256 private storedValue;
+      
+     event ValueChanged(uint256 newValue);
+      
+      function set(uint256 value) public {
+         storedValue = value;
+          emit ValueChanged(value);
+     }
+      
+     function get() public view returns (uint256) {
+          return storedValue;
+      }
+  }
+*/
+
+// ============================================
+// COMPILATION INSTRUCTIONS:
+// ============================================
+// 1. Download solc.exe from: https://github.com/quantumcoinproject/Solidity/releases/tag/v32b.8.12
+// 2. Save the Solidity code above to SimpleStorage.sol
+// 3. Run: c:\gethbuild\solc.exe --bin SimpleStorage.sol
+// 4. Copy the bytecode from the "Binary:" section
+// 5. Paste it below in CONTRACT_BYTECODE, ensuring it starts with "0x"
+// ============================================
+
+// Replace below placeholder CONTRACT_BYTECODE with the actual compiled bytecode from solc.exe
+// The bytecode should be a hex string starting with "0x"
+// After compiling with: c:\gethbuild\solc.exe --bin SimpleStorage.sol
+// Copy the bytecode from the "Binary:" section and paste it here
+const CONTRACT_BYTECODE = "0x608060405234801561001057600080fd5b5060fe8061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c806360fe47b11460375780636d4ce63c146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b606860bf565b6040518082815260200191505060405180910390f35b806000819055507f93fe6d397c74fdf1402a8b72e47b68512f0510d7b98a4bc4cbdf6ac7108b3c59816040518082815260200191505060405180910390a150565b6000805490509056fea26469706673582212204638427ab77bf9babc9db8fb5d8f69323478e00367c47884b65ee0677a337f8e64736f6c63430007060033";
+
+// Configuration
+var clientConfigVal = new qcsdk.Config("", "", 123123, "", ""); //Mainnet
+//Mainnet Block Explorer: https://scan.quantumcoin.org
+
+const rpcEndpointUrl = 'https://public.rpc.quantumcoinapi.com';
+
+/**
+ * Helper function to get transaction count (nonce) from RPC
+ */
+async function getTransactionCount(address) {
+    try {
+        const params = [address, "latest"];
+        const response = await fetch(rpcEndpointUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'eth_getTransactionCount',
+                params: params,
+            }),
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+
+        const result = await response.json();
+        if (result.error) {
+            throw new Error(result.error.message);
+        }
+        return parseInt(result.result, 16);
+    } catch (error) {
+        console.error('Could not get transaction count:', error);
+        throw error;
+    }
+}
+
+/**
+ * Helper function to calculate gas price
+ * QuantumCoin uses a fixed gas price: 1000 coins per 21000 gas units
+ * Gas price = (1000 coins * 10^18 wei) / 21000 gas = wei per gas unit
+ */
+function getGasPrice() {
+    const gasPriceWei = BigInt("47619047619047600");
+    
+    return gasPriceWei;
+}
+
+/**
+ * Helper function to prompt user for confirmation
+ */
+function promptUser(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase().trim());
+        });
+    });
+}
+
+/**
+ * Helper function to convert wei to coins
+ */
+function weiToCoins(wei) {
+    const oneCoinInWei = BigInt("1000000000000000000");
+    const coins = Number(wei) / Number(oneCoinInWei);
+    return coins;
+}
+
+/**
+ * Helper function to estimate gas for a transaction via RPC
+ */
+async function estimateGas(fromAddress, toAddress, value, data) {
+    try {
+        const txObject = {
+            from: fromAddress,
+            to: toAddress, // null for contract creation
+            value: value,
+            data: data
+        };
+        
+        const params = [txObject, "latest"];
+        const response = await fetch(rpcEndpointUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'eth_estimateGas',
+                params: params,
+            }),
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+
+        const result = await response.json();
+        if (result.error) {
+            throw new Error(result.error.message);
+        }
+        return parseInt(result.result, 16);
+    } catch (error) {
+        console.error('Could not estimate gas:', error);
+        throw error;
+    }
+}
+
+/**
+ * Helper function to send raw transaction via RPC
+ */
+async function sendRawTransaction(signedTxData) {
+    try {
+        const params = [signedTxData];
+        const response = await fetch(rpcEndpointUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'eth_sendRawTransaction',
+                params: params,
+            }),
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+
+        const result = await response.json();
+        if (result.error) {
+            throw new Error(result.error.message);
+        }
+        return result.result; // Returns transaction hash
+    } catch (error) {
+        console.error('Could not send raw transaction:', error);
+        throw error;
+    }
+}
+
+//Initialize the SDK
+qcsdk.initialize(clientConfigVal).then(async (initResult) => {
+    if (initResult === false) {
+        console.error("Initialize failed");
+        return;
+    }
+
+    console.log("=== Example: Creating a Smart Contract ===\n");
+
+    // Open a wallet
+    let examplePassphrase = "QuantumCoinExample123!";
+    const walletEncryptedJson = "{\"address\":\"45dc00282f80628911a15775cd821a3747d2c62e14e54d1339f057c9e921be71\",\"crypto\":{\"cipher\":\"aes-256-ctr\",\"ciphertext\":\"a831e40b8e99a534df5b6dee638742f5d5ebddf07d0aa5603ff4c32d62de8442d1252f84c6777d12d14ca3be80538d5e69cc70e75363730427194cda709dee33da97452fcd4284898afebac2d5b298b10be30a89416afa66edfa46b3a396b880f030d5f2c64a7fcfd458ee8705f160cc98335cf7a7849908e33cd5af88a989c092c5453315436b0d3dd18f9357f68b37c95f30b5e3c6b1a29c39dd1c32af13c39398c137fa45334fd46b0601046818afa0710e38fb780fa47d8cf8392ce43461ef730fc8464fd4c39b75c27017e8a4344855edd16b7ac2e3a4c6a87a077314ada08def8ebde528c40e3d8b32f3ef9f9c8708020d86e99e89b3e5500aa6d9e628a2cc8b1dd17b0bbdd445f69c443b09433c3b8b94a6b1fd7e8af1b88cef8e6078dd010422e85ad3bd2d2e0344c7517f9530073c5f225c602eb61a138e13f79bf12c05bb01c61a2b13aed3d05d601ee42fa04af0ee6b2b37856b67e45348407ce43520e18e5bc639a9bfd0df9fedb8f91858bd3c220a78fc4aeeeaa8d7b3aa420964549b746fcb5b53177089b2ec59658c99b77e1b1e303233c041271a50c6e831379fd168f943563638341cca44ba63b3fe2fdd254386a4c325a881f3fb96f118169a56fed4b002f48bbfdfda728c50cff6529754359f29d44a66762f3a0ea39840a733852faa4a7be1ed6d8afc8291493cbdb55b17b4ef63dbe0f7bfb97c82986974f51a5da2b8dcdcf7f126f08389360164cd666f13ec64b9a63609c56fd154b6322f51d0b1d448dafe7806b59d00ce2fbbf34e6281f8c446012f124a4ea52955ff995dd642b1650cb4cdd9806038d2e3f3c0432a5a35307eae4ffdc49a8b9b83172804767ff8f082c8aa9e12315536ca6cb3b98cd80e438477ff5e53c9184db543fb6f3df0a7017bd9e513e83b707dd6917efd6990e609fd57abc1285e3e72899a1a6f0943539ea8e992050b681437a80b970f6e8d2bcdfa635acc270d7dec1b80bdb373dce18adb924b4ccf1ea61796a10f69eadb9da3ceea7e636e84fa0972e0cfea5237d19f488d31a0280e8a59f59dc44f825fd3bc41b92f1289042f45e892cab5a60a3036d594791143c737f2082cfcecf88f3a34d6cf6e50719c310e92e8e0fadbdce07f992006d5fc5869452ab572f6e4e864d5d72bde42d6ae26a909fa9a3964bc688052451e65a3612ef3e25392edd7388ebdeb3ee51d63ea3951a8ee653e7389d3a20cd7da5292fadad41e2decc398a9318d09d2b0c589c193f9411212e6eb76480adf62f6345e6b7ad980866cfe4921468618d3e29614450052be793c006e784f3180c97058aedd751a7db1b1d676285e7793acdc02642fbe45803ed837f6f518b63bf363ff2b73ac8215b5db7cebff2197467f5f89de7080cd83779ac94d0732deec47bd9473bdf5c45428e961d057c642336257390daa2784f82289941015e7ac2ff399710d4a123e30f9867a62c6ed1f07bfa5059487b558e9aeda68a6171b55c03f85c00fad075f57b344a84b0c098f922b89ed572e578e3d2951eeaa051d5f26339776f51f390af1f5fc62e6ea42fae34da1676d0410a96b7e1d3c88f37c753dcf6a19512c7f619aa0beb27b318c128f5728232b0fc86e4eb9dabca731ffbe8b09a93d82aa95010ef621ed33a319984d3e12b9e856d81f46602c7fe13d24716362ebfc70b43eb46495db78d2dbf509413a0162179023d22a4584f1421622e1151de4e4c80f12114b22d3d06f434a2f85cc5606cdad1d6fa3044a3dd6175049d137eb1a5d764715f1289dda9a8f55fd856275a3650ce7d67e20d025ef1c1c9c2a1f17613b41e4917edab30d31ae7d8c4351e9c8bb83726998e9cffc82f92d7ba1b1fd104d4f013a0496daf75ce2b50d21c4eb20c5d295832f3bd6501f6f1f491783aa476664e058cb2b4d22411bc5ecca5ec53b763f70e9223d9915c83b35e79aa86417b3505c8b952265c6a48ab266fade009c1faacce9d9a89516223593e5f1d5039f82ca0a043eceb78f5ea20d180b22d3f11a7ca5ae0792b5dc9685ba46fc87326eb468295f0890cf9338b69dabd5f826046e216bb7306333120bb36aa902f54dd28cbeb8580f3483cf69f8f9fdb3c7ff936f055f9323fa02db8237db7b2d6d26e137fc5fa728c387dbca015f34228915088a95fdfc09a5d2c42ea8189a1dff888ea53f52541232689ba396d96bffb13bab2d65f94a422ea762b6446d5a8e4e2f0c5b2398fcabba825e532a4bae96b45c2a88ca138ae9118653f71d1d9c7819755febcf15b203e1402522b2762985fdbd70dfc37cd0b6943d50cbbaf42f01b442e6f4445f986c09bc55835bb6a03431d1bfa1916db455c822972ff9fba37b2d4477cbf2138325949c4a15d1e0457b51cb06d35c9bf3478c79256989c36d9ec35b3d7f67eb23e476250f9424835be56ef00406c395d60c608100258b97cd51f853960c44ca48e2ea2696793e825db9e9a52ea840c8dd252273eec1212482738be81301acd8c79e5fd54b218c4e27b139c6e8eb5729b01326273a70f64785878dd3f0b10462bf11b152229dd5b1ef9d5cc7bffc44a85384163de88bb421a2999e0f01cec8b74c8dce0b0a40fd0409c26a9c967940592e61936a70f7c8be7d95d45b9a003b5dc1d33121cb7901afec1c8d98103e29d64a370ac6344600ceb067b921067ce2760a5a7e07c9396606458eb3f404713a8bb8d12211b64fd98bf9a88031cf9bbccab00a9f6a7b5c7033dfa90ff1aee6d95a9af74926ea83332523bbf4df7c4cd8769e0a56e50205b529bbafb37438c8ce05ed02e8dbcb6a60f03a0142e701ab2d2520e159ac2c5ce1a2d0f342bc837f60c7ca912241a55d8ed174f9b714950cc7d3eddd06d23f31d6fc46eb2bc248cfcac8fbb7a0d8bc6f972c9bd9f5ef29942bac1b117675c33664b50fcc6f049528b76dc2fffa766fca42c2968ff6960e33efd2984db268412543c07682f0ddb9bd59ce111820d6f1bd1a76063b0c60479b19b8a49631a722747c6d20133a77f7072330c134d006352e44443230c7eddfc9fd645a50b3e3ee780ef7097198d7c87ad9969d4afe414314b57f248e4237dc164e084be7534f2c3c55f5110fe7d202a5737f067b7a282f8090cfcdd2d34f64aee499c075e50f480272e3d981b3c0e553b8bd04279dcd0097cc035d8016f4e4d40d3b5526b617533e1f1db0d90b4071bd4e2ada7b6ad172beff1edda9c8c750f77895880a0cea9c5b35f70cc32d9b83d088ae66662182c0f41db5c3faaacd7773846d7cee72d3748533ec9983964749f1f5694218d357ecab2d330206dfc11dfaa5c29a6441890faf607d73f33732c07097da08d84231eed7346e706d24bc695df684c6670cc5b10662638f7c01534833f8b6fc6eab95f3841cea2069b7a25d97c390b58d04519a62bc93c56803ee773ba80309917202ddf8fe9cb128869a42e206126c282c4e896e74981db12f4d0f2bddec9a674b75c86e8cbd18d29ddca4dadc11141d066ebe424ace546ec974a6ec8b7ee352fcdc96a88a65c90166cd9c8b5b03640614632aa3eb0d1516b40128b065c3e377ceac6a5be1217351da75534c9d651d80551b3150732389e35025d0769bbb3d9885e83450eb262ed091bcd181979ecfc56d2301b3d3c7941e52a55f7e3460e1056612010cd286aa193a5dbe015b22bca180f239c36eeacbb6f6d5884f469163260fdf015203a8523059d8da4b869be00cb938d318a8215b212dd0bd6a7bd6e336bca3c67ba74872eb19c450982796d794b013f27e3cf889a928fcd94caff8692a29266befe74420edd2117bf947d4730dda838640128bdb17869eab8dfa228d4c4bb5ff5b00a57c6c8d1123487039338e3f342cf273e0e4995e95ff4c8e2a23974bf16c20f5443c21eb9aadf69aaacefddeacb2844f9a5f354cad0a94af5be824e9a2ec4c03828fdab7415d9be05372e8c515c0cd5fcd44e69f1b380df484c860539773ce68b402a6585fcd826a92ce05162cf7f17ca02d7fdd80b9cfa8bb3a37cf62ff6f3ecbe03c186075a5dbce6e36fe46ed9059fa60e347c978f0f3b71bc9d05e4a4e1ce6b48e0593a1acdf9899f4d709e005b972411349fda2c544396eb73c10d89c6db2b5a7506a34d7f5b66b3ff37e8088f2dcd9c2dd76b21818674f8ceb8bbda6c38b58dd5f5de09c8a25949e28aa04a8ccba10275c032309e9b61de148f8495640cfbf3d46e342c3859bfb5e6ab10b4df4a39bc20a2eb48fbaee4c01f5661b4129b15414842eaa46154c77df5484fab490185cfa83f21ec5b72abfa507b6b998654aec4b1031ac1dfc919022423d6020fa1a702fd65f98e0b6f64210f7d2d326de960a51c7c5b357c42073fac112a393c7f40a0f368600ba00010530aa782460098f559f42b37d3510afb425a249c0c17cf0380c40793b068d565fcc2fd70df74dc2b8cbda4849164c30631554517f0ba2c9e94977959012bc7f371b5c375214a5ed4f2d3920746cb5a01c0356c187bb186a7d5ae7bd57e13befa101813dce482b49ad0d41fbe5bc542cf55445136db1f8442003e48a75bb6637be93626178bed28402c91610d067d94d06136b337d4ada511376a84fb6bde4215828359058cb2f5b1d0281ff93743d43b8881d4f7591800166621141cca2b122f1ed63baaca752f7de0cf6d2e92dc6caa2a43df580d8b472400065aeeffc71d5a7a5f52f02d26a26225c53591a60e29a8ae7e9cd0d3f9f8ab8bb5176ae1fd4e881db04f8239b282123147036019a560fb450baf8fc3dbaa7989c04e8e8f674acdadf59048f7fcc5efd8ac3577e9204837dd6bec8c72c52d019e9172825ff27bc9cef950d729a02c26e00167872c53a2c303cb260035a5184519cdb9dc0ae32b1b3d0375b248fe4c5b98a37368cf0d548c48904d87d4f3ff4e9a989b3f28a5747cfd5f7a67d3b8dc30bdf709bfa56075d28e375d24c7409ff442913c1209f1587f8e252a35c6bfdcf581d7fb1bd693329eafd872078de4c1b31a7d5d5f3466adf41b0ee17c9aba8b88bbba6a868ddddfed5085947da0859d16641abc2e869e7a120c807d1a2092ed79f43f287dfdffc044cd3c246f87dc12727dc8b6151ea19f1d919ebd23ba46e5ae7fcc7cfd7a746db70dd0adeef889e5ae74941fbe7f97021fc95e8423ba91b735d8e9587f5ad515d595600abc96c08d796e640def566e990d9f4c6a5e7270f949284221c81df4e57a9c129a45d508820938365093d6dd672f4d4418c7bff35ca1603aa068beeee04060251722f04718303e1fd4c5bc64ef07b13408516ec92581d2de93a93693148ba416615fe1f1b64d5bd8975777337242e0ea9f7586599fdba8dd87c81a4c6bf4eab14d6ebac32cb3310cbbe5cf23620973b4ed7e688bec9e2d5569594c2377ba60f998750dd828bc704aeda55f5608ea12649e91a3733cb9b4a34d9886ea6b4a8d2cfbd883b9997ef1042f8d40b4cd870698585bb409cd5c21365d38e3c95dcd91244a62d766ba728aa822390c2def2166c46f45c275790f2a6dd11f906312214c120bf27efda0afd4cd8d6482d16a4ab72d2e69a49cb3e1b4ebb9025d81479fd2ccb4f66eee4248657c3f8dca13aa7201824bff06c543e0200c4cdff612ab0bb29b89fdb82c3a7abb14edd78f6e224c61c4d3d3b1c1c7038aa54afb4d32c3039d58e057185906c89887cc101b577c97b363d7c587c652a358c4025f690be410171b2c76723433da12a9163a4420f13aa\",\"cipherparams\":{\"iv\":\"664b1a53b2ecf34d3305397defd89b38\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":48,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"d48fb344fbec36d5a3787e4271561bdc61a6c100e20641521fceba2af6bc0668\"},\"mac\":\"ba8bebc33fe945df3340b9e761c199304655ac1c24dbef92b69cc5e6a84fb649\"},\"id\":\"a4d92ffd-9dc9-41ab-9eaa-04ef14b8a4bc\",\"version\":4}";
+    console.log(walletEncryptedJson);
+    let wallet = qcsdk.deserializeEncryptedWallet(walletEncryptedJson, examplePassphrase);
+    if (wallet === null) {
+        console.log("Error opening wallet");
+    } else {
+        console.log("From wallet address: " + wallet.address);
+    }
+    console.log("Note: This wallet needs to have sufficient balance for gas fees\n");
+
+    try {
+        // Get nonce from RPC
+        const nonce = await getTransactionCount(wallet.address);
+        console.log("Nonce (transaction count) is:", nonce);
+
+        // Verify that bytecode has been set
+        if (CONTRACT_BYTECODE === "0xPLACEHOLDER_REPLACE_WITH_COMPILED_BYTECODE" || CONTRACT_BYTECODE.length < 10) {
+            console.error("\n❌ ERROR: CONTRACT_BYTECODE has not been set!");
+            console.error("Please compile the Solidity contract and update CONTRACT_BYTECODE with the actual bytecode.");
+            console.error("Steps:");
+            console.error("1. Download solc.exe from: https://github.com/quantumcoinproject/Solidity/releases/tag/v32b.8.12");
+            console.error("2. Save the Solidity code from the comments above to SimpleStorage.sol");
+            console.error("3. Run: c:\\gethbuild\\solc.exe --bin SimpleStorage.sol");
+            console.error("4. Copy the bytecode from the 'Binary:' section");
+            console.error("5. Paste it in CONTRACT_BYTECODE variable, ensuring it starts with '0x'\n");
+            return;
+        }
+
+        // Contract creation parameters
+        const toAddress = null; // null for contract creation
+        const valueInWei = "0x0"; // No value sent with contract creation (or use BigInt(0))
+        const remarks = null; // No remarks
+
+        // Pack contract creation data using packCreateContractData
+        // This matches the Go pattern: Pack("", params...) and append(bytecode, input...)
+        // For a constructor with no parameters, we pass no args
+        console.log("Packing contract creation data...");
+        const CONTRACT_ABI = [
+            {
+                "type": "constructor",
+                "inputs": [],
+                "stateMutability": "nonpayable"
+            }
+        ];
+        const abiJSON = JSON.stringify(CONTRACT_ABI);
+        const packResult = qcsdk.packCreateContractData(abiJSON, CONTRACT_BYTECODE /* no constructor params */);
+        
+        if (packResult.error) {
+            console.error("❌ Error packing contract creation data:", packResult.error);
+            return;
+        }
+        
+        const data = packResult.result; // Packed bytecode + constructor data
+        console.log("Contract creation data packed successfully");
+        console.log("Data length:", data.length, "characters");
+        
+        // Calculate and display the contract address that will be created
+        console.log("\nCalculating contract address...");
+        const contractAddress = qcsdk.createAddress(wallet.address, nonce);
+        if (contractAddress) {
+            console.log("✅ Contract will be deployed at address:", contractAddress);
+        } else {
+            console.warn("⚠️  Could not calculate contract address");
+        }
+
+        // Estimate gas for contract creation
+        console.log("Estimating gas for contract creation...");
+        let gasLimit;
+        try {
+            const estimatedGas = await estimateGas(wallet.address, toAddress, valueInWei, data);
+            console.log("Estimated gas:", estimatedGas);
+            
+            // Add 20% buffer to estimated gas to ensure transaction doesn't fail
+            const gasBuffer = Math.ceil(estimatedGas * 0.2);
+            gasLimit = estimatedGas + gasBuffer;
+            console.log("Gas limit (with 20% buffer):", gasLimit);
+        } catch (error) {
+            console.warn("⚠️  Could not estimate gas, using default gas limit:", error.message);
+            // Fallback to a default gas limit if estimation fails
+            gasLimit = 500000;
+            console.log("Using default gas limit:", gasLimit);
+        }
+
+        // Calculate gas price (fixed: 1000 coins per 21000 gas)
+        console.log("\nCalculating gas price...");
+        const gasPrice = getGasPrice();
+        console.log("Gas price (wei per gas unit):", gasPrice.toString());
+        console.log("Note: QuantumCoin uses a fixed rate of 1000 coins per 21000 gas units");
+
+        // Calculate total fee
+        const totalFeeWei = BigInt(gasLimit) * gasPrice;
+        const totalFeeCoins = weiToCoins(totalFeeWei);
+
+        // Display transaction details and request confirmation
+        console.log("\n" + "=".repeat(60));
+        console.log("TRANSACTION DETAILS");
+        console.log("=".repeat(60));
+        console.log("Gas Limit:     ", gasLimit.toLocaleString());
+        console.log("Gas Price:     ", gasPrice.toString(), "wei");
+        console.log("Total Fee:     ", totalFeeWei.toString(), "wei");
+        console.log("Total Fee:     ", totalFeeCoins.toFixed(9), "coins");
+        console.log("=".repeat(60));
+
+        // Request user confirmation
+        const confirmation = await promptUser("\nDo you want to proceed with this transaction? (yes/no): ");
+        
+        if (confirmation !== 'yes' && confirmation !== 'y') {
+            console.log("Transaction cancelled by user.");
+            return;
+        }
+
+        console.log("\nProceeding with transaction...");
+
+        // Create transaction signing request
+        const transactionRequest = new qcsdk.TransactionSigningRequest(
+            wallet,
+            toAddress, // null for contract creation
+            valueInWei,
+            nonce,
+            data, // Contract bytecode
+            gasLimit,
+            remarks
+        );
+
+        // Sign the transaction
+        console.log("\nSigning transaction...");
+        const signResult = qcsdk.signRawTransaction(transactionRequest);
+
+        if (signResult.resultCode !== 0) {
+            console.error("Failed to sign transaction. Result code:", signResult.resultCode);
+            return;
+        }
+
+        console.log("Transaction signed successfully");
+        console.log("Transaction hash:", signResult.txnHash);
+        console.log("Transaction data length:", signResult.txnData.length, "characters");
+        console.log("Transaction data:", signResult.txnData);
+
+        // Send transaction via RPC
+        console.log("\nSending transaction to network...");
+        try {
+            const txHash = await sendRawTransaction(signResult.txnData);
+            console.log("✅ Transaction submitted successfully!");
+            console.log("Transaction hash from RPC:", txHash);
+            if (contractAddress) {
+                console.log("\n📝 Contract Address:", contractAddress);
+                console.log("Note: The contract will be deployed at the address shown above once the transaction is confirmed.");
+            } else {
+                console.log("\nNote: The contract will be deployed at an address determined by the transaction.");
+            }
+            console.log("You can check the transaction status on the block explorer.");
+        } catch (error) {
+            console.error("❌ Error sending transaction:", error.message);
+            console.error("Make sure the wallet has sufficient balance for gas fees.");
+        }
+
+    } catch (error) {
+        console.error("Error creating contract:", error);
+    }
+});
+

package/examples/node_modules/quantum-coin-js-sdk/example/example-encode-decode-rlp.js

@@ -0,0 +1,225 @@
+/**
+ * Example: RLP Encoding and Decoding
+ * 
+ * This example demonstrates how to use the encodeRlp and decodeRlp functions
+ * to encode and decode various JavaScript values using RLP (Recursive Length Prefix) encoding.
+ * 
+ * RLP is used in Ethereum and Quantum Coin for encoding structured data.
+ */
+
+const qcsdk = require('../index');
+
+// Initialize the SDK
+async function main() {
+    console.log('=== RLP Encoding and Decoding Examples ===\n');
+
+    // Initialize SDK with default mainnet config
+    const initResult = await qcsdk.initialize(null);
+    if (initResult === false) {
+        console.error('Failed to initialize SDK');
+        return;
+    }
+    console.log('SDK initialized successfully\n');
+
+    // Example 1: Encode and decode a string
+    console.log('--- Example 1: String ---');
+    const stringValue = 'Hello, World!';
+    console.log('Original value:', stringValue);
+    
+    const encodeResult1 = qcsdk.encodeRlp(stringValue);
+    if (encodeResult1.error) {
+        console.error('Encoding error:', encodeResult1.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult1.result);
+        
+        const decodeResult1 = qcsdk.decodeRlp(encodeResult1.result);
+        if (decodeResult1.error) {
+            console.error('Decoding error:', decodeResult1.error);
+        } else {
+            const decoded = JSON.parse(decodeResult1.result);
+            console.log('Decoded value:', decoded);
+            console.log('Round-trip successful:', decoded === stringValue);
+        }
+    }
+    console.log();
+
+    // Example 2: Encode and decode a number
+    console.log('--- Example 2: Number ---');
+    const numberValue = 42;
+    console.log('Original value:', numberValue);
+    
+    const encodeResult2 = qcsdk.encodeRlp(numberValue);
+    if (encodeResult2.error) {
+        console.error('Encoding error:', encodeResult2.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult2.result);
+        
+        const decodeResult2 = qcsdk.decodeRlp(encodeResult2.result);
+        if (decodeResult2.error) {
+            console.error('Decoding error:', decodeResult2.error);
+        } else {
+            const decoded = JSON.parse(decodeResult2.result);
+            console.log('Decoded value:', decoded);
+            console.log('Round-trip successful:', decoded === numberValue);
+        }
+    }
+    console.log();
+
+    // Example 3: Encode and decode a boolean
+    console.log('--- Example 3: Boolean ---');
+    const boolValue = true;
+    console.log('Original value:', boolValue);
+    
+    const encodeResult3 = qcsdk.encodeRlp(boolValue);
+    if (encodeResult3.error) {
+        console.error('Encoding error:', encodeResult3.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult3.result);
+        
+        const decodeResult3 = qcsdk.decodeRlp(encodeResult3.result);
+        if (decodeResult3.error) {
+            console.error('Decoding error:', decodeResult3.error);
+        } else {
+            const decoded = JSON.parse(decodeResult3.result);
+            console.log('Decoded value:', decoded);
+            console.log('Round-trip successful:', decoded === boolValue);
+        }
+    }
+    console.log();
+
+    // Example 4: Encode and decode an array
+    console.log('--- Example 4: Array ---');
+    const arrayValue = ['hello', 123, true];
+    console.log('Original value:', JSON.stringify(arrayValue));
+    
+    const encodeResult4 = qcsdk.encodeRlp(arrayValue);
+    if (encodeResult4.error) {
+        console.error('Encoding error:', encodeResult4.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult4.result);
+        
+        const decodeResult4 = qcsdk.decodeRlp(encodeResult4.result);
+        if (decodeResult4.error) {
+            console.error('Decoding error:', decodeResult4.error);
+        } else {
+            const decoded = JSON.parse(decodeResult4.result);
+            console.log('Decoded value:', JSON.stringify(decoded));
+            console.log('Round-trip successful:', JSON.stringify(decoded) === JSON.stringify(arrayValue));
+        }
+    }
+    console.log();
+
+    // Example 5: Encode and decode an object (map)
+    console.log('--- Example 5: Object (Map) ---');
+    const objectValue = { name: 'Alice', age: 30, active: true };
+    console.log('Original value:', JSON.stringify(objectValue));
+    
+    const encodeResult5 = qcsdk.encodeRlp(objectValue);
+    if (encodeResult5.error) {
+        console.error('Encoding error:', encodeResult5.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult5.result);
+        
+        const decodeResult5 = qcsdk.decodeRlp(encodeResult5.result);
+        if (decodeResult5.error) {
+            console.error('Decoding error:', decodeResult5.error);
+        } else {
+            const decoded = JSON.parse(decodeResult5.result);
+            console.log('Decoded value:', JSON.stringify(decoded));
+            // Note: Objects are encoded as arrays of key-value pairs in RLP
+            // The decoded structure may differ from the original object
+        }
+    }
+    console.log();
+
+    // Example 6: Encode and decode a hex string
+    console.log('--- Example 6: Hex String ---');
+    const hexValue = '0x48656c6c6f'; // "Hello" in hex
+    console.log('Original value:', hexValue);
+    
+    const encodeResult6 = qcsdk.encodeRlp(hexValue);
+    if (encodeResult6.error) {
+        console.error('Encoding error:', encodeResult6.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult6.result);
+        
+        const decodeResult6 = qcsdk.decodeRlp(encodeResult6.result);
+        if (decodeResult6.error) {
+            console.error('Decoding error:', decodeResult6.error);
+        } else {
+            const decoded = JSON.parse(decodeResult6.result);
+            console.log('Decoded value:', decoded);
+        }
+    }
+    console.log();
+
+    // Example 7: Encode and decode a nested array
+    console.log('--- Example 7: Nested Array ---');
+    const nestedArrayValue = [1, [2, 3], [4, [5, 6]]];
+    console.log('Original value:', JSON.stringify(nestedArrayValue));
+    
+    const encodeResult7 = qcsdk.encodeRlp(nestedArrayValue);
+    if (encodeResult7.error) {
+        console.error('Encoding error:', encodeResult7.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult7.result);
+        
+        const decodeResult7 = qcsdk.decodeRlp(encodeResult7.result);
+        if (decodeResult7.error) {
+            console.error('Decoding error:', decodeResult7.error);
+        } else {
+            const decoded = JSON.parse(decodeResult7.result);
+            console.log('Decoded value:', JSON.stringify(decoded));
+            console.log('Round-trip successful:', JSON.stringify(decoded) === JSON.stringify(nestedArrayValue));
+        }
+    }
+    console.log();
+
+    // Example 8: Encode and decode a large number (BigInt)
+    console.log('--- Example 8: Large Number (BigInt) ---');
+    const bigIntValue = '1000000000000000000'; // 1 ether in wei
+    console.log('Original value:', bigIntValue);
+    
+    const encodeResult8 = qcsdk.encodeRlp(bigIntValue);
+    if (encodeResult8.error) {
+        console.error('Encoding error:', encodeResult8.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult8.result);
+        
+        const decodeResult8 = qcsdk.decodeRlp(encodeResult8.result);
+        if (decodeResult8.error) {
+            console.error('Decoding error:', decodeResult8.error);
+        } else {
+            const decoded = JSON.parse(decodeResult8.result);
+            console.log('Decoded value:', decoded);
+        }
+    }
+    console.log();
+
+    // Example 9: Empty array
+    console.log('--- Example 9: Empty Array ---');
+    const emptyArrayValue = [];
+    console.log('Original value:', JSON.stringify(emptyArrayValue));
+    
+    const encodeResult9 = qcsdk.encodeRlp(emptyArrayValue);
+    if (encodeResult9.error) {
+        console.error('Encoding error:', encodeResult9.error);
+    } else {
+        console.log('Encoded (hex):', encodeResult9.result);
+        
+        const decodeResult9 = qcsdk.decodeRlp(encodeResult9.result);
+        if (decodeResult9.error) {
+            console.error('Decoding error:', decodeResult9.error);
+        } else {
+            const decoded = JSON.parse(decodeResult9.result);
+            console.log('Decoded value:', JSON.stringify(decoded));
+            console.log('Round-trip successful:', JSON.stringify(decoded) === JSON.stringify(emptyArrayValue));
+        }
+    }
+    console.log();
+
+    console.log('=== All Examples Completed ===');
+}
+
+// Run the examples
+main().catch(console.error);