quantumcoin 7.0.14 → 8.0.0

package/test/e2e/typed-generator.e2e.test.ts

@@ -1,337 +0,0 @@
-/**
- * @testCategory e2e
- * @blockchainRequired write
- * @transactional true
- * End-to-end test for the typed contract generator.
- */
-
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import { execFileSync, spawnSync } from "node:child_process";
-
-import { getRpcUrl, getChainId, getSolcPath, assertSolcExists, logE2eConfig } from "./helpers";
-import { logSuite, logTest } from "../verbose-logger";
-
-function getNpmCmd(): string {
-  return process.platform === "win32" ? "npm.cmd" : "npm";
-}
-
-function run(cmd: string, args: string[], cwd: string, env: NodeJS.ProcessEnv): { status: number | null; stdout: string; stderr: string; error?: Error } {
-  const res = spawnSync(cmd, args, {
-    cwd,
-    env,
-    encoding: "utf8",
-    stdio: "pipe",
-    shell: false,
-    windowsHide: true,
-  });
-  if (res.error) throw res.error;
-  return res;
-}
-
-function _quoteIfNeeded(s: unknown): string {
-  if (typeof s !== "string") return String(s);
-  return /[ \t"]/g.test(s) ? `"${s.replace(/"/g, '\\"')}"` : s;
-}
-
-function runNpm(args: string[], cwd: string, env: NodeJS.ProcessEnv) {
-  if (process.platform === "win32") {
-    const cmd = `${getNpmCmd()} ${args.map(_quoteIfNeeded).join(" ")}`;
-    return run("cmd.exe", ["/d", "/s", "/c", cmd], cwd, env);
-  }
-  return run(getNpmCmd(), args, cwd, env);
-}
-
-function compileSolidity({ solcPath, solPath, contractName }: { solcPath: string; solPath: string; contractName: string }) {
-  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
-  const parsed = JSON.parse(out);
-  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(`:${contractName}`));
-  if (!key) throw new Error(`Compiled contract ${contractName} not found in solc output`);
-  const c = parsed.contracts[key];
-  const abi = JSON.parse(c.abi);
-  const bin = c.bin || "";
-  return { abi, bin };
-}
-
-describe("typed contract generator package e2e", () => {
-  it("generates a package and runs its transactional tests", async (t: { skip: (msg: string) => void }) => {
-    logSuite("typed contract generator package e2e");
-    logTest("generates a package and runs its transactional tests", {});
-    const rpcUrl = getRpcUrl();
-    if (!rpcUrl) {
-      t.skip("QC_RPC_URL not provided");
-      return;
-    }
-    logE2eConfig();
-    const chainId = getChainId();
-    const solcPath = getSolcPath();
-    assertSolcExists(solcPath);
-
-    const repoRoot = path.resolve(__dirname, "..", "..");
-    const fixtureSol = path.join(repoRoot, "test", "fixtures", "ConstructorParam.sol");
-    const contractName = "ConstructorParam";
-
-    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-"));
-    const pkgName = `qcgen-${Date.now()}`;
-    const pkgDir = tmpBase;
-    const pkgRoot = path.join(pkgDir, pkgName);
-
-    let succeeded = false;
-    try {
-      const { abi, bin } = compileSolidity({ solcPath, solPath: fixtureSol, contractName });
-
-      const abiPath = path.join(tmpBase, `${contractName}.abi.json`);
-      const binPath = path.join(tmpBase, `${contractName}.bin`);
-      fs.writeFileSync(abiPath, JSON.stringify(abi, null, 2), "utf8");
-      fs.writeFileSync(binPath, bin.trim().startsWith("0x") ? bin.trim() : `0x${bin.trim()}`, "utf8");
-
-      const generatorCli = path.join(repoRoot, "generate-sdk.js");
-      const gen = run(
-        process.execPath,
-        [
-          generatorCli,
-          "--abi", abiPath,
-          "--bin", binPath,
-          "--name", contractName,
-          "--create-package",
-          "--package-dir", pkgDir,
-          "--package-name", pkgName,
-          "--package-description", "Temporary typed-contract package generated by quantumcoin.js e2e tests",
-          "--package-author", "quantumcoin.js test",
-          "--package-license", "MIT",
-          "--package-version", "0.0.1",
-          "--non-interactive",
-        ],
-        repoRoot,
-        process.env,
-      );
-      assert.equal(gen.status, 0, `generator failed:\n${gen.stdout}\n${gen.stderr}`);
-
-      assert.ok(fs.existsSync(path.join(pkgRoot, "package.json")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "tsconfig.json")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", `${contractName}.ts`)));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", `${contractName}__factory.ts`)));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", `${contractName}.e2e.test.js`)));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "deploy.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "read-operations.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "write-operations.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "events.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.d.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "README.md")));
-
-      const readme = fs.readFileSync(path.join(pkgRoot, "README.md"), "utf8");
-      assert.ok(readme.includes(contractName));
-
-      if (!fs.existsSync(path.join(pkgRoot, "node_modules"))) {
-        const install = runNpm(["install", "--no-fund", "--no-audit"], pkgRoot, process.env);
-        assert.equal(install.status, 0, `npm install failed:\n${install.stdout}\n${install.stderr}`);
-      }
-
-      const env = { ...process.env, QC_RPC_URL: rpcUrl, QC_CHAIN_ID: String(chainId) };
-      const testRun = runNpm(["test"], pkgRoot, env);
-      assert.equal(testRun.status, 0, `generated package tests failed:\n${testRun.stdout}\n${testRun.stderr}`);
-
-      succeeded = true;
-    } finally {
-      if (succeeded) {
-        fs.rmSync(tmpBase, { recursive: true, force: true });
-      } else {
-        console.error("Generated package kept at:", pkgRoot);
-      }
-    }
-  }, { timeout: 1_800_000 });
-
-  it("generates a package from artifacts JSON input (multiple contracts) and runs its transactional tests", async (t: { skip: (msg: string) => void }) => {
-    const rpcUrl = getRpcUrl();
-    if (!rpcUrl) {
-      t.skip("QC_RPC_URL not provided");
-      return;
-    }
-
-    const chainId = getChainId();
-    const solcPath = getSolcPath();
-    assertSolcExists(solcPath);
-
-    const repoRoot = path.resolve(__dirname, "..", "..");
-    const fixtureCtorSol = path.join(repoRoot, "test", "fixtures", "ConstructorParam.sol");
-    const fixtureMultiSol = path.join(repoRoot, "test", "fixtures", "MultiContracts.sol");
-
-    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-json-"));
-    const pkgName = `qcgen-json-${Date.now()}`;
-    const pkgDir = tmpBase;
-    const pkgRoot = path.join(pkgDir, pkgName);
-
-    let succeeded = false;
-    try {
-      const ctorName = "ConstructorParam";
-      const alphaName = "Alpha";
-
-      const { abi: ctorAbi, bin: ctorBin } = compileSolidity({ solcPath, solPath: fixtureCtorSol, contractName: ctorName });
-      const { abi: alphaAbi, bin: alphaBin } = compileSolidity({ solcPath, solPath: fixtureMultiSol, contractName: alphaName });
-
-      const ctorAbiPath = path.join(tmpBase, `${ctorName}.abi.json`);
-      const ctorBinPath = path.join(tmpBase, `${ctorName}.bin`);
-      fs.writeFileSync(ctorAbiPath, JSON.stringify(ctorAbi, null, 2), "utf8");
-      fs.writeFileSync(ctorBinPath, ctorBin.trim().startsWith("0x") ? ctorBin.trim() : `0x${ctorBin.trim()}`, "utf8");
-
-      const alphaAbiPath = path.join(tmpBase, `${alphaName}.abi.json`);
-      const alphaBinPath = path.join(tmpBase, `${alphaName}.bin`);
-      fs.writeFileSync(alphaAbiPath, JSON.stringify(alphaAbi, null, 2), "utf8");
-      fs.writeFileSync(alphaBinPath, alphaBin.trim().startsWith("0x") ? alphaBin.trim() : `0x${alphaBin.trim()}`, "utf8");
-
-      const artifactsJsonPath = path.join(tmpBase, "artifacts.json");
-      fs.writeFileSync(
-        artifactsJsonPath,
-        JSON.stringify(
-          [
-            { abi: path.basename(alphaAbiPath), bin: path.basename(alphaBinPath) },
-            { abi: path.basename(ctorAbiPath), bin: path.basename(ctorBinPath) },
-          ],
-          null,
-          2,
-        ),
-        "utf8",
-      );
-
-      const generatorCli = path.join(repoRoot, "generate-sdk.js");
-      const gen = run(
-        process.execPath,
-        [
-          generatorCli,
-          "--artifacts-json", artifactsJsonPath,
-          "--create-package",
-          "--package-dir", pkgDir,
-          "--package-name", pkgName,
-          "--package-description", "Temporary typed-contract package generated from artifacts JSON input",
-          "--package-author", "quantumcoin.js test",
-          "--package-license", "MIT",
-          "--package-version", "0.0.1",
-          "--non-interactive",
-        ],
-        repoRoot,
-        process.env,
-      );
-      assert.equal(gen.status, 0, `generator failed:\n${gen.stdout}\n${gen.stderr}`);
-
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Alpha.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Alpha__factory.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "ConstructorParam.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "ConstructorParam__factory.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "index.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.d.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "README.md")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "Alpha.e2e.test.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "ConstructorParam.e2e.test.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "all-contracts.e2e.test.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "deploy-Alpha.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "deploy-ConstructorParam.js")));
-
-      const readme = fs.readFileSync(path.join(pkgRoot, "README.md"), "utf8");
-      assert.ok(readme.includes("Alpha"));
-      assert.ok(readme.includes("ConstructorParam"));
-
-      if (!fs.existsSync(path.join(pkgRoot, "node_modules"))) {
-        const install = runNpm(["install", "--no-fund", "--no-audit"], pkgRoot, process.env);
-        assert.equal(install.status, 0, `npm install failed:\n${install.stdout}\n${install.stderr}`);
-      }
-
-      const env = { ...process.env, QC_RPC_URL: rpcUrl, QC_CHAIN_ID: String(chainId) };
-      const testRun = runNpm(["test"], pkgRoot, env);
-      assert.equal(testRun.status, 0, `generated package tests failed:\n${testRun.stdout}\n${testRun.stderr}`);
-
-      succeeded = true;
-    } finally {
-      if (succeeded) {
-        fs.rmSync(tmpBase, { recursive: true, force: true });
-      } else {
-        console.error("Generated package kept at:", pkgRoot);
-      }
-    }
-  }, { timeout: 1_800_000 });
-
-  it("generates a package from Solidity input (multiple contracts) and runs its transactional tests", async (t: { skip: (msg: string) => void }) => {
-    const rpcUrl = getRpcUrl();
-    if (!rpcUrl) {
-      t.skip("QC_RPC_URL not provided");
-      return;
-    }
-
-    const chainId = getChainId();
-    const solcPath = getSolcPath();
-    assertSolcExists(solcPath);
-
-    const repoRoot = path.resolve(__dirname, "..", "..");
-    const fixtureSol = path.join(repoRoot, "test", "fixtures", "MultiContracts.sol");
-
-    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-sol-"));
-    const pkgName = `qcgen-sol-${Date.now()}`;
-    const pkgDir = tmpBase;
-    const pkgRoot = path.join(pkgDir, pkgName);
-
-    let succeeded = false;
-    try {
-      const generatorCli = path.join(repoRoot, "generate-sdk.js");
-      const gen = run(
-        process.execPath,
-        [
-          generatorCli,
-          "--sol", fixtureSol,
-          "--solc", solcPath,
-          "--create-package",
-          "--package-dir", pkgDir,
-          "--package-name", pkgName,
-          "--package-description", "Temporary typed-contract package generated from Solidity input",
-          "--package-author", "quantumcoin.js test",
-          "--package-license", "MIT",
-          "--package-version", "0.0.1",
-          "--non-interactive",
-        ],
-        repoRoot,
-        process.env,
-      );
-      assert.equal(gen.status, 0, `generator failed:\n${gen.stdout}\n${gen.stderr}`);
-
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Alpha.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Alpha__factory.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Beta.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "Beta__factory.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "src", "index.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "index.d.ts")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "README.md")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "artifacts", "Alpha.abi.json")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "artifacts", "Alpha.bin")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "artifacts", "Beta.abi.json")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "artifacts", "Beta.bin")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "Alpha.e2e.test.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "Beta.e2e.test.js")));
-      assert.ok(fs.existsSync(path.join(pkgRoot, "test", "e2e", "all-contracts.e2e.test.js")));
-
-      const alphaTs = fs.readFileSync(path.join(pkgRoot, "src", "Alpha.ts"), "utf8");
-      assert.ok(alphaTs.includes("Alpha contract for multi-contract generator test."));
-      assert.ok(alphaTs.includes("Set a new value in Alpha."));
-
-      if (!fs.existsSync(path.join(pkgRoot, "node_modules"))) {
-        const install = runNpm(["install", "--no-fund", "--no-audit"], pkgRoot, process.env);
-        assert.equal(install.status, 0, `npm install failed:\n${install.stdout}\n${install.stderr}`);
-      }
-
-      const env = { ...process.env, QC_RPC_URL: rpcUrl, QC_CHAIN_ID: String(chainId) };
-      const testRun = runNpm(["test"], pkgRoot, env);
-      assert.equal(testRun.status, 0, `generated package tests failed:\n${testRun.stdout}\n${testRun.stderr}`);
-
-      succeeded = true;
-    } finally {
-      if (succeeded) {
-        fs.rmSync(tmpBase, { recursive: true, force: true });
-      } else {
-        console.error("Generated package kept at:", pkgRoot);
-      }
-    }
-  }, { timeout: 1_800_000 });
-});

