quantumcoin 7.0.2 → 7.0.3

package/README-SDK.md

@@ -1,6 +1,4 @@
-<!--
-This is an experimental SDK. Use at your own risk.
--->
+> **CAUTION:** This is an experimental SDK. Use at your own risk.
 
 # QuantumCoin.js — Comprehensive SDK Documentation
 
@@ -671,7 +669,7 @@ It supports generating:
 
 **Entry point**
 - `node generate-sdk.js ...`
-- or `npx quantumcoin-sdk-generator ...` (when installed)
+- or `npx sdkgen ...` (when installed)
 
 ### Input modes
 

package/README.md

@@ -1,6 +1,4 @@
-<!--
-This is an experimental SDK. Use at your own risk.
--->
+> **CAUTION:** This is an experimental SDK. Use at your own risk.
 
 **Comprehensive SDK documentation:** see [`README-SDK.md`](./README-SDK.md).
 
@@ -93,7 +91,7 @@ node generate-sdk.js --abi path/to/abi.json --bin path/to/bytecode.bin
 
 If installed as a package, you can also run:
 
-`npx quantumcoin-sdk-generator --abi ... --bin ...`
+`npx sdkgen --abi ... --bin ...`
 
 ### Generator typing model
 

package/SPEC.md

@@ -1,6 +1,4 @@
-<!--
-This is an experimental SDK. Please do not use for production. Use at own risk
--->
+> **CAUTION:** This is an experimental SDK. Use at your own risk.
 
 # QuantumCoin.js - Ethers.js v6 Compatible API Specification
 
@@ -3823,7 +3821,7 @@ The generator should be invoked as a command-line tool or script:
 
 ```bash
 # As a CLI tool
-npx quantumcoin-sdk-generator --abi path/to/abi.json --bin path/to/bytecode.bin
+npx sdkgen --abi path/to/abi.json --bin path/to/bytecode.bin
 
 # Or as a Node.js script
 node generate-sdk.js --abi path/to/abi.json --bin path/to/bytecode.bin

package/examples/example-generator-sdk-js.js

@@ -70,7 +70,7 @@ function main() {
       "--package-name",
       pkgName,
       "--package-description",
-      "Example generated package (JS output) for quantumcoin-sdk-generator",
+      "Example generated package (JS output) for sdkgen",
       "--package-author",
       "QuantumCoin Community",
       "--package-license",

package/examples/example-generator-sdk-ts.js

@@ -70,7 +70,7 @@ function main() {
       "--package-name",
       pkgName,
       "--package-description",
-      "Example generated package (TS output) for quantumcoin-sdk-generator",
+      "Example generated package (TS output) for sdkgen",
       "--package-author",
       "QuantumCoin Community",
       "--package-license",

package/examples/offline-signing.js

@@ -0,0 +1,73 @@
+/**
+ * Example: Offline signing with populateTransaction + sendRawTransaction.
+ *
+ * This demonstrates how to:
+ * - build unsigned tx data via `contract.populateTransaction.<method>()`
+ * - sign it via `wallet.signTransaction(txReq)`
+ * - broadcast via `provider.sendRawTransaction(rawTx)`
+ *
+ * NOTE:
+ * - This example WILL broadcast a real transaction and change chain state.
+ * - It uses a HARDCODED test wallet (funded) for convenience. Never use for real funds.
+ * - Requires `QC_RPC_URL` env var.
+ */
+
+const { Initialize } = require("../config");
+const qc = require("..");
+
+// Hardcoded test wallet (test-only; never use for real funds)
+const TEST_WALLET_ENCRYPTED_JSON =
+  "{\"address\":\"1a846abe71c8b989e8337c55d608be81c28ab3b2e40c83eaa2a68d516049aec6\",\"crypto\":{\"cipher\":\"aes-256-ctr\",\"ciphertext\":\"ab7e620dd66cb55ac201b9c6796de92bbb06f3681b5932eabe099871f1f7d79acabe30921a39ad13bfe74f42c515734882b6723760142aa3e26e011df514a534ae47bd15d86badd9c6f17c48d4c892711d54d441ee3a0ee0e5b060f816e79c7badd13ff4c235934b1986774223ecf6e8761388969bb239c759b54c8c70e6a2e27c93a4b70129c8159f461d271ae8f3573414c78b88e4d0abfa6365ed45456636d4ed971c7a0c6b84e6f0c2621e819268b135e2bcc169a54d1847b39e6ba2ae8ec969b69f330b7db9e785ed02204d5a1185915ae5338b0f40ef2a7f4d5aaf7563d502135e57f4eb89d5ec1efa5c77e374969d6cd85be625a2ed1225d68ecdd84067bfc69adb83ecd5c6050472eca28a5a646fcdd28077165c629975bec8a79fe1457cb53389b788b25e1f8eff8b2ca326d7dfcaba3f8839225a08057c018a458891fd2caa0d2b27632cffd80f592147ccec9a10dc8a08a48fb55047bff5cf85cda39eb089096bef63842fc3686412f298a54a9e4b0bf4ad36907ba373cbd6d32e7ac494af371da5aa9d38a3463220865114c4adc5e4ac258ba9c6af9fa2ddfd1aec2e16887e4b3977c69561df8599ac9d411c9dd2a4d57f92ea4e5c02aae3f49fb3bc83e16673e6c2dbe96bb181c8dfd0f9757ade2e4ff27215a836058c5ffeab042f6f97c7c02339f76a6284680e01b4bb733690eb3347fbfcc26614b8bf755f9dfce3fea9d4e4d15b164983201732c2e87593a86bca6da6972e128490338f76ae68135888070f4e59e90db54d23834769bdbda9769213faf5357f9167a224523975a946367b68f0cec98658575609f58bfd329e420a921c06713326e4cb20a0df1d77f37e78a320a637a96c604ca3fa89e24beb42313751b8f09b14f9c14c77e4fd13fc6382505d27c771bca0d821ec7c3765acffa99d83c50140a56b0b28101c762bd682fe55cb6f23cbeb3f421d7b36021010e45ac27160dd7ead99c864a1b550c7edb1246950fe32dcc049799f9085287f0a747a6ef7a023df46a23a22f3e833bbf8d404f84344870492658256ee1dfc40fda33bb8d48fc72d4520ba9fc820c9123104a045206809037709f2a5f6723fa77d6bac5a573823d4ec3a7f1cb786a52ee2697e622e5d75962fa554d1024a6c355e21f33a63b2b72e6c4742a8b1c373aa532b40518c38c90b5373c2eb8c9d7be2a9e16047a3ee09dc9a6849deac5183ace6cfe91a9bef2ffc0a7df6ccebfd4c858c84b0e0355650d7466971e66f1e3883013e5ad1be33199b1d110b79070ac1b745ccb14cf63a08f8cca3a21c9525e626ff5f0c34746e10750fb742ad51f11f2acae3676c2111853d7250d01b77821a6ba9e04400ba2c543ca9f2d701ae6f47bfad14ffe3039ee9e71f7b2401359ade9938750ddb9c5a8b018a7929ed8d0e717ff1861446ce17535e9b17c187711190aae3388bd9490837a636c25ed4d42d7079ad1a51e13292c683d5d012abcf46965c534b83ab53f2c1f0cf5830ef7582e06863a33c19a70511df632885d63245965047ea96b56f1af5b3b94a54999f784fb9574fdfcd7c1230e07a2aaa04acd3097b2b9f8ddba05ae9734491deb5c1a513c76ed276cb78bbf4839dae3156d76af444a5805129d5df791167a9c8576a1d7f760b2d2797c4658669608706fbd0ace1be2346f74862dfc9ef518e55632e43c043186e5d070deb34d12fb9e5aba84e5cb50213dc88efd39cc35bf42455aa82d5e3b707b3140be3b8623b34fdd81d08615c188ae8438a13881fdf6bf32f2cb9ff5fa625561040c6b71d4b8eccc90bc3b99650d28dd1ee63773e49664e3d48c484996b290943635a6f2eb1ce9796d3fa144a3f00ef82faaa32d6a413668f7b521517cb68b2b017fcf56c79326fa5e4060e643631ca3f0a0dc0ed718798b6f46b130d437c33f64039e887324b6f5e604b1669d613923794edbf04b1b3caea54793b52b44b170173a4f25c7ecef3b71e2aad76e556b1cb9f1d637ec52ececfa950dd31dbb6a60828a3ad34c1beffe09eb4785786d63bad10a0b0f66ea88c57380f38ea85f018dbd7f538cf1ee7624095b9a01ec5edd528f281168af020609e651ff316aa1320a710134ddfca600cc72174dcdb846d2aa29916488aa1b537b66da92e61af526debef4eb38c984569eaf549ff2129449269b492d030cd74d885f6f5785881cc4804b4a8a09ba4ff7aefe9074ac7d0c4f05d51fe4cc0ff7388a772092b9d02d70e5433a5cf3e02f46a6bd6b818d59a07ce3b9fbbf8b5faba74563bcc5240930c2d406c9aaee3e3ce0429bf68ac2b0a57adb09414cff50817d2a48fb9fa624ab863cb0c31a8b8dc5eaf6fa68cc1d7c6c685c5a33edd5c8933b9e8ab628ee428d0743699b2ff17f25586c7ce959280bb0b8c5342251f0a30b53dbc7bf1ee426ac9619c3560f811f2268ee37f189794e2e4b3db3a2fb2e34b649e504fb467438abfd1082619cc4a0b30d66beb831077812e418d2e2148db10cf4d4a29101ca52ec445b8d83519dd7de85a98e0beae9ee537096d3f1a55a7a80cdfa93d25f07c9f98e8af18cde19ec1f99c5dd4588b717a5039ddb7f177717caf0d0fd45420a70dbd6d3146890d9e450d5224146db4c33b779e3c3a04b976c052bad042ac57dd38be45407808c0fb0d7e2a8819e6cd53c6739e6612996ddaa6f066552590aa0343bc1e62b298ff2514a0cef8be21956c2e942816f7a3a3a0935eaf9b37251409ce444c986c3817e82835555fe18239f3ae33469d7965c2bde9991fde556bd07af01df52bbde0c35bb4ef48e3b5d0db53f8ca4ed35b83f760f0a1bc4ed9f86e85d6039a17df373c85402ef956f01db00eb39c4b74bd0660d29ee746714d9780d738e05c6cca414ce3d7b40dda8036a9eea9ab1388805f913eb19bdd3f09d9e161eaa50231bd9caba61971f194332dd28c696a60458c1c6c2cc5da8b1192611c7c553e9e12fe48ce46bbb891be8bb118721c86222e671ddd1da8f0ccb2b68e02f2014b4925e904e88369aaf7466bd7033a60c265d45955944916ecbdb84bf1b522b01b0149c632e04c568a7eb627c5bb90ece052ebcf79166c28b30d23fe52da0a5ab5dea83ca479a3e3b7a9cfbbfea04dbe6137c19d067317c2ec427a8c75a6b06bec6dcd5d5c0edc9aa80b9003b8e17c088b2f3db327d3e42630d82d20120240c3ba56232280787da4aabbf5bc95a864029f00710e195f2a76460a0317d10b552fe1bea097e41d49756c680a41d6ac186e62169b6b6cd7776ea84618b5b752328a5bacaa10aa122ff9b2698b43efe73d852a899db644863c8c9bc8068ea86ea843fd6fe36272b91cdc5d5317083ef3fd1e5462a0b0d0604dc57b3bbfceb0fca4cd349625dd7b25166af30efe5ee6a0af953a74d65f4736c59918ee55a3b0d9d9d42e04c7f8a77e479109f740e20c464d5d7e3d16805f47b61f403ff7f408c9e850d9baacd8067e544536a4953480b0f9ee9cd45f41ebd67b51f78788a6470cb1e5ca72ca346ce8a50d0ca0c921d5576a4455a1afb6d0bc688004712ee122cacdb29c51e84893324c27fa4a3f1917edf5352272b4c97579a6152e4b77663d0ab532915f2eeb6a862de8b696452321b660c3f2449673d086e95a7af28845a5259b763e0fcd09f72acf7b6c811066263060e5aa5b24658e880a01fd56bda4dad5ab604e129290f7d5489728f2a40968c6168b21cebbbcd11727cc9e9160c4e92e04387d3b0d62aab06a61f26daedd9fed11816ef2180172a47f47184ac4032b88758c98a2e0fb200f70e93ba695f5ebb7a1029610ad360d3b7fa1b4640b9dc674d3625eef786da93dff19bc7991b5d6193a3896664763fde479b5dfc04812111a80782854f2cf68ca7d82765cc9eb40fba4b44640710ed6e653abf9f07b466333f4fd22784d53cf40e17120f42caa841eaa24056b237827b0f47f7257c103c35027e9f503e5acfd023e7357b600d3084d361d5ee65ba319b45c153212a54e6fed85af7e43e0a926ebcbc2edf8de7e2ec9528f00bec262ad04d5c9dafccaea06a24748d28bf1799bae0e895543084539c50b5aaa4fb50d7431d6f0c8cee2a54aaf7ee7919b55bf40adb688632e5dbe273cea09e97b19c3d8e1f4de000deb66fa1942ad03a62d3252f51992244366c156000b49c297167a6cbdedea7ebae139d295f0ad298e0864249b905b7eb812886ec70ecdb286702274b5b8574149bf3866f9e46b997ff5ed622b169a0eb071347f18d530db1663906a28f4544ee4e004ab87b65476af30ede118052ff052b8dc986ca2c93dd5d4943266a579c7698ea014f688b3e8063a107feb162d392e2177b01bff77fb5abe5feebd0607158049a5a093325b7c9ee6b4dfa7a9f65c7c2fb628920d3603a1c2dad979eaa047cd661a268af1078c9788d720e64e4ce9d12e68de1e417ef2f293323681e1071f9220e1ee43d2e29d111b870ce3439f5100ecd4551ab65ee74aa1667e564957e9bc0ae1ea193980da2a0ec2698073388c85bec25ef447f0d5e93a5203fa44dff268e5cb799ed3b66e63d5e07b487e7534f24934c73a62a243e0151843a0fd3807711a101eaa7fc71f0ba68aebb9534d57cba41b094eebfb4c31cca8eddfa426f676aa347be8a7023a4e91ddb154b35cd4d5f7dbc2e5db491de99f33fc2cff2d57029ac950e1ccd681980af6a4e8969dfe39b3c7bfcbcf8fac92f1e6ec9fe572bfa6a7d65860eab2ed10ac01a71290b52e3148e84b7376a8605cd2bb0e8681ffc54691ce087685e33921bd44d36c78291713dce17569570f62137e6904f0d68cf53aa2ec395c389a75141f08114fb293ea63950e4ffee55ec6fc83cf44876b8e7f25cdd393ff87b9eda6eb746085b61a6900de191f0ce2cb388d61ece52e78bc47368194e8e00277e0d1631e6b9d4626ef76f8522582ccd5a40be3febc699bb510acc6271d55ff0f4cf3bb7669855a72efd9ca3e1056a2fe592a5bc877cce2b1f63b58383971da87873d2d1349cf5881242cdce4e7e2c5c514755746a0e0a7c2a6d9701cde005ae3420beb17c379a3516662253554f51f0423bb1844b0b90c54ed8177ceb0e1036a6609d836e748ca06c40ca64befadc6443ec286a0ce464678e8d11eb455f7bb305acebf6cb1f50e394a9bfeb752df1687831bac9cdd811f4f112ef6658d0f8799a866374ff96c5e2b79f30e7a74f8a2bc9ed1f88f01f30e30cb78ffb2bff10108f35e910ee3be4463e9e6f0ed910e8d598326e71dfa2277ffe5579d7fe9b6018bfe295b25219eae07b3b0270665c3fa00c3e0d180812b5cd62925585de84a7c48a9a86dba96544a251654d1966e082432dc85b6149cf21e91a46020ec32b66d28ba3b6a90c0617bc6fdd55aea819af2bcf84864ad60c28fe3c9f8339d0aee68b39d97f63b6e082835d86119cf9b9fdc8b827c847ce40aa10e1577a710132316845e825345e95bdf94d0c66ec65a6c4319fce4792313663b5f7a651a6710783e6ab71608ac6cbbf3af6911adf596ccf7c172b9bd5bceb6db379967b32b143bdd11d2ee12ddf64ecef6391e0f8570e6cddd3db95204919362b89b739fa94e7c1bfde799fd5e22aa25ca6ca42e30c08e23aae2385d99ebab441072a880dcefdab74a4c9bd39d363f6d1933d59400fca161d432aa00f23b1b1c19a154be8989699d549b66d44e39896f5523443bc6ddf4a65e91f1f3fb7b52318869a05856a4fc92f3694c81ed833c972fb918f7e5\",\"cipherparams\":{\"iv\":\"8c46d6162cd4c765759aedcbce2a5874\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"82fb6cdc6917609135277badacf15baa31899d08b71a5a0fa33167167c161537\"},\"mac\":\"9187b17f7eca48e6b8c586b0cd790dbe0feb876ac8385f93faa7d5e22a3c8fc7\"},\"id\":\"92caf6ee-2d43-48c0-859e-ffa1e0e23312\",\"version\":3}";
+const TEST_WALLET_PASSPHRASE = "QuantumCoinExample123!";
+
+async function main() {
+  const rpcUrl = process.env.QC_RPC_URL;
+  if (!rpcUrl) throw new Error("QC_RPC_URL is required");
+  const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;
+
+  await Initialize(null);
+
+  const provider = new qc.JsonRpcProvider(rpcUrl, chainId);
+  const offlineWallet = qc.Wallet.fromEncryptedJsonSync(TEST_WALLET_ENCRYPTED_JSON, TEST_WALLET_PASSPHRASE);
+
+  // Minimal ABI for demonstration
+  const abi = [
+    {
+      type: "function",
+      name: "setValue",
+      stateMutability: "nonpayable",
+      inputs: [{ name: "value", type: "uint256" }],
+      outputs: [],
+    },
+  ];
+
+  const dummyContractAddress = "0x" + "11".repeat(32);
+  const contract = new qc.Contract(dummyContractAddress, abi);
+
+  const txReq = await contract.populateTransaction.setValue(123, { gasLimit: 200000 });
+
+  // True offline signing: explicitly set nonce + chainId (+ gasPrice if desired)
+  const nonce = await provider.getTransactionCount(offlineWallet.address, "pending");
+  const rawTx = await offlineWallet.signTransaction({
+    ...txReq,
+    nonce,
+    chainId,
+    gasPrice: 1n,
+  });
+
+  console.log("Unsigned txReq:", txReq);
+  console.log("Signed rawTx:", rawTx);
+  console.log("Submitting via sendRawTransaction...");
+
+  const sent = await provider.sendRawTransaction(rawTx);
+  console.log("tx hash:", sent.hash);
+  const receipt = await sent.wait(1, 600_000);
+  console.log("receipt block:", receipt.blockNumber);
+  console.log("receipt status:", receipt.status);
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+

package/examples/package-lock.json

@@ -16,7 +16,7 @@
     },
     "..": {
       "name": "quantumcoin",
-      "version": "7.0.2",
+      "version": "7.0.3",
       "license": "MIT",
       "dependencies": {
         "quantum-coin-js-sdk": "^1.0.28",
@@ -24,7 +24,7 @@
         "seed-words": "^1.0.2"
       },
       "bin": {
-        "quantumcoin-sdk-generator": "generate-sdk.js"
+        "sdkgen": "generate-sdk.js"
       }
     },
     "node_modules/quantum-coin-js-sdk": {

package/generate-sdk.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * quantumcoin-sdk-generator
+ * sdkgen
  *
  * NOTE: This script is the SDK generator CLI entrypoint.
  *
@@ -20,11 +20,11 @@ const readline = require("node:readline/promises");
 const { stdin, stdout } = require("node:process");
 const { execFileSync, spawnSync } = require("node:child_process");
 
-const { generate, generateFromArtifacts, generateTransactionalTestJs } = require("./src/generator");
+const { generate, generateFromArtifacts, generateTransactionalTestJs, generateAllContractsTransactionalTestJs } = require("./src/generator");
 
 function _helpText() {
   return `
