quantumcoin 6.14.5 → 7.0.2

package/examples/example.js

@@ -0,0 +1,61 @@
+/**
+ * QuantumCoin.js Examples (non-transactional).
+ *
+ * Run:
+ * - `node examples/example.js`
+ *
+ * These examples only perform:
+ * - SDK initialization
+ * - Read-only JSON-RPC queries
+ * - Offline wallet operations (sign/encrypt)
+ * - Read-only contract call against the system staking contract
+ */
+
+const { Initialize } = require("../config");
+const qc = require("..");
+
+const RPC = "https://public.rpc.quantumcoinapi.com";
+const CHAIN_ID = 123123;
+const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00"; // 0x...1000
+
+async function main() {
+  const ok = await Initialize(null);
+  if (!ok) throw new Error("Initialize failed");
+
+  console.log("SDK initialized:", qc.isInitialized());
+
+  // Provider: basic read-only calls
+  const provider = new qc.JsonRpcProvider(RPC, CHAIN_ID);
+  const blockNumber = await provider.getBlockNumber();
+  console.log("Latest block:", blockNumber);
+
+  const block = await provider.getBlock("latest");
+  console.log("Latest block hash:", block.hash);
+
+  const balance = await provider.getBalance(STAKING_CONTRACT);
+  console.log("Staking contract balance (wei):", balance.toString());
+
+  // Wallet: offline operations
+  const wallet = qc.Wallet.createRandom();
+  console.log("Random wallet address:", wallet.address);
+  const sig = wallet.signMessageSync("Hello, QuantumCoin!");
+  console.log("Signed message signature:", sig.slice(0, 18) + "...");
+  const recovered = qc.verifyMessage("Hello, QuantumCoin!", sig);
+  console.log("Recovered address:", recovered);
+
+  const encrypted = wallet.encryptSync("mySecurePassword123");
+  console.log("Encrypted wallet JSON length:", encrypted.length);
+
+  // Contract: read-only call
+  const abi = require("../test/fixtures/StakingContract.abi.json");
+  const staking = new qc.Contract(STAKING_CONTRACT, abi, provider);
+  const depositorCount = await staking.getDepositorCount();
+  console.log("typeof depositorCount:", typeof depositorCount);
+  console.log("Depositor count:", depositorCount.toString());
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+

package/examples/package-lock.json

@@ -0,0 +1,57 @@
+{
+  "name": "quantumcoinjs-sdk-examples",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "quantumcoinjs-sdk-examples",
+      "version": "1.0.0",
+      "license": "MIT",
+      "dependencies": {
+        "quantum-coin-js-sdk": "^1.0.28",
+        "quantum-coin-pqc-js-sdk": "^1.0.5",
+        "quantumcoin": "file:.."
+      }
+    },
+    "..": {
+      "name": "quantumcoin",
+      "version": "7.0.2",
+      "license": "MIT",
+      "dependencies": {
+        "quantum-coin-js-sdk": "^1.0.28",
+        "quantum-coin-pqc-js-sdk": "^1.0.5",
+        "seed-words": "^1.0.2"
+      },
+      "bin": {
+        "quantumcoin-sdk-generator": "generate-sdk.js"
+      }
+    },
+    "node_modules/quantum-coin-js-sdk": {
+      "version": "1.0.28",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.28.tgz",
+      "integrity": "sha512-ok3kCoEecSWRLsFw285IDzz8Xvtc772BvBujeCasQ7G2f+Jwly6UFtjivyrh0gDPuZFwYU/hbaKvpb8OtkuM/Q==",
+      "license": "MIT",
+      "dependencies": {
+        "quantum-coin-pqc-js-sdk": "1.0.5",
+        "seed-words": "1.0.2"
+      }
+    },
+    "node_modules/quantum-coin-pqc-js-sdk": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/quantum-coin-pqc-js-sdk/-/quantum-coin-pqc-js-sdk-1.0.5.tgz",
+      "integrity": "sha512-9P1YDkca5CqrO7++TnGJZzPvYlBjYARopHgxYbDcEHgPicP7+tA8zD+DE1BooHp7sLEWF9ObklMj6AdaDUjDVw==",
+      "license": "MIT"
+    },
+    "node_modules/quantumcoin": {
+      "resolved": "..",
+      "link": true
+    },
+    "node_modules/seed-words": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/seed-words/-/seed-words-1.0.2.tgz",
+      "integrity": "sha512-ia58deuPjcR8DpJ8uIgZ7gqDnIWD8vnjb4jX/sEsIDcuQaH/AJj9J8L3DXkUHfUGqAq9Y6pVMuG90t3XUJH90g==",
+      "license": "MIT"
+    }
+  }
+}