package/test/fixtures/ConstructorParam.sol

@@ -1,23 +0,0 @@
-// SPDX-License-Identifier: MIT
-// NOTE: Intentionally no `pragma` to allow compilation with different solc versions.
-
-/**
- * @title ConstructorParam
- * @notice Example contract used by generator E2E tests.
- */
-contract ConstructorParam {
-    uint256 public value;
-
-    event ValueChanged(uint256 newValue);
-
-    constructor(uint256 initialValue) {
-        value = initialValue;
-    }
-
-    /// @notice Set a new stored value.
-    function set(uint256 newValue) public {
-        value = newValue;
-        emit ValueChanged(newValue);
-    }
-}
-

package/test/fixtures/MultiContracts.sol

@@ -1,37 +0,0 @@
-// SPDX-License-Identifier: MIT
-// NOTE: Intentionally no `pragma` to allow compilation with different solc versions.
-
-/**
- * @title Alpha
- * @notice Alpha contract for multi-contract generator test.
- */
-contract Alpha {
-    uint256 public value;
-
-    constructor(uint256 initialValue) {
-        value = initialValue;
-    }
-
-    /// @notice Set a new value in Alpha.
-    function set(uint256 newValue) public {
-        value = newValue;
-    }
-}
-
-/**
- * @title Beta
- * @notice Beta contract for multi-contract generator test.
- */
-contract Beta {
-    uint256 public value;
-
-    constructor(uint256 initialValue) {
-        value = initialValue;
-    }
-
-    /// @notice Set a new value in Beta.
-    function set(uint256 newValue) public {
-        value = newValue;
-    }
-}
-