-quantumcoin-sdk-generator (generate-sdk.js)
+sdkgen (generate-sdk.js)
 
 Generates TypeScript or JavaScript contract wrappers (plus optional package scaffold, examples and transactional tests).
 
@@ -881,6 +881,13 @@ async function main() {
       );
     }
 
+    if (artifacts.length > 1) {
+      _writeText(
+        path.join(outDir, "test", "e2e", "all-contracts.e2e.test.js"),
+        generateAllContractsTransactionalTestJs({ artifacts: artifacts.map((a) => ({ contractName: a.contractName, abi: a.abi })) }),
+      );
+    }
+
     if (artifacts.length === 1) {
       // Back-compat: keep original example filenames for a single-contract package.
       const a = artifacts[0];
@@ -1030,6 +1037,96 @@ async function main() {
   console.log("No known write method template for this ABI.");
 }
 
+main().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});
+`,
+      );
+
+      _writeText(
+        path.join(outDir, "examples", "offline-signing.js"),
+        `/**
+ * Offline signing example (generated).
+ *
+ * Demonstrates:
+ * - ${a.contractName}__factory.getDeployTransaction(...)
+ * - contract.populateTransaction.<method>(...)
+ * - wallet.signTransaction(txReq) (offline) + provider.sendRawTransaction(rawTx)
+ *
+ * Requires:
+ * - QC_RPC_URL env var
+ *
+ * WARNING: uses a hardcoded test wallet (funded) for convenience.
+ */
+const { Initialize } = require("quantumcoin/config");
+const { JsonRpcProvider, Wallet, getCreateAddress } = require("quantumcoin");
+const { ${a.contractName}, ${a.contractName}__factory } = require("..");
+
+// Hardcoded test wallet (test-only; never use for real funds)
+const TEST_WALLET_ENCRYPTED_JSON =
+  ${JSON.stringify(
+    "{\"address\":\"1a846abe71c8b989e8337c55d608be81c28ab3b2e40c83eaa2a68d516049aec6\",\"crypto\":{\"cipher\":\"aes-256-ctr\",\"ciphertext\":\"ab7e620dd66cb55ac201b9c6796de92bbb06f3681b5932eabe099871f1f7d79acabe30921a39ad13bfe74f42c515734882b6723760142aa3e26e011df514a534ae47bd15d86badd9c6f17c48d4c892711d54d441ee3a0ee0e5b060f816e79c7badd13ff4c235934b1986774223ecf6e8761388969bb239c759b54c8c70e6a2e27c93a4b70129c8159f461d271ae8f3573414c78b88e4d0abfa6365ed45456636d4ed971c7a0c6b84e6f0c2621e819268b135e2bcc169a54d1847b39e6ba2ae8ec969b69f330b7db9e785ed02204d5a1185915ae5338b0f40ef2a7f4d5aaf7563d502135e57f4eb89d5ec1efa5c77e374969d6cd85be625a2ed1225d68ecdd84067bfc69adb83ecd5c6050472eca28a5a646fcdd28077165c629975bec8a79fe1457cb53389b788b25e1f8eff8b2ca326d7dfcaba3f8839225a08057c018a458891fd2caa0d2b27632cffd80f592147ccec9a10dc8a08a48fb55047bff5cf85cda39eb089096bef63842fc3686412f298a54a9e4b0bf4ad36907ba373cbd6d32e7ac494af371da5aa9d38a3463220865114c4adc5e4ac258ba9c6af9fa2ddfd1aec2e16887e4b3977c69561df8599ac9d411c9dd2a4d57f92ea4e5c02aae3f49fb3bc83e16673e6c2dbe96bb181c8dfd0f9757ade2e4ff27215a836058c5ffeab042f6f97c7c02339f76a6284680e01b4bb733690eb3347fbfcc26614b8bf755f9dfce3fea9d4e4d15b164983201732c2e87593a86bca6da6972e128490338f76ae68135888070f4e59e90db54d23834769bdbda9769213faf5357f9167a224523975a946367b68f0cec98658575609f58bfd329e420a921c06713326e4cb20a0df1d77f37e78a320a637a96c604ca3fa89e24beb42313751b8f09b14f9c14c77e4fd13fc6382505d27c771bca0d821ec7c3765acffa99d83c50140a56b0b28101c762bd682fe55cb6f23cbeb3f421d7b36021010e45ac27160dd7ead99c864a1b550c7edb1246950fe32dcc049799f9085287f0a747a6ef7a023df46a23a22f3e833bbf8d404f84344870492658256ee1dfc40fda33bb8d48fc72d4520ba9fc820c9123104a045206809037709f2a5f6723fa77d6bac5a573823d4ec3a7f1cb786a52ee2697e622e5d75962fa554d1024a6c355e21f33a63b2b72e6c4742a8b1c373aa532b40518c38c90b5373c2eb8c9d7be2a9e16047a3ee09dc9a6849deac5183ace6cfe91a9bef2ffc0a7df6ccebfd4c858c84b0e0355650d7466971e66f1e3883013e5ad1be33199b1d110b79070ac1b745ccb14cf63a08f8cca3a21c9525e626ff5f0c34746e10750fb742ad51f11f2acae3676c2111853d7250d01b77821a6ba9e04400ba2c543ca9f2d701ae6f47bfad14ffe3039ee9e71f7b2401359ade9938750ddb9c5a8b018a7929ed8d0e717ff1861446ce17535e9b17c187711190aae3388bd9490837a636c25ed4d42d7079ad1a51e13292c683d5d012abcf46965c534b83ab53f2c1f0cf5830ef7582e06863a33c19a70511df632885d63245965047ea96b56f1af5b3b94a54999f784fb9574fdfcd7c1230e07a2aaa04acd3097b2b9f8ddba05ae9734491deb5c1a513c76ed276cb78bbf4839dae3156d76af444a5805129d5df791167a9c8576a1d7f760b2d2797c4658669608706fbd0ace1be2346f74862dfc9ef518e55632e43c043186e5d070deb34d12fb9e5aba84e5cb50213dc88efd39cc35bf42455aa82d5e3b707b3140be3b8623b34fdd81d08615c188ae8438a13881fdf6bf32f2cb9ff5fa625561040c6b71d4b8eccc90bc3b99650d28dd1ee63773e49664e3d48c484996b290943635a6f2eb1ce9796d3fa144a3f00ef82faaa32d6a413668f7b521517cb68b2b017fcf56c79326fa5e4060e643631ca3f0a0dc0ed718798b6f46b130d437c33f64039e887324b6f5e604b1669d613923794edbf04b1b3caea54793b52b44b170173a4f25c7ecef3b71e2aad76e556b1cb9f1d637ec52ececfa950dd31dbb6a60828a3ad34c1beffe09eb4785786d63bad10a0b0f66ea88c57380f38ea85f018dbd7f538cf1ee7624095b9a01ec5edd528f281168af020609e651ff316aa1320a710134ddfca600cc72174dcdb846d2aa29916488aa1b537b66da92e61af526debef4eb38c984569eaf549ff2129449269b492d030cd74d885f6f5785881cc4804b4a8a09ba4ff7aefe9074ac7d0c4f05d51fe4cc0ff7388a772092b9d02d70e5433a5cf3e02f46a6bd6b818d59a07ce3b9fbbf8b5faba74563bcc5240930c2d406c9aaee3e3ce0429bf68ac2b0a57adb09414cff50817d2a48fb9fa624ab863cb0c31a8b8dc5eaf6fa68cc1d7c6c685c5a33edd5c8933b9e8ab628ee428d0743699b2ff17f25586c7ce959280bb0b8c5342251f0a30b53dbc7bf1ee426ac9619c3560f811f2268ee37f189794e2e4b3db3a2fb2e34b649e504fb467438abfd1082619cc4a0b30d66beb831077812e418d2e2148db10cf4d4a29101ca52ec445b8d83519dd7de85a98e0beae9ee537096d3f1a55a7a80cdfa93d25f07c9f98e8af18cde19ec1f99c5dd4588b717a5039ddb7f177717caf0d0fd45420a70dbd6d3146890d9e450d5224146db4c33b779e3c3a04b976c052bad042ac57dd38be45407808c0fb0d7e2a8819e6cd53c6739e6612996ddaa6f066552590aa0343bc1e62b298ff2514a0cef8be21956c2e942816f7a3a3a0935eaf9b37251409ce444c986c3817e82835555fe18239f3ae33469d7965c2bde9991fde556bd07af01df52bbde0c35bb4ef48e3b5d0db53f8ca4ed35b83f760f0a1bc4ed9f86e85d6039a17df373c85402ef956f01db00eb39c4b74bd0660d29ee746714d9780d738e05c6cca414ce3d7b40dda8036a9eea9ab1388805f913eb19bdd3f09d9e161eaa50231bd9caba61971f194332dd28c696a60458c1c6c2cc5da8b1192611c7c553e9e12fe48ce46bbb891be8bb118721c86222e671ddd1da8f0ccb2b68e02f2014b4925e904e88369aaf7466bd7033a60c265d45955944916ecbdb84bf1b522b01b0149c632e04c568a7eb627c5bb90ece052ebcf79166c28b30d23fe52da0a5ab5dea83ca479a3e3b7a9cfbbfea04dbe6137c19d067317c2ec427a8c75a6b06bec6dcd5d5c0edc9aa80b9003b8e17c088b2f3db327d3e42630d82d20120240c3ba56232280787da4aabbf5bc95a864029f00710e195f2a76460a0317d10b552fe1bea097e41d49756c680a41d6ac186e62169b6b6cd7776ea84618b5b752328a5bacaa10aa122ff9b2698b43efe73d852a899db644863c8c9bc8068ea86ea843fd6fe36272b91cdc5d5317083ef3fd1e5462a0b0d0604dc57b3bbfceb0fca4cd349625dd7b25166af30efe5ee6a0af953a74d65f4736c59918ee55a3b0d9d9d42e04c7f8a77e479109f740e20c464d5d7e3d16805f47b61f403ff7f408c9e850d9baacd8067e544536a4953480b0f9ee9cd45f41ebd67b51f78788a6470cb1e5ca72ca346ce8a50d0ca0c921d5576a4455a1afb6d0bc688004712ee122cacdb29c51e84893324c27fa4a3f1917edf5352272b4c97579a6152e4b77663d0ab532915f2eeb6a862de8b696452321b660c3f2449673d086e95a7af28845a5259b763e0fcd09f72acf7b6c811066263060e5aa5b24658e880a01fd56bda4dad5ab604e129290f7d5489728f2a40968c6168b21cebbbcd11727cc9e9160c4e92e04387d3b0d62aab06a61f26daedd9fed11816ef2180172a47f47184ac4032b88758c98a2e0fb200f70e93ba695f5ebb7a1029610ad360d3b7fa1b4640b9dc674d3625eef786da93dff19bc7991b5d6193a3896664763fde479b5dfc04812111a80782854f2cf68ca7d82765cc9eb40fba4b44640710ed6e653abf9f07b466333f4fd22784d53cf40e17120f42caa841eaa24056b237827b0f47f7257c103c35027e9f503e5acfd023e7357b600d3084d361d5ee65ba319b45c153212a54e6fed85af7e43e0a926ebcbc2edf8de7e2ec9528f00bec262ad04d5c9dafccaea06a24748d28bf1799bae0e895543084539c50b5aaa4fb50d7431d6f0c8cee2a54aaf7ee7919b55bf40adb688632e5dbe273cea09e97b19c3d8e1f4de000deb66fa1942ad03a62d3252f51992244366c156000b49c297167a6cbdedea7ebae139d295f0ad298e0864249b905b7eb812886ec70ecdb286702274b5b8574149bf3866f9e46b997ff5ed622b169a0eb071347f18d530db1663906a28f4544ee4e004ab87b65476af30ede118052ff052b8dc986ca2c93dd5d4943266a579c7698ea014f688b3e8063a107feb162d392e2177b01bff77fb5abe5feebd0607158049a5a093325b7c9ee6b4dfa7a9f65c7c2fb628920d3603a1c2dad979eaa047cd661a268af1078c9788d720e64e4ce9d12e68de1e417ef2f293323681e1071f9220e1ee43d2e29d111b870ce3439f5100ecd4551ab65ee74aa1667e564957e9bc0ae1ea193980da2a0ec2698073388c85bec25ef447f0d5e93a5203fa44dff268e5cb799ed3b66e63d5e07b487e7534f24934c73a62a243e0151843a0fd3807711a101eaa7fc71f0ba68aebb9534d57cba41b094eebfb4c31cca8eddfa426f676aa347be8a7023a4e91ddb154b35cd4d5f7dbc2e5db491de99f33fc2cff2d57029ac950e1ccd681980af6a4e8969dfe39b3c7bfcbcf8fac92f1e6ec9fe572bfa6a7d65860eab2ed10ac01a71290b52e3148e84b7376a8605cd2bb0e8681ffc54691ce087685e33921bd44d36c78291713dce17569570f62137e6904f0d68cf53aa2ec395c389a75141f08114fb293ea63950e4ffee55ec6fc83cf44876b8e7f25cdd393ff87b9eda6eb746085b61a6900de191f0ce2cb388d61ece52e78bc47368194e8e00277e0d1631e6b9d4626ef76f8522582ccd5a40be3febc699bb510acc6271d55ff0f4cf3bb7669855a72efd9ca3e1056a2fe592a5bc877cce2b1f63b58383971da87873d2d1349cf5881242cdce4e7e2c5c514755746a0e0a7c2a6d9701cde005ae3420beb17c379a3516662253554f51f0423bb1844b0b90c54ed8177ceb0e1036a6609d836e748ca06c40ca64befadc6443ec286a0ce464678e8d11eb455f7bb305acebf6cb1f50e394a9bfeb752df1687831bac9cdd811f4f112ef6658d0f8799a866374ff96c5e2b79f30e7a74f8a2bc9ed1f88f01f30e30cb78ffb2bff10108f35e910ee3be4463e9e6f0ed910e8d598326e71dfa2277ffe5579d7fe9b6018bfe295b25219eae07b3b0270665c3fa00c3e0d180812b5cd62925585de84a7c48a9a86dba96544a251654d1966e082432dc85b6149cf21e91a46020ec32b66d28ba3b6a90c0617bc6fdd55aea819af2bcf84864ad60c28fe3c9f8339d0aee68b39d97f63b6e082835d86119cf9b9fdc8b827c847ce40aa10e1577a710132316845e825345e95bdf94d0c66ec65a6c4319fce4792313663b5f7a651a6710783e6ab71608ac6cbbf3af6911adf596ccf7c172b9bd5bceb6db379967b32b143bdd11d2ee12ddf64ecef6391e0f8570e6cddd3db95204919362b89b739fa94e7c1bfde799fd5e22aa25ca6ca42e30c08e23aae2385d99ebab441072a880dcefdab74a4c9bd39d363f6d1933d59400fca161d432aa00f23b1b1c19a154be8989699d549b66d44e39896f5523443bc6ddf4a65e91f1f3fb7b52318869a05856a4fc92f3694c81ed833c972fb918f7e5\",\"cipherparams\":{\"iv\":\"8c46d6162cd4c765759aedcbce2a5874\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"82fb6cdc6917609135277badacf15baa31899d08b71a5a0fa33167167c161537\"},\"mac\":\"9187b17f7eca48e6b8c586b0cd790dbe0feb876ac8385f93faa7d5e22a3c8fc7\"},\"id\":\"92caf6ee-2d43-48c0-859e-ffa1e0e23312\",\"version\":3}",
+  )};
+const TEST_WALLET_PASSPHRASE = "QuantumCoinExample123!";
+
+async function main() {
+  const rpcUrl = process.env.QC_RPC_URL;
+  if (!rpcUrl) throw new Error("QC_RPC_URL is required");
+  const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;
+
+  await Initialize(null);
+  const provider = new JsonRpcProvider(rpcUrl, chainId);
+
+  // Offline wallet (no provider attached). We'll resolve nonce from provider manually.
+  const wallet = Wallet.fromEncryptedJsonSync(TEST_WALLET_ENCRYPTED_JSON, TEST_WALLET_PASSPHRASE);
+  const from = wallet.address;
+
+  const factory = new ${a.contractName}__factory(wallet);
+  const deployTxReq = factory.getDeployTransaction(${ctorArgsExpr});
+
+  let gasLimit = 600000;
+  try {
+    const est = await provider.estimateGas({ from, data: deployTxReq.data });
+    gasLimit = Number(est + 200_000n);
+  } catch {
+    gasLimit = 6_000_000;
+  }
+  const bytecodeSize = (${a.contractName}.bytecode || "").length;
+  if (bytecodeSize > 20000 && gasLimit < 6_000_000) gasLimit = 6_000_000;
+
+  const nonce0 = await provider.getTransactionCount(from, "pending");
+  const predicted = getCreateAddress({ from, nonce: nonce0 });
+
+  const rawDeploy = await wallet.signTransaction({
+    ...deployTxReq,
+    nonce: nonce0,
+    chainId,
+    gasLimit,
+    gasPrice: 1n,
+  });
+
+  const sentDeploy = await provider.sendRawTransaction(rawDeploy);
+  console.log("deploy tx hash:", sentDeploy.hash);
+  await sentDeploy.wait(1, 600_000);
+
+  const contract = ${a.contractName}.connect(predicted, provider);
+  console.log("deployed at:", contract.target);
+
+  // Optional: offline-sign a write method if present (ERC20-like approve)
+  if (contract.populateTransaction && typeof contract.populateTransaction.approve === "function") {
+    const txReq = await contract.populateTransaction.approve(from, 123, { gasLimit: 200000 });
+    const nonce1 = await provider.getTransactionCount(from, "pending");
+    const raw = await wallet.signTransaction({ ...txReq, nonce: nonce1, chainId, gasPrice: 1n });
+    const sent = await provider.sendRawTransaction(raw);
+    console.log("approve tx hash:", sent.hash);
+    await sent.wait(1, 600_000);
+    console.log("approve succeeded");
+  } else {
+    console.log("No known write method for offline-signing demo (skipping write tx).");
+  }
+}
+
 main().catch((e) => {
   console.error(e);
   process.exitCode = 1;
@@ -1098,6 +1195,11 @@ main().catch((e) => {
           `const { Initialize } = require("quantumcoin/config");\nconst { JsonRpcProvider } = require("quantumcoin");\nconst { createTestWallet } = require("./_test-wallet");\nconst { ${a.contractName} } = require("..");\n\nasync function main() {\n  const rpcUrl = process.env.QC_RPC_URL;\n  if (!rpcUrl) throw new Error("QC_RPC_URL is required");\n  const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;\n  const address = process.env.CONTRACT_ADDRESS;\n  if (!address) throw new Error("CONTRACT_ADDRESS is required");\n  await Initialize(null);\n\n  const provider = new JsonRpcProvider(rpcUrl, chainId);\n  const wallet = createTestWallet(provider);\n  const contract = ${a.contractName}.connect(address, wallet);\n\n  console.log("Connected:", contract.target);\n  console.log("Done");\n}\n\nmain().catch((e) => { console.error(e); process.exitCode = 1; });\n`,
         );
 
+        _writeText(
+          path.join(outDir, "examples", `offline-signing-${a.contractName}.js`),
+          `const { Initialize } = require("quantumcoin/config");\nconst { JsonRpcProvider, Wallet, getCreateAddress } = require("quantumcoin");\nconst { TEST_WALLET_ENCRYPTED_JSON, TEST_WALLET_PASSPHRASE } = require("./_test-wallet");\nconst { ${a.contractName}__factory, ${a.contractName} } = require("..");\n\nasync function main() {\n  const rpcUrl = process.env.QC_RPC_URL;\n  if (!rpcUrl) throw new Error("QC_RPC_URL is required");\n  const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;\n  await Initialize(null);\n\n  const provider = new JsonRpcProvider(rpcUrl, chainId);\n  const wallet = Wallet.fromEncryptedJsonSync(TEST_WALLET_ENCRYPTED_JSON, TEST_WALLET_PASSPHRASE);\n  const from = wallet.address;\n\n  const factory = new ${a.contractName}__factory(wallet);\n  const deployTxReq = factory.getDeployTransaction();\n  const nonce0 = await provider.getTransactionCount(from, \"pending\");\n  const predicted = getCreateAddress({ from, nonce: nonce0 });\n\n  const rawDeploy = await wallet.signTransaction({ ...deployTxReq, nonce: nonce0, chainId, gasLimit: 6_000_000, gasPrice: 1n });\n  const sentDeploy = await provider.sendRawTransaction(rawDeploy);\n  await sentDeploy.wait(1, 600_000);\n\n  const contract = ${a.contractName}.connect(predicted, provider);\n  console.log(\"deployed at:\", contract.target);\n}\n\nmain().catch((e) => { console.error(e); process.exitCode = 1; });\n`,
+        );
+
         _writeText(
           path.join(outDir, "examples", `events-${a.contractName}.js`),
           `const { Initialize } = require("quantumcoin/config");\nconst { JsonRpcProvider } = require("quantumcoin");\nconst { ${a.contractName} } = require("..");\n\nasync function main() {\n  const rpcUrl = process.env.QC_RPC_URL;\n  if (!rpcUrl) throw new Error("QC_RPC_URL is required");\n  const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;\n  const address = process.env.CONTRACT_ADDRESS;\n  if (!address) throw new Error("CONTRACT_ADDRESS is required");\n  await Initialize(null);\n\n  const provider = new JsonRpcProvider(rpcUrl, chainId);\n  const contract = ${a.contractName}.connect(address, provider);\n\n  const logs = await contract.queryFilter("Transfer", "latest", "latest");\n  console.log("Logs:", logs.length);\n}\n\nmain().catch((e) => { console.error(e); process.exitCode = 1; });\n`,
@@ -1117,6 +1219,7 @@ main().catch((e) => {
     }
   }
 
+  console.warn("This is an experimental SDK. Use at your own risk.");
   console.log(`Generated contract files in: ${targetSrcDir}`);
 }
 
@@ -1249,6 +1352,7 @@ function _packageReadme({ pkgName, pkgDesc, artifacts, createdFromSolidity, lang
   return (
     `# ${pkgName}\n\n` +
     `${pkgDesc || ""}\n\n` +
+    "> **Note:** This is an experimental SDK. Use at your own risk.\n\n" +
     "## What’s in this package\n\n" +
     (outLang === "ts"
       ? "- Typed contract wrappers and factories in `src/` (compiled output in `dist/`)\n"
@@ -1324,6 +1428,7 @@ function _createPackageScaffold({ outDir, pkgName, pkgDesc, pkgAuthor, pkgLicens
     _writeJson(path.join(outDir, "tsconfig.json"), {
       compilerOptions: {
         target: "ES2022",
+        lib: ["ES2022"],
         module: "CommonJS",
         declaration: true,
         outDir: "dist",
@@ -1360,6 +1465,8 @@ function _createPackageScaffold({ outDir, pkgName, pkgDesc, pkgAuthor, pkgLicens
       `    constructor(address: string, abi: any, runner?: any, bytecode?: any);\n` +
       `    target: string;\n` +
       `    address: string;\n` +
+      `    interface: any;\n` +
+      `    populateTransaction: any;\n` +
       `    call(methodName: string, args: any[], overrides?: TransactionRequest): Promise<any>;\n` +
       `    send(methodName: string, args: any[], overrides?: TransactionRequest): Promise<ContractTransactionResponse>;\n` +
       `    deployTransaction(): TransactionResponse | null;\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantumcoin",
-  "version": "7.0.2",
+  "version": "7.0.3",
   "description": "QuantumCoin SDK - a complete SDK for dapps",
   "main": "index.js",
   "types": "src/index.d.ts",
@@ -30,12 +30,12 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "test": "node --test \"test/**/*.test.js\"",
+    "test": "node --test \"test/unit/**/*.test.js\" \"test/integration/**/*.test.js\" \"test/security/**/*.test.js\" \"test/e2e/*.test.js\"",
     "test:unit": "node --test \"test/unit/**/*.test.js\"",
     "test:integration": "node --test \"test/integration/**/*.test.js\"",
     "test:security": "node --test \"test/security/**/*.test.js\"",
     "test:non-transactional": "node --test \"test/unit/**/*.test.js\" \"test/integration/**/*.test.js\" \"test/security/**/*.test.js\"",
-    "test:e2e": "node --test --test-concurrency=1 \"test/e2e/**/*.test.js\"",
+    "test:e2e": "node --test --test-concurrency=1 \"test/e2e/*.test.js\"",
     "example": "node examples/example.js",
     "example:provider": "node examples/example.js",
     "example:wallet": "node examples/wallet-offline.js",
@@ -65,7 +65,7 @@
   },
   "homepage": "https://github.com/quantumcoinproject/quantumcoin.js#readme",
   "bin": {
-    "quantumcoin-sdk-generator": "./generate-sdk.js"
+    "sdkgen": "./generate-sdk.js"
   },
   "dependencies": {
     "quantum-coin-pqc-js-sdk": "^1.0.5",

package/src/contract/contract.d.ts

@@ -20,6 +20,9 @@ export class Contract extends BaseContract {
     signer: any;
     runner: any;
     _listeners: any;
+    populateTransaction: {
+        [key: string]: (...args: any[]) => Promise<import("../providers/provider").TransactionRequest>;
+    };
     getAddress(): string;
     /**
      * Invoke a contract function, dispatching to call() or send().
@@ -44,6 +47,12 @@ export class Contract extends BaseContract {
      * @returns {Promise<ContractTransactionResponse>}
      */
     send(methodName: string, args: any[], overrides?: import("../providers/provider").TransactionRequest | undefined): Promise<ContractTransactionResponse>;
+    /**
+     * Build an unsigned transaction request for a contract method call.
+     * @param {string} methodName
+     * @param {any[]} args
+     */
+    _populate(methodName: string, args: any[]): Promise<import("../providers/provider").TransactionRequest>;
     /**
      * Query logs for an event.
      * @param {any} event

package/src/contract/contract.js

@@ -132,6 +132,25 @@ class Contract extends BaseContract {
 
     this._listeners = new Map();
 
+    // ethers-style populateTransaction namespace:
+    //   await contract.populateTransaction.someMethod(arg1, ..., overrides?)
+    //
+    // NOTE: This will shadow any ABI function literally named "populateTransaction".
+    // Such a function can still be invoked via `contract.call("populateTransaction", ...)`
+    // or `contract.send("populateTransaction", ...)`.
+    const self = this;
+    this.populateTransaction = new Proxy(
+      {},
+      {
+        get(_t, prop) {
+          if (typeof prop !== "string") return undefined;
+          const fn = self.interface.abi.find((f) => f && f.type === "function" && f.name === prop);
+          if (!fn) return undefined;
+          return (...args) => self._populate(prop, args);
+        },
+      },
+    );
+
     // Proxy to support dynamic method names: contract.someMethod(...)
     return new Proxy(this, {
       get: (target, prop, receiver) => {
@@ -183,6 +202,29 @@ class Contract extends BaseContract {
     return this.send(methodName, callArgs, overrides);
   }
 
+  /**
+   * Build an unsigned transaction request for a contract method call.
+   * @param {string} methodName
+   * @param {any[]} args
+   * @returns {Promise<import("../providers/provider").TransactionRequest>}
+   */
+  async _populate(methodName, args) {
+    const fn = this.interface.abi.find((f) => f && f.type === "function" && f.name === methodName);
+    if (!fn) throw makeError("function not found", "INVALID_ARGUMENT", { methodName });
+
+    const inputCount = Array.isArray(fn.inputs) ? fn.inputs.length : 0;
+    let overrides = undefined;
+    let callArgs = Array.isArray(args) ? args : [];
+
+    if (callArgs.length === inputCount + 1 && _isOverridesLike(callArgs[callArgs.length - 1])) {
+      overrides = callArgs[callArgs.length - 1];
+      callArgs = callArgs.slice(0, inputCount);
+    }
+
+    const data = this.interface.encodeFunctionData(methodName, callArgs);
+    return { to: this.address, data, ...(overrides || {}) };
+  }
+
   /**
    * Perform a read-only call.
    * @param {string} methodName

package/src/generator/index.js

@@ -455,19 +455,19 @@ function _allSupportedParams(inputs) {
 
 function _typesTs() {
   return (
-    `// Auto-generated by quantumcoin-sdk-generator\n\n` +
+    `// Auto-generated by sdkgen\n\n` +
     `// Re-export ALL Solidity-related types from quantumcoin.\n` +
     `export type * from "quantumcoin/types";\n`
   );
 }
 
 function _typesJs() {
-  return `// Auto-generated by quantumcoin-sdk-generator\n\n` + `module.exports = {};\n`;
+  return `// Auto-generated by sdkgen\n\n` + `module.exports = {};\n`;
 }
 
 function _typesDts() {
   return (
-    `// Auto-generated by quantumcoin-sdk-generator\n\n` +
+    `// Auto-generated by sdkgen\n\n` +
     `export type * from "quantumcoin/types";\n`
   );
 }
@@ -475,9 +475,10 @@ function _typesDts() {
 function _renderContractTs({ contractName, abi, bytecode, docs }) {
   const functions = (abi || []).filter((f) => f && f.type === "function");
   const tupleReg = _collectTupleRegistry(contractName, abi);
+  const txFns = functions.filter((f) => (f.stateMutability || "") !== "view" && (f.stateMutability || "") !== "pure");
 
   const contractTsLines = [];
-  contractTsLines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  contractTsLines.push(`// Auto-generated by sdkgen`);
   contractTsLines.push(`import { Contract, ContractTransactionResponse, ContractRunner, TransactionResponse } from "quantumcoin";`);
   contractTsLines.push(`import type * as Types from "./types";`);
   contractTsLines.push(``);
@@ -506,6 +507,26 @@ function _renderContractTs({ contractName, abi, bytecode, docs }) {
   contractTsLines.push(`    super(address, ${contractName}.abi as any, runner as any, ${contractName}.bytecode);`);
   contractTsLines.push(`    // @ts-expect-error internal attach`);
   contractTsLines.push(`    this._deployTx = _deployTx;`);
+  if (txFns.length) {
+    contractTsLines.push(``);
+    contractTsLines.push(`    // Typed populateTransaction helpers (offline signing / sendRawTransaction flows)`);
+    contractTsLines.push(`    this.populateTransaction = {`);
+    for (const fn of txFns) {
+      const name = fn.name;
+      const inputs = fn.inputs || [];
+      const argsSig = inputs
+        .map((p, i) => `${_safeIdent(p.name || `arg${i}`)}: ${_solParamToTs(p, "input", tupleReg)}`)
+        .join(", ");
+      const argsNames = inputs.map((p, i) => _safeIdent(p.name || `arg${i}`)).join(", ");
+      contractTsLines.push(
+        `      ${name}: async (${argsSig}${argsSig ? ", " : ""}overrides?: any): Promise<import("quantumcoin").TransactionRequest> => {`,
+      );
+      contractTsLines.push(`        const data = this.interface.encodeFunctionData(${JSON.stringify(name)}, [${argsNames}]);`);
+      contractTsLines.push(`        return { to: this.address, data, ...(overrides || {}) };`);
+      contractTsLines.push(`      },`);
+    }
+    contractTsLines.push(`    } as any;`);
+  }
   contractTsLines.push(`  }`);
 
   for (const fn of functions) {
@@ -570,9 +591,10 @@ function _renderContractTs({ contractName, abi, bytecode, docs }) {
 function _renderContractJs({ contractName, abi, bytecode, docs }) {
   const functions = (abi || []).filter((f) => f && f.type === "function");
   const tupleReg = _collectTupleRegistry(contractName, abi);
+  const txFns = functions.filter((f) => (f.stateMutability || "") !== "view" && (f.stateMutability || "") !== "pure");
 
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`const { Contract } = require("quantumcoin");`);
   lines.push("");
 
@@ -604,6 +626,22 @@ function _renderContractJs({ contractName, abi, bytecode, docs }) {
   lines.push(`  constructor(address, runner, _deployTx) {`);
   lines.push(`    super(address, ${contractName}.abi, runner, ${contractName}.bytecode);`);
   lines.push(`    this._deployTx = _deployTx;`);
+  if (txFns.length) {
+    lines.push("");
+    lines.push("    // Typed populateTransaction helpers (offline signing / sendRawTransaction flows)");
+    lines.push("    this.populateTransaction = {");
+    for (const fn of txFns) {
+      const name = fn.name;
+      const inputs = fn.inputs || [];
+      const argsNames = inputs.map((p, i) => _safeIdent(p.name || `arg${i}`)).join(", ");
+      const argsSig = inputs.map((p, i) => _safeIdent(p.name || `arg${i}`)).join(", ");
+      lines.push(`      ${name}: async (${argsSig}${argsSig ? ", " : ""}overrides) => {`);
+      lines.push(`        const data = this.interface.encodeFunctionData(${JSON.stringify(name)}, [${argsNames}]);`);
+      lines.push(`        return { to: this.address, data, ...(overrides || {}) };`);
+      lines.push("      },");
+    }
+    lines.push("    };");
+  }
   lines.push(`  }`);
 
   for (const fn of functions) {
@@ -674,8 +712,9 @@ function _renderContractJs({ contractName, abi, bytecode, docs }) {
 function _renderContractDts({ contractName, abi }) {
   const functions = (abi || []).filter((f) => f && f.type === "function");
   const tupleReg = _collectTupleRegistry(contractName, abi);
+  const txFns = functions.filter((f) => (f.stateMutability || "") !== "view" && (f.stateMutability || "") !== "pure");
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`import { Contract, ContractRunner, ContractTransactionResponse, TransactionResponse } from "quantumcoin";`);
   lines.push(`import type * as Types from "./types";`);
   lines.push("");
@@ -689,6 +728,20 @@ function _renderContractDts({ contractName, abi }) {
   lines.push(`  static readonly bytecode: string;`);
   lines.push(`  static connect(address: string, runner?: ContractRunner): ${contractName};`);
   lines.push(`  constructor(address: string, runner?: ContractRunner, _deployTx?: TransactionResponse);`);
+  if (txFns.length) {
+    lines.push(`  readonly populateTransaction: {`);
+    for (const fn of txFns) {
+      const name = fn.name;
+      const inputs = fn.inputs || [];
+      const argsSig = inputs
+        .map((p, i) => `${_safeIdent(p.name || `arg${i}`)}: ${_solParamToTs(p, "input", tupleReg)}`)
+        .join(", ");
+      lines.push(
+        `    ${name}(${argsSig}${argsSig ? ", " : ""}overrides?: any): Promise<import("quantumcoin").TransactionRequest>;`,
+      );
+    }
+    lines.push(`  };`);
+  }
 
   for (const fn of functions) {
     const name = fn.name;
@@ -727,7 +780,7 @@ function _renderFactoryTs({ contractName, abi }) {
   const tupleReg = _collectTupleRegistry(contractName, abi);
 
   const factoryTsLines = [];
-  factoryTsLines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  factoryTsLines.push(`// Auto-generated by sdkgen`);
   factoryTsLines.push(`import { ContractFactory, ContractRunner, getCreateAddress } from "quantumcoin";`);
   factoryTsLines.push(`import { ${contractName} } from "./${contractName}";`);
   factoryTsLines.push(`import type * as Types from "./types";`);
@@ -793,7 +846,7 @@ function _renderFactoryJs({ contractName, abi }) {
   const deployArgsNames = ctorInputs.map((p, i) => _safeIdent(p.name || `arg${i}`)).join(", ");
 
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`const { ContractFactory, getCreateAddress } = require("quantumcoin");`);
   lines.push(`const { ${contractName} } = require("./${contractName}");`);
   lines.push("");
@@ -834,7 +887,7 @@ function _renderFactoryDts({ contractName, abi }) {
   const deployArgsSig = ctorInputs.map((p, i) => `${_safeIdent(p.name || `arg${i}`)}: ${_solParamToTs(p, "input", tupleReg)}`).join(", ");
 
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`import { ContractFactory, ContractRunner } from "quantumcoin";`);
   lines.push(`import { ${contractName} } from "./${contractName}";`);
   lines.push(`import type * as Types from "./types";`);
@@ -867,7 +920,7 @@ function _renderFactoryDts({ contractName, abi }) {
 
 function _renderIndexTs(contractNames) {
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`export * from "./types";`);
   for (const name of contractNames) {
     lines.push(`export * from "./${name}";`);
@@ -878,7 +931,7 @@ function _renderIndexTs(contractNames) {
 
 function _renderIndexJs(contractNames) {
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push("");
   lines.push(`Object.assign(exports, require("./types"));`);
   for (const name of contractNames) {
@@ -891,7 +944,7 @@ function _renderIndexJs(contractNames) {
 
 function _renderIndexDts(contractNames) {
   const lines = [];
-  lines.push(`// Auto-generated by quantumcoin-sdk-generator`);
+  lines.push(`// Auto-generated by sdkgen`);
   lines.push(`export * from "./types";`);
   for (const name of contractNames) {
     lines.push(`export * from "./${name}";`);
@@ -1095,6 +1148,156 @@ describe("${contractName} transactional", () => {
 `;
 }
 
+/**
+ * For a single contract ABI, compute deploy args and optional view/write method for e2e.
+ * @param {{ contractName: string, abi: any[] }} opts
+ * @returns {{ ctorArgsExpr: string, deployArgsExpr: string, viewName: string | null, writeName: string | null, writeArgsExpr: string }}
+ */
+function _getContractTestMeta(opts) {
+  const { contractName, abi } = opts;
+  const ctor = _findConstructor(abi);
+  const ctorInputs = ctor.inputs || [];
+  const ctorArgsExpr = ctorInputs.map((i) => _solTypeToTestValueExpr(i)).join(", ");
+  const viewNoArg = (abi || []).find(
+    (f) => f && f.type === "function" && (f.stateMutability === "view" || f.stateMutability === "pure") && (f.inputs || []).length === 0,
+  );
+  const writeFn =
+    (abi || []).find(
+      (f) =>
+        f && f.type === "function" && !(f.stateMutability === "view" || f.stateMutability === "pure") && f.name === "set" &&
+        (f.inputs || []).length === 1 &&
+        (f.inputs[0].type || "").startsWith("uint") &&
+        _allSupportedParams(f.inputs),
+    ) ||
+    (abi || []).find(
+      (f) => f && f.type === "function" && !(f.stateMutability === "view" || f.stateMutability === "pure") && _allSupportedParams(f.inputs),
+    );
+  const writeArgsExpr =
+    writeFn && (writeFn.inputs || []).length === 1 && (writeFn.inputs[0].type || "").startsWith("uint")
+      ? "456"
+      : writeFn
+        ? (writeFn.inputs || []).map((i) => _solTypeToTestValueExpr(i)).join(", ")
+        : "";
+  return {
+    ctorArgsExpr,
+    deployArgsExpr: ctorArgsExpr,
+    viewName: viewNoArg ? viewNoArg.name : null,
+    writeName: writeFn ? writeFn.name : null,
+    writeArgsExpr,
+  };
+}
+
+/**
+ * Generate a single transactional e2e test that deploys and invokes methods on ALL contracts.
+ * Used when the package has multiple contracts so one test exercises every contract.
+ *
+ * @param {{ artifacts: Array<{ contractName: string, abi: any[] }> }} opts
+ * @returns {string}
+ */
+function generateAllContractsTransactionalTestJs(opts) {
+  const { artifacts } = opts;
+  if (!artifacts || artifacts.length < 2) {
+    throw new Error("generateAllContractsTransactionalTestJs requires at least 2 artifacts");
+  }
+
+  const requireNames = [];
+  for (const a of artifacts) {
+    requireNames.push(a.contractName, `${a.contractName}__factory`);
+  }
+  const requireLine = `const { ${requireNames.join(", ")} } = require("../..");`;
+
+  const blocks = [];
+  for (const a of artifacts) {
+    const meta = _getContractTestMeta({ contractName: a.contractName, abi: a.abi });
+    const factoryName = `${a.contractName}__factory`;
+    const deployRhs =
+      meta.ctorArgsExpr
+        ? `await (new ${factoryName}(wallet)).deploy(${meta.deployArgsExpr}, { gasLimit: deployGasLimit })`
+        : `await (new ${factoryName}(wallet)).deploy({ gasLimit: deployGasLimit })`;
+    let invokeBlock = "";
+    if (meta.viewName) {
+      invokeBlock += `const _v = await ${a.contractName}Inst.${meta.viewName}();\n    void _v;\n`;
+    }
+    if (meta.writeName) {
+      invokeBlock += `const _tx = await ${a.contractName}Inst.${meta.writeName}(${meta.writeArgsExpr}${meta.writeArgsExpr ? ", " : ""}{ gasLimit: 200000 });\n    await _tx.wait(1, 600_000);\n`;
+    }
+    blocks.push({
+      contractName: a.contractName,
+      factoryName,
+      deployRhs,
+      invokeBlock: invokeBlock || `// No view/write method detected for ${a.contractName}\n`,
+    });
+  }
+
+  const deployAndInvokeBlocks = blocks
+    .map(
+      (b) => `
+    let ${b.contractName}Inst = ${b.deployRhs};
+    const _deployTx${b.contractName} = ${b.contractName}Inst.deployTransaction();
+    assert.ok(_deployTx${b.contractName} && _deployTx${b.contractName}.hash);
+    await _deployTx${b.contractName}.wait(1, 600_000);
+    ${b.invokeBlock.trim().split("\n").join("\n    ")}`,
+    )
+    .join("\n");
+
+  const firstMeta = _getContractTestMeta({ contractName: artifacts[0].contractName, abi: artifacts[0].abi });
+  const firstCtorArgs = firstMeta.ctorArgsExpr ? firstMeta.ctorArgsExpr + ", " : "";
+
+  return `/**
+ * @testCategory e2e
+ * @blockchainRequired write
+ * @description Auto-generated test that deploys and invokes all contracts in this package.
+ *
+ * WARNING:
+ * - This test uses a HARDCODED TEST WALLET (encrypted JSON + passphrase).
+ * - It assumes the wallet has funds on the target network.
+ * - It will broadcast real transactions and change chain state.
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+
+const { Initialize } = require("quantumcoin/config");
+const { JsonRpcProvider, Wallet } = require("quantumcoin");
+
+${requireLine}
+
+// Hardcoded test wallet (test-only; never use for real funds)
+const TEST_WALLET_ENCRYPTED_JSON =
+  ${JSON.stringify(
+    "{\"address\":\"1a846abe71c8b989e8337c55d608be81c28ab3b2e40c83eaa2a68d516049aec6\",\"crypto\":{\"cipher\":\"aes-256-ctr\",\"ciphertext\":\"ab7e620dd66cb55ac201b9c6796de92bbb06f3681b5932eabe099871f1f7d79acabe30921a39ad13bfe74f42c515734882b6723760142aa3e26e011df514a534ae47bd15d86badd9c6f17c48d4c892711d54d441ee3a0ee0e5b060f816e79c7badd13ff4c235934b1986774223ecf6e8761388969bb239c759b54c8c70e6a2e27c93a4b70129c8159f461d271ae8f3573414c78b88e4d0abfa6365ed45456636d4ed971c7a0c6b84e6f0c2621e819268b135e2bcc169a54d1847b39e6ba2ae8ec969b69f330b7db9e785ed02204d5a1185915ae5338b0f40ef2a7f4d5aaf7563d502135e57f4eb89d5ec1efa5c77e374969d6cd85be625a2ed1225d68ecdd84067bfc69adb83ecd5c6050472eca28a5a646fcdd28077165c629975bec8a79fe1457cb53389b788b25e1f8eff8b2ca326d7dfcaba3f8839225a08057c018a458891fd2caa0d2b27632cffd80f592147ccec9a10dc8a08a48fb55047bff5cf85cda39eb089096bef63842fc3686412f298a54a9e4b0bf4ad36907ba373cbd6d32e7ac494af371da5aa9d38a3463220865114c4adc5e4ac258ba9c6af9fa2ddfd1aec2e16887e4b3977c69561df8599ac9d411c9dd2a4d57f92ea4e5c02aae3f49fb3bc83e16673e6c2dbe96bb181c8dfd0f9757ade2e4ff27215a836058c5ffeab042f6f97c7c02339f76a6284680e01b4bb733690eb3347fbfcc26614b8bf755f9dfce3fea9d4e4d15b164983201732c2e87593a86bca6da6972e128490338f76ae68135888070f4e59e90db54d23834769bdbda9769213faf5357f9167a224523975a946367b68f0cec98658575609f58bfd329e420a921c06713326e4cb20a0df1d77f37e78a320a637a96c604ca3fa89e24beb42313751b8f09b14f9c14c77e4fd13fc6382505d27c771bca0d821ec7c3765acffa99d83c50140a56b0b28101c762bd682fe55cb6f23cbeb3f421d7b36021010e45ac27160dd7ead99c864a1b550c7edb1246950fe32dcc049799f9085287f0a747a6ef7a023df46a23a22f3e833bbf8d404f84344870492658256ee1dfc40fda33bb8d48fc72d4520ba9fc820c9123104a045206809037709f2a5f6723fa77d6bac5a573823d4ec3a7f1cb786a52ee2697e622e5d75962fa554d1024a6c355e21f33a63b2b72e6c4742a8b1c373aa532b40518c38c90b5373c2eb8c9d7be2a9e16047a3ee09dc9a6849deac5183ace6cfe91a9bef2ffc0a7df6ccebfd4c858c84b0e0355650d7466971e66f1e3883013e5ad1be33199b1d110b79070ac1b745ccb14cf63a08f8cca3a21c9525e626ff5f0c34746e10750fb742ad51f11f2acae3676c2111853d7250d01b77821a6ba9e04400ba2c543ca9f2d701ae6f47bfad14ffe3039ee9e71f7b2401359ade9938750ddb9c5a8b018a7929ed8d0e717ff1861446ce17535e9b17c187711190aae3388bd9490837a636c25ed4d42d7079ad1a51e13292c683d5d012abcf46965c534b83ab53f2c1f0cf5830ef7582e06863a33c19a70511df632885d63245965047ea96b56f1af5b3b94a54999f784fb9574fdfcd7c1230e07a2aaa04acd3097b2b9f8ddba05ae9734491deb5c1a513c76ed276cb78bbf4839dae3156d76af444a5805129d5df791167a9c8576a1d7f760b2d2797c4658669608706fbd0ace1be2346f74862dfc9ef518e55632e43c043186e5d070deb34d12fb9e5aba84e5cb50213dc88efd39cc35bf42455aa82d5e3b707b3140be3b8623b34fdd81d08615c188ae8438a13881fdf6bf32f2cb9ff5fa625561040c6b71d4b8eccc90bc3b99650d28dd1ee63773e49664e3d48c484996b290943635a6f2eb1ce9796d3fa144a3f00ef82faaa32d6a413668f7b521517cb68b2b017fcf56c79326fa5e4060e643631ca3f0a0dc0ed718798b6f46b130d437c33f64039e887324b6f5e604b1669d613923794edbf04b1b3caea54793b52b44b170173a4f25c7ecef3b71e2aad76e556b1cb9f1d637ec52ececfa950dd31dbb6a60828a3ad34c1beffe09eb4785786d63bad10a0b0f66ea88c57380f38ea85f018dbd7f538cf1ee7624095b9a01ec5edd528f281168af020609e651ff316aa1320a710134ddfca600cc72174dcdb846d2aa29916488aa1b537b66da92e61af526debef4eb38c984569eaf549ff2129449269b492d030cd74d885f6f5785881cc4804b4a8a09ba4ff7aefe9074ac7d0c4f05d51fe4cc0ff7388a772092b9d02d70e5433a5cf3e02f46a6bd6b818d59a07ce3b9fbbf8b5faba74563bcc5240930c2d406c9aaee3e3ce0429bf68ac2b0a57adb09414cff50817d2a48fb9fa624ab863cb0c31a8b8dc5eaf6fa68cc1d7c6c685c5a33edd5c8933b9e8ab628ee428d0743699b2ff17f25586c7ce959280bb0b8c5342251f0a30b53dbc7bf1ee426ac9619c3560f811f2268ee37f189794e2e4b3db3a2fb2e34b649e504fb467438abfd1082619cc4a0b30d66beb831077812e418d2e2148db10cf4d4a29101ca52ec445b8d83519dd7de85a98e0beae9ee537096d3f1a55a7a80cdfa93d25f07c9f98e8af18cde19ec1f99c5dd4588b717a5039ddb7f177717caf0d0fd45420a70dbd6d3146890d9e450d5224146db4c33b779e3c3a04b976c052bad042ac57dd38be45407808c0fb0d7e2a8819e6cd53c6739e6612996ddaa6f066552590aa0343bc1e62b298ff2514a0cef8be21956c2e942816f7a3a3a0935eaf9b37251409ce444c986c3817e82835555fe18239f3ae33469d7965c2bde9991fde556bd07af01df52bbde0c35bb4ef48e3b5d0db53f8ca4ed35b83f760f0a1bc4ed9f86e85d6039a17df373c85402ef956f01db00eb39c4b74bd0660d29ee746714d9780d738e05c6cca414ce3d7b40dda8036a9eea9ab1388805f913eb19bdd3f09d9e161eaa50231bd9caba61971f194332dd28c696a60458c1c6c2cc5da8b1192611c7c553e9e12fe48ce46bbb891be8bb118721c86222e671ddd1da8f0ccb2b68e02f2014b4925e904e88369aaf7466bd7033a60c265d45955944916ecbdb84bf1b522b01b0149c632e04c568a7eb627c5bb90ece052ebcf79166c28b30d23fe52da0a5ab5dea83ca479a3e3b7a9cfbbfea04dbe6137c19d067317c2ec427a8c75a6b06bec6dcd5d5c0edc9aa80b9003b8e17c088b2f3db327d3e42630d82d20120240c3ba56232280787da4aabbf5bc95a864029f00710e195f2a76460a0317d10b552fe1bea097e41d49756c680a41d6ac186e62169b6b6cd7776ea84618b5b752328a5bacaa10aa122ff9b2698b43efe73d852a899db644863c8c9bc8068ea86ea843fd6fe36272b91cdc5d5317083ef3fd1e5462a0b0d0604dc57b3bbfceb0fca4cd349625dd7b25166af30efe5ee6a0af953a74d65f4736c59918ee55a3b0d9d9d42e04c7f8a77e479109f740e20c464d5d7e3d16805f47b61f403ff7f408c9e850d9baacd8067e544536a4953480b0f9ee9cd45f41ebd67b51f78788a6470cb1e5ca72ca346ce8a50d0ca0c921d5576a4455a1afb6d0bc688004712ee122cacdb29c51e84893324c27fa4a3f1917edf5352272b4c97579a6152e4b77663d0ab532915f2eeb6a862de8b696452321b660c3f2449673d086e95a7af28845a5259b763e0fcd09f72acf7b6c811066263060e5aa5b24658e880a01fd56bda4dad5ab604e129290f7d5489728f2a40968c6168b21cebbbcd11727cc9e9160c4e92e04387d3b0d62aab06a61f26daedd9fed11816ef2180172a47f47184ac4032b88758c98a2e0fb200f70e93ba695f5ebb7a1029610ad360d3b7fa1b4640b9dc674d3625eef786da93dff19bc7991b5d6193a3896664763fde479b5dfc04812111a80782854f2cf68ca7d82765cc9eb40fba4b44640710ed6e653abf9f07b466333f4fd22784d53cf40e17120f42caa841eaa24056b237827b0f47f7257c103c35027e9f503e5acfd023e7357b600d3084d361d5ee65ba319b45c153212a54e6fed85af7e43e0a926ebcbc2edf8de7e2ec9528f00bec262ad04d5c9dafccaea06a24748d28bf1799bae0e895543084539c50b5aaa4fb50d7431d6f0c8cee2a54aaf7ee7919b55bf40adb688632e5dbe273cea09e97b19c3d8e1f4de000deb66fa1942ad03a62d3252f51992244366c156000b49c297167a6cbdedea7ebae139d295f0ad298e0864249b905b7eb812886ec70ecdb286702274b5b8574149bf3866f9e46b997ff5ed622b169a0eb071347f18d530db1663906a28f4544ee4e004ab87b65476af30ede118052ff052b8dc986ca2c93dd5d4943266a579c7698ea014f688b3e8063a107feb162d392e2177b01bff77fb5abe5feebd0607158049a5a093325b7c9ee6b4dfa7a9f65c7c2fb628920d3603a1c2dad979eaa047cd661a268af1078c9788d720e64e4ce9d12e68de1e417ef2f293323681e1071f9220e1ee43d2e29d111b870ce3439f5100ecd4551ab65ee74aa1667e564957e9bc0ae1ea193980da2a0ec2698073388c85bec25ef447f0d5e93a5203fa44dff268e5cb799ed3b66e63d5e07b487e7534f24934c73a62a243e0151843a0fd3807711a101eaa7fc71f0ba68aebb9534d57cba41b094eebfb4c31cca8eddfa426f676aa347be8a7023a4e91ddb154b35cd4d5f7dbc2e5db491de99f33fc2cff2d57029ac950e1ccd681980af6a4e8969dfe39b3c7bfcbcf8fac92f1e6ec9fe572bfa6a7d65860eab2ed10ac01a71290b52e3148e84b7376a8605cd2bb0e8681ffc54691ce087685e33921bd44d36c78291713dce17569570f62137e6904f0d68cf53aa2ec395c389a75141f08114fb293ea63950e4ffee55ec6fc83cf44876b8e7f25cdd393ff87b9eda6eb746085b61a6900de191f0ce2cb388d61ece52e78bc47368194e8e00277e0d1631e6b9d4626ef76f8522582ccd5a40be3febc699bb510acc6271d55ff0f4cf3bb7669855a72efd9ca3e1056a2fe592a5bc877cce2b1f63b58383971da87873d2d1349cf5881242cdce4e7e2c5c514755746a0e0a7c2a6d9701cde005ae3420beb17c379a3516662253554f51f0423bb1844b0b90c54ed8177ceb0e1036a6609d836e748ca06c40ca64befadc6443ec286a0ce464678e8d11eb455f7bb305acebf6cb1f50e394a9bfeb752df1687831bac9cdd811f4f112ef6658d0f8799a866374ff96c5e2b79f30e7a74f8a2bc9ed1f88f01f30e30cb78ffb2bff10108f35e910ee3be4463e9e6f0ed910e8d598326e71dfa2277ffe5579d7fe9b6018bfe295b25219eae07b3b0270665c3fa00c3e0d180812b5cd62925585de84a7c48a9a86dba96544a251654d1966e082432dc85b6149cf21e91a46020ec32b66d28ba3b6a90c0617bc6fdd55aea819af2bcf84864ad60c28fe3c9f8339d0aee68b39d97f63b6e082835d86119cf9b9fdc8b827c847ce40aa10e1577a710132316845e825345e95bdf94d0c66ec65a6c4319fce4792313663b5f7a651a6710783e6ab71608ac6cbbf3af6911adf596ccf7c172b9bd5bceb6db379967b32b143bdd11d2ee12ddf64ecef6391e0f8570e6cddd3db95204919362b89b739fa94e7c1bfde799fd5e22aa25ca6ca42e30c08e23aae2385d99ebab441072a880dcefdab74a4c9bd39d363f6d1933d59400fca161d432aa00f23b1b1c19a154be8989699d549b66d44e39896f5523443bc6ddf4a65e91f1f3fb7b52318869a05856a4fc92f3694c81ed833c972fb918f7e5\",\"cipherparams\":{\"iv\":\"8c46d6162cd4c765759aedcbce2a5874\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"82fb6cdc6917609135277badacf15baa31899d08b71a5a0fa33167167c161537\"},\"mac\":\"9187b17f7eca48e6b8c586b0cd790dbe0feb876ac8385f93faa7d5e22a3c8fc7\"},\"id\":\"92caf6ee-2d43-48c0-859e-ffa1e0e23312\",\"version\":3}",
+  )};
+const TEST_WALLET_PASSPHRASE = "QuantumCoinExample123!";
+
+describe("all contracts", () => {
+  it("deploys and invokes all contracts", async (t) => {
+    const rpcUrl = process.env.QC_RPC_URL;
+    if (!rpcUrl) {
+      t.skip("QC_RPC_URL not provided");
+      return;
+    }
+
+    const chainId = process.env.QC_CHAIN_ID ? Number(process.env.QC_CHAIN_ID) : 123123;
+    await Initialize(null);
+
+    const provider = new JsonRpcProvider(rpcUrl, chainId);
+    const wallet = Wallet.fromEncryptedJsonSync(TEST_WALLET_ENCRYPTED_JSON, TEST_WALLET_PASSPHRASE, provider);
+
+    let deployGasLimit = 600000;
+    try {
+      const firstFactory = new ${artifacts[0].contractName}__factory(wallet);
+      const sampleReq = firstFactory.getDeployTransaction(${firstMeta.ctorArgsExpr || ""});
+      const est = await provider.estimateGas({ from: wallet.address, data: sampleReq.data });
+      deployGasLimit = Number(est + 200_000n);
+    } catch {
+      deployGasLimit = 6_000_000;
+    }
+${deployAndInvokeBlocks}
+  }, { timeout: ${Math.max(900_000, 300_000 * artifacts.length)}});
+});
+`;
+}
+
 /**
  * @typedef {Object} GenerateOptions
  * @property {string} abiPath
@@ -1197,5 +1400,5 @@ function generate(opts) {
   return { contractFile, factoryFile, typesFile: res.typesFile, indexFile: res.indexFile };
 }
 
-module.exports = { generate, generateFromArtifacts, generateTransactionalTestJs };
+module.exports = { generate, generateFromArtifacts, generateTransactionalTestJs, generateAllContractsTransactionalTestJs };
 

package/src/providers/provider.d.ts

@@ -71,6 +71,13 @@ export class AbstractProvider extends Provider {
      * @returns {Promise<TransactionResponse>}
      */
     sendTransaction(tx: TransactionRequest | string): Promise<TransactionResponse>;
+    /**
+     * Broadcast a signed raw transaction.
+     * Alias of sendTransaction(rawTx) for clarity in offline signing flows.
+     * @param {string} rawTx
+     * @returns {Promise<TransactionResponse>}
+     */
+    sendRawTransaction(rawTx: string): Promise<TransactionResponse>;
     /**
      * Perform a call (read-only) and return hex data.
      * @param {TransactionRequest} tx

package/src/providers/provider.js

@@ -296,6 +296,18 @@ class AbstractProvider extends Provider {
     return result || new TransactionResponse({ hash }, this);
   }
 
+  /**
+   * Broadcast a signed raw transaction.
+   * Alias of sendTransaction(rawTx) for clarity when doing offline signing flows.
+   *
+   * @param {string} rawTx
+   * @returns {Promise<TransactionResponse>}
+   */
+  async sendRawTransaction(rawTx) {
+    assertArgument(typeof rawTx === "string", "invalid rawTx", "rawTx", rawTx);
+    return this.sendTransaction(rawTx);
+  }
+
   /**
    * Perform a call (read-only) and return hex data.
    * @param {TransactionRequest} tx

package/test/e2e/all-solidity-types.generated-sdks.e2e.test.js

@@ -344,6 +344,13 @@ describe("AllSolidityTypes generated SDKs (extra tests)", () => {
       const jsRun = runNpm(["test"], jsPkg, env);
       assert.equal(jsRun.status, 0, `JS package tests failed:\n${jsRun.stdout}\n${jsRun.stderr}`);
 
+      // Run the generated offline signing example (offline deploy via sendRawTransaction).
+      const tsExample = run(process.execPath, [path.join(tsPkg, "examples", "offline-signing.js")], tsPkg, env);
+      assert.equal(tsExample.status, 0, `TS offline-signing example failed:\n${tsExample.stdout}\n${tsExample.stderr}`);
+
+      const jsExample = run(process.execPath, [path.join(jsPkg, "examples", "offline-signing.js")], jsPkg, env);
+      assert.equal(jsExample.status, 0, `JS offline-signing example failed:\n${jsExample.stdout}\n${jsExample.stderr}`);
+
       succeeded = true;
     } finally {
       // We intentionally keep the generated SDK packages under test/e2e.

package/test/e2e/simple-erc20.generated-sdks.e2e.test.js

@@ -129,6 +129,13 @@ describe("SimpleERC20 generated SDKs", () => {
       const jsRun = runNpm(["test"], jsPkg, env);
       assert.equal(jsRun.status, 0, `JS package tests failed:\n${jsRun.stdout}\n${jsRun.stderr}`);
 
+      // Run the generated offline signing example (deploy + approve via sendRawTransaction).
+      const tsExample = run(process.execPath, [path.join(tsPkg, "examples", "offline-signing.js")], tsPkg, env);
+      assert.equal(tsExample.status, 0, `TS offline-signing example failed:\n${tsExample.stdout}\n${tsExample.stderr}`);
+
+      const jsExample = run(process.execPath, [path.join(jsPkg, "examples", "offline-signing.js")], jsPkg, env);
+      assert.equal(jsExample.status, 0, `JS offline-signing example failed:\n${jsExample.stdout}\n${jsExample.stderr}`);
+
       succeeded = true;
     } finally {
       if (succeeded) {

package/test/e2e/transactional.test.js

@@ -113,9 +113,9 @@ describe("Transactional E2E (write)", () => {
     // feePaid ~= gasLimit * fixedGasPrice
     const expectedFee = BigInt(gasLimit) * FIXED_GAS_PRICE_WEI;
     const feePaid = senderDelta - sendValue;
-    // Allow a wide tolerance (network/client may differ), but keep it bounded.
+    // Allow a wide tolerance (network/client gas price may differ significantly).
     assert.ok(feePaid > 0n);
-    assert.ok(feePaid <= expectedFee * 2n);
+    assert.ok(feePaid <= expectedFee * 20n);
 
     // Nonce should increment by at least 1.
     assert.ok(nonceAfter >= nonceBefore + 1);
@@ -161,7 +161,7 @@ describe("Transactional E2E (write)", () => {
       value: 0n,
     });
 
-    const receipt = await deployTx.wait(1, 300_000);
+    const receipt = await deployTx.wait(1, 600_000);
     assert.ok(receipt);
     if (receipt.contractAddress) {
       assert.equal(receipt.contractAddress.toLowerCase(), expectedAddress.toLowerCase());
@@ -186,6 +186,6 @@ describe("Transactional E2E (write)", () => {
     // qcsdk decode may return string/number; normalize to BigInt for comparison
     const afterBI = typeof afterValue === "bigint" ? afterValue : BigInt(afterValue);
     assert.equal(afterBI, 42n);
-  }, { timeout: 600_000 });
+  }, { timeout: 900_000 });
 });
 

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

@@ -264,6 +264,7 @@ describe("typed contract generator package e2e", () => {
       // Verify tests exist for each contract
       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")));
 
       // Multi-contract packages use per-contract example filenames.
       assert.ok(fs.existsSync(path.join(pkgRoot, "examples", "deploy-Alpha.js")));
@@ -368,6 +369,7 @@ describe("typed contract generator package e2e", () => {
       // Verify tests exist for each contract
       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")));
 
       // Verify Solidity comments were propagated into generated TS
       const alphaTs = fs.readFileSync(path.join(pkgRoot, "src", "Alpha.ts"), "utf8");

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

@@ -10,7 +10,7 @@ const assert = require("node:assert/strict");
 
 const qc = require("../../index");
 
-const WS = "ws://127.0.0.1:8546";
+const WS = process.env.QC_WS_URL || "ws://127.0.0.1:8546";
 
 describe("WebSocketProvider (readonly)", () => {
   it("getBlockNumber and getBlock('latest') work over WebSocket", async (t) => {

package/test/unit/generate-contract-cli.test.js

@@ -25,7 +25,7 @@ describe("generate-sdk.js CLI", () => {
 
     assert.equal(res.status, 0);
     const out = `${res.stdout || ""}${res.stderr || ""}`;
-    assert.ok(out.includes("quantumcoin-sdk-generator"));
+    assert.ok(out.includes("sdkgen"));
     assert.ok(out.includes("INPUT MODES"));
     assert.ok(out.includes("--abi"));
     assert.ok(out.includes("--bin"));

package/test/unit/generator.test.js

@@ -53,6 +53,7 @@ describe("typed contract generator", () => {
     assert.ok(contractSrc.includes("export class TestToken"));
     assert.ok(contractSrc.includes("async balanceOf"));
     assert.ok(contractSrc.includes("async transfer"));
+    assert.ok(contractSrc.includes("populateTransaction"));
 
     const factorySrc = fs.readFileSync(res.factoryFile, "utf8");
     assert.ok(factorySrc.includes("export class TestToken__factory"));

package/test/unit/populate-transaction.test.js

@@ -0,0 +1,62 @@
+/**
+ * @testCategory unit
+ * @blockchainRequired false
+ * @transactional false
+ * @description populateTransaction namespace and sendRawTransaction API
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+
+const { Initialize } = require("../../config");
+const qc = require("../../index");
+
+describe("populateTransaction + sendRawTransaction", () => {
+  it("contract.populateTransaction.<fn> builds tx request without provider/signer", async () => {
+    await Initialize(null);
+
+    const abi = [
+      {
+        type: "function",
+        name: "setValue",
+        stateMutability: "nonpayable",
+        inputs: [{ name: "value", type: "uint256" }],
+        outputs: [],
+      },
+    ];
+
+    const addr = "0x" + "11".repeat(32);
+    const contract = new qc.Contract(addr, abi);
+
+    const tx = await contract.populateTransaction.setValue(123, { gasLimit: 50000 });
+    assert.equal(tx.to, addr);
+    assert.equal(typeof tx.data, "string");
+    assert.ok(tx.data.startsWith("0x") && tx.data.length > 10);
+    assert.equal(tx.gasLimit, 50000);
+  });
+
+  it("provider.sendRawTransaction exists and forwards to eth_sendRawTransaction", async () => {
+    await Initialize(null);
+
+    class TestProvider extends qc.AbstractProvider {
+      constructor() {
+        super();
+        this.calls = [];
+      }
+      async _perform(method, params) {
+        this.calls.push({ method, params });
+        if (method === "eth_sendRawTransaction") return "0x" + "aa".repeat(32);
+        if (method === "eth_getTransactionByHash") return null;
+        return null;
+      }
+    }
+
+    const p = new TestProvider();
+    const raw = "0xdeadbeef";
+    const resp = await p.sendRawTransaction(raw);
+    assert.ok(resp && typeof resp.hash === "string");
+    assert.equal(p.calls[0].method, "eth_sendRawTransaction");
+    assert.deepEqual(p.calls[0].params, [raw]);
+  });
+});
+