package/examples/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "quantumcoinjs-sdk-examples",
+  "version": "1.0.0",
+  "description": "QuantumCoin.js SDK Examples",
+  "main": "example.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "QuantumCoin Community",
+  "license": "MIT",
+  "dependencies": {
+    "quantum-coin-js-sdk": "^1.0.28",
+    "quantum-coin-pqc-js-sdk": "^1.0.5",
+    "quantumcoin": "file:.."
+  }
+}

package/examples/read-operations.js

@@ -0,0 +1,27 @@
+/**
+ * Example: Read-only operations using JsonRpcProvider + Contract.
+ */
+
+const { Initialize } = require("../config");
+const { JsonRpcProvider, Contract } = require("..");
+
+const RPC = "https://public.rpc.quantumcoinapi.com";
+const CHAIN_ID = 123123;
+const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00"; // 0x...1000
+
+async function readOperations() {
+  await Initialize(null);
+
+  const provider = new JsonRpcProvider(RPC, CHAIN_ID);
+  const abi = require("../test/fixtures/StakingContract.abi.json");
+  const contract = new Contract(STAKING_CONTRACT, abi, provider);
+
+  const total = await contract.getTotalDepositedBalance();
+  console.log("Total deposited balance:", total.toString());
+}
+
+readOperations().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+

package/examples/sdk-generator-erc20.inline.json