package/test/fixtures/SimpleStorage.sol

@@ -1,18 +0,0 @@
-// SPDX-License-Identifier: MIT
-// NOTE: Intentionally no `pragma` to allow compilation with different solc versions.
-
-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;
-    }
-}
-

package/test/fixtures/StakingContract.abi.json

@@ -1 +0,0 @@
-[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":true,"internalType":"address","name":"oldValidatorAddress","type":"address"},{"indexed":true,"internalType":"address","name":"newValidatorAddress","type":"address"}],"name":"OnChangeValidator","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"withdrawalQuantity","type":"uint256"}],"name":"OnCompletePartialWithdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"netBalance","type":"uint256"}],"name":"OnCompleteWithdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"oldBalance","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newBalance","type":"uint256"}],"name":"OnIncreaseDeposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"withdrawalBlock","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"withdrawalQuantity","type":"uint256"}],"name":"OnInitiatePartialWithdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":true,"internalType":"address","name":"validatorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"blockNumber","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"blockTime","type":"uint256"}],"name":"OnNewDeposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"address","name":"validatorAddress","type":"address"}],"name":"OnPauseValidation","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"address","name":"validatorAddress","type":"address"}],"name":"OnResumeValidation","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"rewardAmount","type":"uint256"}],"name":"OnReward","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"depositorAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"slashedAmount","type":"uint256"}],"name":"OnSlashing","type":"event"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"},{"internalType":"uint256","name":"rewardAmount","type":"uint256"}],"name":"addDepositorReward","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"},{"internalType":"uint256","name":"slashAmount","type":"uint256"}],"name":"addDepositorSlashing","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newValidatorAddress","type":"address"}],"name":"changeValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"completePartialWithdrawal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"completeWithdrawal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"didDepositorEverExist","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"didValidatorEverExist","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"doesDepositorExist","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"doesValidatorExist","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getBalanceOfDepositor","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getDepositorCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"getDepositorOfValidator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getDepositorRewards","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getDepositorSlashings","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getNetBalanceOfDepositor","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"getStakingDetails","outputs":[{"components":[{"internalType":"address","name":"Depositor","type":"address"},{"internalType":"address","name":"Validator","type":"address"},{"internalType":"uint256","name":"Balance","type":"uint256"},{"internalType":"uint256","name":"NetBalance","type":"uint256"},{"internalType":"uint256","name":"BlockRewards","type":"uint256"},{"internalType":"uint256","name":"Slashings","type":"uint256"},{"internalType":"bool","name":"IsValidationPaused","type":"bool"},{"internalType":"uint256","name":"WithdrawalBlock","type":"uint256"},{"internalType":"uint256","name":"WithdrawalAmount","type":"uint256"},{"internalType":"uint256","name":"LastNilBlockNumber","type":"uint256"},{"internalType":"uint256","name":"NilBlockCount","type":"uint256"}],"internalType":"struct IStakingContract.StakingDetails","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTotalDepositedBalance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getValidatorOfDepositor","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"depositorAddress","type":"address"}],"name":"getWithdrawalBlock","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"increaseDeposit","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"initiatePartialWithdrawal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"isValidationPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"listValidators","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"newDeposit","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"pauseValidation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"resetNilBlock","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"resumeValidation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validatorAddress","type":"address"}],"name":"setNilBlock","outputs":[],"stateMutability":"nonpayable","type":"function"}]

package/test/integration/ipc-provider.test.js

@@ -1,49 +0,0 @@
-/**
- * @testCategory integration
- * @blockchainRequired readonly
- * @transactional false
- * @description Read-only IPC JSON-RPC integration tests against a local geth IPC endpoint
- * Run with VERBOSE=1 for test names, block number/hash.
- */
-
-const { describe, it } = require("node:test");
-const assert = require("node:assert/strict");
-
-const qc = require("../../index");
-const { logSuite, logTest } = require("../verbose-logger");
-
-const IPC = process.env.QC_ENDPOINT || process.env.QC_IPC_PATH || "\\\\.\\pipe\\geth.ipc";
-
-describe("IpcSocketProvider (readonly)", () => {
-  it("getBlockNumber and getBlock('latest') work over IPC", async (t) => {
-    logSuite("IpcSocketProvider (readonly)");
-    logTest("getBlockNumber and getBlock('latest') work over IPC", { endpoint: IPC });
-    const provider = qc.getProvider(IPC);
-    try {
-      const bn = await provider.getBlockNumber();
-      logTest("getBlockNumber (ipc)", { blockNumber: bn });
-      assert.ok(Number.isInteger(bn) && bn >= 0);
-
-      const latest = await provider.getBlock("latest");
-      logTest("getBlock('latest') (ipc)", { blockNumber: latest.number, blockHash: latest.hash });
-      assert.ok(latest && typeof latest === "object");
-      assert.ok(typeof latest.number === "number" && latest.number >= bn);
-      // best-effort sanity: hash often exists on latest blocks
-      assert.ok(latest.hash == null || typeof latest.hash === "string");
-
-      // Print a JSON-safe summary (avoid circular refs like latest.provider)
-      const latestSummary = {
-        number: latest.number,
-        hash: latest.hash,
-        parentHash: latest.parentHash,
-        timestamp: latest.timestamp,
-        transactionsCount: Array.isArray(latest.transactions) ? latest.transactions.length : null,
-      };
-      // This shows up in TAP output as "# ..."
-      console.log("IPC latest block:", JSON.stringify(latestSummary));
-    } catch (e) {
-      t.skip(`IPC endpoint unavailable (${IPC}): ${e && e.message ? e.message : String(e)}`);
-    }
-  });
-});
-

package/test/integration/ipc-provider.test.ts

@@ -1,44 +0,0 @@
-/**
- * @testCategory integration
- * @blockchainRequired readonly
- * @transactional false
- * @description Read-only IPC JSON-RPC integration tests against a local geth IPC endpoint
- */
-
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-
-import qc from "../../index";
-import { logSuite, logTest } from "../verbose-logger";
-
-const IPC = process.env.QC_ENDPOINT || process.env.QC_IPC_PATH || "\\\\.\\pipe\\geth.ipc";
-
-describe("IpcSocketProvider (readonly)", () => {
-  it("getBlockNumber and getBlock('latest') work over IPC", async (t: { skip: (msg: string) => void }) => {
-    logSuite("IpcSocketProvider (readonly)");
-    logTest("getBlockNumber and getBlock('latest') work over IPC", { endpoint: IPC });
-    const provider = qc.getProvider(IPC);
-    try {
-      const bn = await provider.getBlockNumber();
-      logTest("getBlockNumber (ipc)", { blockNumber: bn });
-      assert.ok(Number.isInteger(bn) && bn >= 0);
-
-      const latest = await provider.getBlock("latest");
-      logTest("getBlock('latest') (ipc)", { blockNumber: latest.number, blockHash: latest.hash });
-      assert.ok(latest && typeof latest === "object");
-      assert.ok(typeof latest.number === "number" && latest.number >= bn);
-      assert.ok(latest.hash == null || typeof latest.hash === "string");
-
-      const latestSummary = {
-        number: latest.number,
-        hash: latest.hash,
-        parentHash: latest.parentHash,
-        timestamp: latest.timestamp,
-        transactionsCount: Array.isArray(latest.transactions) ? latest.transactions.length : null,
-      };
-      console.log("IPC latest block:", JSON.stringify(latestSummary));
-    } catch (e) {
-      t.skip(`IPC endpoint unavailable (${IPC}): ${e && (e as Error).message ? (e as Error).message : String(e)}`);
-    }
-  });
-});

package/test/integration/provider.test.js

@@ -1,88 +0,0 @@
-/**
- * @testCategory integration
- * @blockchainRequired readonly
- * @transactional false
- * @description Read-only integration tests. Endpoint from QC_ENDPOINT or QC_RPC_URL (default: public RPC).
- * Works with HTTP, WebSocket, or IPC; use QC_ENDPOINT=\\.\pipe\geth.ipc to run over IPC.
- * Run with VERBOSE=1 or QC_VERBOSE=1 for test names, addresses, block numbers.
- */
-
-const { describe, it } = require("node:test");
-const assert = require("node:assert/strict");
-
-const { Initialize } = require("../../config");
-const qc = require("../../index");
-const { logSuite, logTest, logAddress } = require("../verbose-logger");
-
-const DEFAULT_RPC = "https://public.rpc.quantumcoinapi.com";
-const CHAIN_ID = 123123;
-const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00"; // ...1000 (32-byte address)
-
-const ENDPOINT = process.env.QC_ENDPOINT || process.env.QC_RPC_URL || DEFAULT_RPC;
-const isPublicRpc = ENDPOINT === DEFAULT_RPC;
-
-describe("Provider (readonly)", () => {
-  it("getBlockNumber returns a block number", async (t) => {
-    logSuite("Provider (readonly)");
-    logTest("getBlockNumber returns a block number", { endpoint: ENDPOINT, chainId: CHAIN_ID });
-    const provider = qc.getProvider(ENDPOINT, CHAIN_ID);
-    try {
-      const bn = await provider.getBlockNumber();
-      logTest("getBlockNumber returns a block number", { blockNumber: bn });
-      assert.ok(Number.isInteger(bn) && bn >= 0);
-      if (isPublicRpc) assert.ok(bn > 3000000, "public chain height");
-    } catch (e) {
-      t.skip(`network unavailable: ${e && e.message ? e.message : String(e)}`);
-    }
-  });
-
-  it("getBlock('latest') works", async (t) => {
-    logTest("getBlock('latest') works", {});
-    const provider = qc.getProvider(ENDPOINT, CHAIN_ID);
-    try {
-      const latest = await provider.getBlockNumber();
-      const block = await provider.getBlock("latest");
-      logTest("getBlock('latest') works", { blockNumber: block.number, blockHash: block.hash });
-      assert.ok(block && typeof block === "object");
-      assert.ok(typeof block.number === "number" && block.number >= latest);
-      if (isPublicRpc && latest >= 3386000) {
-        const b = await provider.getBlock(3386000);
-        assert.equal(b.number, 3386000);
-      }
-    } catch (e) {
-      t.skip(`network unavailable: ${e && e.message ? e.message : String(e)}`);
-    }
-  });
-
-  it("getBalance works for an address", async (t) => {
-    logTest("getBalance works for an address", {});
-    logAddress("staking_contract", STAKING_CONTRACT);
-    const provider = qc.getProvider(ENDPOINT, CHAIN_ID);
-    try {
-      const bal = await provider.getBalance(STAKING_CONTRACT);
-      logTest("getBalance works for an address", { balance: bal.toString() });
-      assert.equal(typeof bal, "bigint");
-      assert.ok(bal >= 0n);
-    } catch (e) {
-      t.skip(`network unavailable: ${e && e.message ? e.message : String(e)}`);
-    }
-  });
-
-  it("contract read operations work (staking contract when available)", async (t) => {
-    logTest("contract read operations work (staking contract when available)", {});
-    logAddress("staking_contract", STAKING_CONTRACT);
-    await Initialize(null);
-    const provider = qc.getProvider(ENDPOINT, CHAIN_ID);
-    try {
-      const abi = require("../fixtures/StakingContract.abi.json");
-      const contract = new qc.Contract(STAKING_CONTRACT, abi, provider);
-      const count = await contract.getDepositorCount();
-      const value = Array.isArray(count) ? count[0] : count;
-      logTest("contract read operations work", { depositorCount: value != null ? String(value) : null });
-      assert.ok(value != null);
-    } catch (e) {
-      t.skip(`network/ABI unavailable: ${e && e.message ? e.message : String(e)}`);
-    }
-  });
-});
-