quantum-coin-js-sdk 1.0.36 → 1.0.39

package/example/node_modules/quantumcoin/examples/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "quantumcoinjs-sdk-examples",
+  "version": "1.0.1",
+  "description": "QuantumCoin.js SDK Examples",
+  "main": "example.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "example": "node example.js",
+    "example:ts": "npx tsx example.ts",
+    "example:wallet": "node wallet-offline.js",
+    "example:wallet:ts": "npx tsx wallet-offline.ts",
+    "example:read": "node read-operations.js",
+    "example:read:ts": "npx tsx read-operations.ts",
+    "example:events": "node events.js",
+    "example:events:ts": "npx tsx events.ts",
+    "example:offline-signing": "node offline-signing.js",
+    "example:offline-signing:ts": "npx tsx offline-signing.ts",
+    "example:generator-js": "node example-generator-sdk-js.js",
+    "example:generator-js:ts": "npx tsx example-generator-sdk-js.ts",
+    "example:generator-ts": "node example-generator-sdk-ts.js",
+    "example:generator-ts:ts": "npx tsx example-generator-sdk-ts.ts"
+  },
+  "author": "QuantumCoin Community",
+  "license": "MIT",
+  "devDependencies": {
+    "tsx": "^4.19.0"
+  },
+  "dependencies": {
+    "quantum-coin-js-sdk": "1.0.36",
+    "quantumcoin": "file:.."
+  }
+}

package/example/node_modules/quantumcoin/examples/read-operations.js

@@ -0,0 +1,32 @@
+/**
+ * Example: Read-only operations using JsonRpcProvider + Contract.
+ * Run with VERBOSE=1 for addresses and operation details.
+ */
+
+const { Initialize } = require("../config");
+const { getProvider, Contract } = require("..");
+const { logExample, logAddress } = require("../test/verbose-logger");
+
+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() {
+  logExample("read-operations.js", "starting", { rpc: RPC, chainId: CHAIN_ID });
+  await Initialize(null);
+
+  const provider = getProvider(RPC, CHAIN_ID);
+  logAddress("staking_contract", STAKING_CONTRACT);
+  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());
+  logExample("read-operations.js", "getTotalDepositedBalance", { total: total.toString() });
+}
+
+readOperations().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+

package/example/node_modules/quantumcoin/examples/read-operations.ts

@@ -0,0 +1,31 @@
+/**
+ * Example: Read-only operations (JsonRpcProvider + Contract) - TypeScript.
+ * Run: npx tsx examples/read-operations.ts
+ */
+
+import { Initialize } from "../config";
+import { getProvider, Contract } from "..";
+import { logExample, logAddress } from "../test/verbose-logger";
+
+const RPC = "https://public.rpc.quantumcoinapi.com";
+const CHAIN_ID = 123123;
+const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00";
+
+async function readOperations(): Promise<void> {
+  logExample("read-operations.ts", "starting", { rpc: RPC, chainId: CHAIN_ID });
+  await Initialize(null);
+
+  const provider = getProvider(RPC, CHAIN_ID);
+  logAddress("staking_contract", STAKING_CONTRACT);
+  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());
+  logExample("read-operations.ts", "getTotalDepositedBalance", { total: total.toString() });
+}
+
+readOperations().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});

package/example/node_modules/quantumcoin/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/example/node_modules/quantumcoin/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/example/node_modules/quantumcoin/examples/wallet-offline.js

@@ -0,0 +1,36 @@
+/**
+ * Example: Offline wallet operations (no blockchain connectivity required).
+ * Run with VERBOSE=1 for wallet addresses and recovered address.
+ */
+
+const { Initialize } = require("../config");
+const { Wallet } = require("..");
+const { logExample, logAddress } = require("../test/verbose-logger");
+
+async function walletOffline() {
+  logExample("wallet-offline.js", "starting");
+  await Initialize(null);
+
+  const wallet = Wallet.createRandom();
+  console.log("Wallet address:", wallet.address);
+  logAddress("wallet", wallet.address);
+
+  const json = wallet.encryptSync("mySecurePassword123");
+  console.log("Encrypted wallet JSON length:", json.length);
+  logExample("wallet-offline.js", "encryptSync", { jsonLength: json.length });
+
+  // Encrypt a raw seed (pre-expansion format) and restore it
+  const seed = [51,214,149,165,206,96,227,5,173,247,83,219,210,2,221,2,4,48,117,55,88,109,241,204,31,62,23,128,47,21,168,247,28,118,30,185,229,255,17,27,34,107,225,138,254,156,55,9,253,255,142,148,234,189,232,43,173,84,159,108,8,35,58,77];
+  const seedJson = Wallet.encryptSeedSync(seed, "mySecurePassword123");
+  console.log("Seed-encrypted wallet JSON length:", seedJson.length);
+  const restored = Wallet.fromEncryptedJsonSync(seedJson, "mySecurePassword123");
+  console.log("Restored from seed address:", restored.address);
+  logExample("wallet-offline.js", "encryptSeedSync", { jsonLength: seedJson.length });
+  logAddress("restored", restored.address);
+}
+
+walletOffline().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+

package/example/node_modules/quantumcoin/examples/wallet-offline.ts

@@ -0,0 +1,26 @@
+/**
+ * Example: Offline wallet operations (no blockchain) - TypeScript.
+ * Run: npx tsx examples/wallet-offline.ts
+ */
+
+import { Initialize } from "../config";
+import { Wallet } from "..";
+import { logExample, logAddress } from "../test/verbose-logger";
+
+async function walletOffline(): Promise<void> {
+  logExample("wallet-offline.ts", "starting");
+  await Initialize(null);
+
+  const wallet = Wallet.createRandom();
+  console.log("Wallet address:", wallet.address);
+  logAddress("wallet", wallet.address);
+
+  const json = wallet.encryptSync("mySecurePassword123");
+  console.log("Encrypted wallet JSON length:", json.length);
+  logExample("wallet-offline.ts", "encryptSync", { jsonLength: json.length });
+}
+
+walletOffline().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});