@@ -0,0 +1,251 @@
+[
+  {
+    "name": "SimpleERC20",
+    "abi": [
+      {
+        "inputs": [
+          {
+            "internalType": "string",
+            "name": "_name",
+            "type": "string"
+          },
+          {
+            "internalType": "string",
+            "name": "_symbol",
+            "type": "string"
+          },
+          {
+            "internalType": "uint256",
+            "name": "_initialSupply",
+            "type": "uint256"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "constructor"
+      },
+      {
+        "anonymous": false,
+        "inputs": [
+          {
+            "indexed": true,
+            "internalType": "address",
+            "name": "owner",
+            "type": "address"
+          },
+          {
+            "indexed": true,
+            "internalType": "address",
+            "name": "spender",
+            "type": "address"
+          },
+          {
+            "indexed": false,
+            "internalType": "uint256",
+            "name": "value",
+            "type": "uint256"
+          }
+        ],
+        "name": "Approval",
+        "type": "event"
+      },
+      {
+        "anonymous": false,
+        "inputs": [
+          {
+            "indexed": true,
+            "internalType": "address",
+            "name": "from",
+            "type": "address"
+          },
+          {
+            "indexed": true,
+            "internalType": "address",
+            "name": "to",
+            "type": "address"
+          },
+          {
+            "indexed": false,
+            "internalType": "uint256",
+            "name": "value",
+            "type": "uint256"
+          }
+        ],
+        "name": "Transfer",
+        "type": "event"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "",
+            "type": "address"
+          },
+          {
+            "internalType": "address",
+            "name": "",
+            "type": "address"
+          }
+        ],
+        "name": "allowance",
+        "outputs": [
+          {
+            "internalType": "uint256",
+            "name": "",
+            "type": "uint256"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "spender",
+            "type": "address"
+          },
+          {
+            "internalType": "uint256",
+            "name": "value",
+            "type": "uint256"
+          }
+        ],
+        "name": "approve",
+        "outputs": [
+          {
+            "internalType": "bool",
+            "name": "",
+            "type": "bool"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "",
+            "type": "address"
+          }
+        ],
+        "name": "balanceOf",
+        "outputs": [
+          {
+            "internalType": "uint256",
+            "name": "",
+            "type": "uint256"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [],
+        "name": "decimals",
+        "outputs": [
+          {
+            "internalType": "uint8",
+            "name": "",
+            "type": "uint8"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [],
+        "name": "name",
+        "outputs": [
+          {
+            "internalType": "string",
+            "name": "",
+            "type": "string"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [],
+        "name": "symbol",
+        "outputs": [
+          {
+            "internalType": "string",
+            "name": "",
+            "type": "string"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [],
+        "name": "totalSupply",
+        "outputs": [
+          {
+            "internalType": "uint256",
+            "name": "",
+            "type": "uint256"
+          }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "to",
+            "type": "address"
+          },
+          {
+            "internalType": "uint256",
+            "name": "value",
+            "type": "uint256"
+          }
+        ],
+        "name": "transfer",
+        "outputs": [
+          {
+            "internalType": "bool",
+            "name": "",
+            "type": "bool"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "from",
+            "type": "address"
+          },
+          {
+            "internalType": "address",
+            "name": "to",
+            "type": "address"
+          },
+          {
+            "internalType": "uint256",
+            "name": "value",
+            "type": "uint256"
+          }
+        ],
+        "name": "transferFrom",
+        "outputs": [
+          {
+            "internalType": "bool",
+            "name": "",
+            "type": "bool"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function"
+      }
+    ],
+    "bin": "0x608060405234801561001057600080fd5b506040516108ab3803806108ab8339818101604052606081101561003357600080fd5b810190808051604051939291908464010000000082111561005357600080fd5b90830190602082018581111561006857600080fd5b825164010000000081118282018810171561008257600080fd5b82525081516020918201929091019080838360005b838110156100af578181015183820152602001610097565b50505050905090810190601f1680156100dc5780820380516001836020036101000a031916815260200191505b50604052602001805160405193929190846401000000008211156100ff57600080fd5b90830190602082018581111561011457600080fd5b825164010000000081118282018810171561012e57600080fd5b82525081516020918201929091019080838360005b8381101561015b578181015183820152602001610143565b50505050905090810190601f1680156101885780820380516001836020036101000a031916815260200191505b5060405260209081015185519093506101a79250600091860190610264565b5081516101bb906001906020850190610264565b506101c633826101ce565b505050610305565b8161020f576040805162461bcd60e51b815260206004820152600c60248201526b4d494e545f544f5f5a45524f60a01b604482015290519081900360640190fd5b60028054820190556000828152600360209081526040808320805485019055805184815290518593927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef928290030190a35050565b828054600181600116156101000203166002900490600052602060002090601f01602090048101928261029a57600085556102e0565b82601f106102b357805160ff19168380011785556102e0565b828001600101855582156102e0579182015b828111156102e05782518255916020019190600101906102c5565b506102ec9291506102f0565b5090565b5b808211156102ec57600081556001016102f1565b610597806103146000396000f3fe608060405234801561001057600080fd5b50600436106100935760003560e01c8063313ce56711610066578063313ce5671461018f57806370a08231146101ad57806395d89b41146101ca578063a9059cbb146101d2578063dd62ed3e146101f557610093565b806306fdde0314610098578063095ea7b31461011557806318160ddd1461014c57806323b872dd14610166575b600080fd5b6100a0610218565b6040805160208082528351818301528351919283929083019185019080838360005b838110156100da5781810151838201526020016100c2565b50505050905090810190601f1680156101075780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6101386004803603604081101561012b57600080fd5b50803590602001356102a6565b604080519115158252519081900360200190f35b610154610301565b60408051918252519081900360200190f35b6101386004803603606081101561017c57600080fd5b5080359060208101359060400135610307565b6101976103d6565b6040805160ff9092168252519081900360200190f35b610154600480360360208110156101c357600080fd5b50356103db565b6100a06103ed565b610138600480360360408110156101e857600080fd5b5080359060200135610447565b6101546004803603604081101561020b57600080fd5b508035906020013561045d565b6000805460408051602060026001851615610100026000190190941693909304601f8101849004840282018401909252818152929183018282801561029e5780601f106102735761010080835404028352916020019161029e565b820191906000526020600020905b81548152906001019060200180831161028157829003601f168201915b505050505081565b3360008181526004602090815260408083208684528252808320859055805185815290519293869390927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925928290030190a350600192915050565b60025481565b600083815260046020908152604080832033845290915281205482811015610362576040805162461bcd60e51b8152602060048201526009602482015268414c4c4f57414e434560b81b604482015290519081900360640190fd5b60001981146103c05760008581526004602090815260408083203380855290835292819020868503908190558151908152905188927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925928290030190a35b6103cb85858561047a565b506001949350505050565b601281565b60036020526000908152604090205481565b60018054604080516020600284861615610100026000190190941693909304601f8101849004840282018401909252818152929183018282801561029e5780601f106102735761010080835404028352916020019161029e565b600061045433848461047a565b50600192915050565b600460209081526000928352604080842090915290825290205481565b816104b6576040805162461bcd60e51b8152602060048201526007602482015266544f5f5a45524f60c81b604482015290519081900360640190fd5b60008381526003602052604090205481811015610504576040805162461bcd60e51b815260206004820152600760248201526642414c414e434560c81b604482015290519081900360640190fd5b600084815260036020908152604080832085850390558583529182902080548501905581518481529151859287927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef92918290030190a35050505056fea26469706673582212202ed1f601becde0e5fba43ade631c5e20fa87ca86747a7c41488643b1eb14a89664736f6c63430007060033"
+  }
+]

package/examples/solidity-types.ts

@@ -0,0 +1,43 @@
+/**
+ * TypeScript-only example: core Solidity types.
+ *
+ * This file is intended for developers using QuantumCoin.js from TypeScript.
+ * It is not executed by `npm run example`.
+ */
+
+import type {
+  AddressLike,
+  BigNumberish,
+  BytesLike,
+  SolidityInputValue,
+  SolidityOutputValue,
+  SolidityTypeName,
+} from "quantumcoin/types";
+
+// AddressLike is currently a string (32-byte QuantumCoin address).
+const addr: AddressLike = "0x0000000000000000000000000000000000000000000000000000000000001000";
+
+// BigNumberish is accepted for uint/int inputs (string | number | bigint).
+const amount: BigNumberish = "123";
+
+// BytesLike is a hex string or Uint8Array.
+const data: BytesLike = "0x1234";
+
+// Generic mappings for ABI input/output values:
+type T1 = SolidityInputValue<"uint256">; // BigNumberish
+type T2 = SolidityOutputValue<"uint256">; // bigint
+type T3 = SolidityInputValue<"address">; // AddressLike
+type T4 = SolidityOutputValue<"address">; // string
+
+// Example: using SolidityTypeName
+const t: SolidityTypeName = "bytes32";
+
+void addr;
+void amount;
+void data;
+void t;
+void (null as any as T1);
+void (null as any as T2);
+void (null as any as T3);
+void (null as any as T4);
+

package/examples/wallet-offline.js

@@ -0,0 +1,29 @@
+/**
+ * Example: Offline wallet operations (no blockchain connectivity required).
+ */
+
+const { Initialize } = require("../config");
+const { Wallet, verifyMessage } = require("..");
+
+async function walletOffline() {
+  await Initialize(null);
+
+  const wallet = Wallet.createRandom();
+  console.log("Wallet address:", wallet.address);
+
+  const msg = "Hello, QuantumCoin!";
+  const sig = wallet.signMessageSync(msg);
+  console.log("Signature:", sig.slice(0, 18) + "...");
+
+  const recovered = verifyMessage(msg, sig);
+  console.log("Recovered address:", recovered);
+
+  const json = wallet.encryptSync("mySecurePassword123");
+  console.log("Encrypted wallet JSON length:", json.length);
+}
+
+walletOffline().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+