quantumcoin 7.0.9 → 7.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) hide show
  1. package/README-SDK.md +1 -5
  2. package/README.md +18 -3
  3. package/SPEC.md +2 -63
  4. package/config.js +10 -2
  5. package/examples/example.js +0 -5
  6. package/examples/example.ts +0 -5
  7. package/examples/node_modules/.bin/esbuild +16 -0
  8. package/examples/node_modules/.bin/esbuild.cmd +17 -0
  9. package/examples/node_modules/.bin/esbuild.ps1 +28 -0
  10. package/examples/node_modules/.bin/sdkgen +16 -0
  11. package/examples/node_modules/.bin/sdkgen.cmd +17 -0
  12. package/examples/node_modules/.bin/sdkgen.ps1 +28 -0
  13. package/examples/node_modules/.bin/tsx +16 -0
  14. package/examples/node_modules/.bin/tsx.cmd +17 -0
  15. package/examples/node_modules/.bin/tsx.ps1 +28 -0
  16. package/examples/node_modules/.package-lock.json +235 -0
  17. package/examples/node_modules/@esbuild/win32-x64/README.md +3 -0
  18. package/examples/node_modules/@esbuild/win32-x64/esbuild.exe +0 -0
  19. package/examples/node_modules/@esbuild/win32-x64/package.json +20 -0
  20. package/examples/node_modules/esbuild/LICENSE.md +21 -0
  21. package/examples/node_modules/esbuild/README.md +3 -0
  22. package/examples/node_modules/esbuild/bin/esbuild +223 -0
  23. package/examples/node_modules/esbuild/install.js +289 -0
  24. package/examples/node_modules/esbuild/lib/main.d.ts +716 -0
  25. package/examples/node_modules/esbuild/lib/main.js +2532 -0
  26. package/examples/node_modules/esbuild/package.json +49 -0
  27. package/examples/node_modules/get-tsconfig/LICENSE +21 -0
  28. package/examples/node_modules/get-tsconfig/README.md +235 -0
  29. package/examples/node_modules/get-tsconfig/dist/index.cjs +7 -0
  30. package/examples/node_modules/get-tsconfig/dist/index.d.cts +2088 -0
  31. package/examples/node_modules/get-tsconfig/dist/index.d.mts +2088 -0
  32. package/examples/node_modules/get-tsconfig/dist/index.mjs +7 -0
  33. package/examples/node_modules/get-tsconfig/package.json +46 -0
  34. package/examples/node_modules/quantum-coin-js-sdk/.github/workflows/publish-npmjs.yaml +22 -0
  35. package/examples/node_modules/quantum-coin-js-sdk/LICENSE +21 -0
  36. package/examples/node_modules/quantum-coin-js-sdk/LICENSE-wasm_exec.js.txt +30 -0
  37. package/examples/node_modules/quantum-coin-js-sdk/README.md +1665 -0
  38. package/examples/node_modules/quantum-coin-js-sdk/example/README.md +14 -0
  39. package/examples/node_modules/quantum-coin-js-sdk/example/conversion-example.js +19 -0
  40. package/examples/node_modules/quantum-coin-js-sdk/example/example-create-contract.js +396 -0
  41. package/examples/node_modules/quantum-coin-js-sdk/example/example-encode-decode-rlp.js +225 -0
  42. package/examples/node_modules/quantum-coin-js-sdk/example/example-event-pack-unpack.js +391 -0
  43. package/examples/node_modules/quantum-coin-js-sdk/example/example-misc.js +101 -0
  44. package/examples/node_modules/quantum-coin-js-sdk/example/example-rpc-send-signRawTransaction.js +318 -0
  45. package/examples/node_modules/quantum-coin-js-sdk/example/example-rpc-send.js +116 -0
  46. package/examples/node_modules/quantum-coin-js-sdk/example/example-send.js +70 -0
  47. package/examples/node_modules/quantum-coin-js-sdk/example/example-token-pack-unpack.js +961 -0
  48. package/examples/node_modules/quantum-coin-js-sdk/example/example-wallet-version4.js +35 -0
  49. package/examples/node_modules/quantum-coin-js-sdk/example/example-wallet.js +43 -0
  50. package/examples/node_modules/quantum-coin-js-sdk/example/example.js +405 -0
  51. package/examples/node_modules/quantum-coin-js-sdk/example/package-lock.json +134 -0
  52. package/examples/node_modules/quantum-coin-js-sdk/example/package.json +15 -0
  53. package/examples/node_modules/quantum-coin-js-sdk/index.d.ts +1024 -0
  54. package/examples/node_modules/quantum-coin-js-sdk/index.js +3062 -0
  55. package/examples/node_modules/quantum-coin-js-sdk/package.json +34 -0
  56. package/examples/node_modules/quantum-coin-js-sdk/tests/encrypted-32.json +1 -0
  57. package/examples/node_modules/quantum-coin-js-sdk/tests/encrypted-36.json +1 -0
  58. package/examples/node_modules/quantum-coin-js-sdk/tests/encrypted-48.json +1 -0
  59. package/examples/node_modules/quantum-coin-js-sdk/tests/generate-verify-vectors.js +91 -0
  60. package/examples/node_modules/quantum-coin-js-sdk/tests/non-transactional.preinit.test.js +41 -0
  61. package/examples/node_modules/quantum-coin-js-sdk/tests/non-transactional.test.js +686 -0
  62. package/examples/node_modules/quantum-coin-js-sdk/tests/sign-raw-keytype5-context-null.test.js +107 -0
  63. package/examples/node_modules/quantum-coin-js-sdk/tests/sign-raw-transaction.test.js +196 -0
  64. package/examples/node_modules/quantum-coin-js-sdk/tests/sign-verify.test.js +311 -0
  65. package/examples/node_modules/quantum-coin-js-sdk/tests/transactional.relay.test.js +131 -0
  66. package/examples/node_modules/quantum-coin-js-sdk/tests/transactional.rpc.test.js +103 -0
  67. package/examples/node_modules/quantum-coin-js-sdk/tests/verify-vectors.json +95035 -0
  68. package/examples/node_modules/quantum-coin-js-sdk/wasmBase64.d.ts +9 -0
  69. package/examples/node_modules/quantum-coin-js-sdk/wasmBase64.js +16 -0
  70. package/examples/node_modules/quantum-coin-js-sdk/wasm_exec.d.ts +0 -0
  71. package/examples/node_modules/quantum-coin-js-sdk/wasm_exec.js +587 -0
  72. package/examples/node_modules/resolve-pkg-maps/LICENSE +21 -0
  73. package/examples/node_modules/resolve-pkg-maps/README.md +216 -0
  74. package/examples/node_modules/resolve-pkg-maps/dist/index.cjs +1 -0
  75. package/examples/node_modules/resolve-pkg-maps/dist/index.d.cts +11 -0
  76. package/examples/node_modules/resolve-pkg-maps/dist/index.d.mts +11 -0
  77. package/examples/node_modules/resolve-pkg-maps/dist/index.mjs +1 -0
  78. package/examples/node_modules/resolve-pkg-maps/package.json +42 -0
  79. package/examples/node_modules/seed-words/.github/workflows/publish-npmjs.yaml +22 -0
  80. package/examples/node_modules/seed-words/BUILD.md +7 -0
  81. package/examples/node_modules/seed-words/LICENSE +121 -0
  82. package/examples/node_modules/seed-words/README.md +67 -0
  83. package/examples/node_modules/seed-words/dist/seedwords.d.ts +39 -0
  84. package/examples/node_modules/seed-words/package.json +27 -0
  85. package/examples/node_modules/seed-words/seedwords.js +315 -0
  86. package/examples/node_modules/seed-words/seedwords.txt +65536 -0
  87. package/examples/node_modules/seed-words/tsconfig.json +21 -0
  88. package/examples/node_modules/tsx/LICENSE +21 -0
  89. package/examples/node_modules/tsx/README.md +32 -0
  90. package/examples/node_modules/tsx/dist/cjs/api/index.cjs +1 -0
  91. package/examples/node_modules/tsx/dist/cjs/api/index.d.cts +35 -0
  92. package/examples/node_modules/tsx/dist/cjs/api/index.d.mts +35 -0
  93. package/examples/node_modules/tsx/dist/cjs/api/index.mjs +1 -0
  94. package/examples/node_modules/tsx/dist/cjs/index.cjs +1 -0
  95. package/examples/node_modules/tsx/dist/cjs/index.mjs +1 -0
  96. package/examples/node_modules/tsx/dist/cli.cjs +54 -0
  97. package/examples/node_modules/tsx/dist/cli.mjs +55 -0
  98. package/examples/node_modules/tsx/dist/client-BQVF1NaW.mjs +1 -0
  99. package/examples/node_modules/tsx/dist/client-D6NvIMSC.cjs +1 -0
  100. package/examples/node_modules/tsx/dist/esm/api/index.cjs +1 -0
  101. package/examples/node_modules/tsx/dist/esm/api/index.d.cts +35 -0
  102. package/examples/node_modules/tsx/dist/esm/api/index.d.mts +35 -0
  103. package/examples/node_modules/tsx/dist/esm/api/index.mjs +1 -0
  104. package/examples/node_modules/tsx/dist/esm/index.cjs +2 -0
  105. package/examples/node_modules/tsx/dist/esm/index.mjs +2 -0
  106. package/examples/node_modules/tsx/dist/get-pipe-path-BHW2eJdv.mjs +1 -0
  107. package/examples/node_modules/tsx/dist/get-pipe-path-BoR10qr8.cjs +1 -0
  108. package/examples/node_modules/tsx/dist/index-7AaEi15b.mjs +14 -0
  109. package/examples/node_modules/tsx/dist/index-BWFBUo6r.cjs +1 -0
  110. package/examples/node_modules/tsx/dist/index-gbaejti9.mjs +1 -0
  111. package/examples/node_modules/tsx/dist/index-gckBtVBf.cjs +14 -0
  112. package/examples/node_modules/tsx/dist/lexer-DQCqS3nf.mjs +3 -0
  113. package/examples/node_modules/tsx/dist/lexer-DgIbo0BU.cjs +3 -0
  114. package/examples/node_modules/tsx/dist/loader.cjs +1 -0
  115. package/examples/node_modules/tsx/dist/loader.mjs +1 -0
  116. package/examples/node_modules/tsx/dist/node-features-_8ZFwP_x.mjs +1 -0
  117. package/examples/node_modules/tsx/dist/node-features-roYmp9jK.cjs +1 -0
  118. package/examples/node_modules/tsx/dist/package-CeBgXWuR.mjs +1 -0
  119. package/examples/node_modules/tsx/dist/package-Dxt5kIHw.cjs +1 -0
  120. package/examples/node_modules/tsx/dist/patch-repl.cjs +1 -0
  121. package/examples/node_modules/tsx/dist/patch-repl.mjs +1 -0
  122. package/examples/node_modules/tsx/dist/preflight.cjs +1 -0
  123. package/examples/node_modules/tsx/dist/preflight.mjs +1 -0
  124. package/examples/node_modules/tsx/dist/register-2sWVXuRQ.cjs +1 -0
  125. package/examples/node_modules/tsx/dist/register-B7jrtLTO.mjs +1 -0
  126. package/examples/node_modules/tsx/dist/register-CFH5oNdT.mjs +4 -0
  127. package/examples/node_modules/tsx/dist/register-D46fvsV_.cjs +4 -0
  128. package/examples/node_modules/tsx/dist/repl.cjs +3 -0
  129. package/examples/node_modules/tsx/dist/repl.mjs +3 -0
  130. package/examples/node_modules/tsx/dist/require-D4F1Lv60.cjs +1 -0
  131. package/examples/node_modules/tsx/dist/require-DQxpCAr4.mjs +1 -0
  132. package/examples/node_modules/tsx/dist/suppress-warnings.cjs +1 -0
  133. package/examples/node_modules/tsx/dist/suppress-warnings.mjs +1 -0
  134. package/examples/node_modules/tsx/dist/temporary-directory-B83uKxJF.cjs +1 -0
  135. package/examples/node_modules/tsx/dist/temporary-directory-CwHp0_NW.mjs +1 -0
  136. package/examples/node_modules/tsx/dist/types-Cxp8y2TL.d.ts +5 -0
  137. package/examples/node_modules/tsx/package.json +68 -0
  138. package/examples/offline-signing.js +0 -2
  139. package/examples/offline-signing.ts +0 -1
  140. package/examples/package-lock.json +424 -73
  141. package/examples/package.json +2 -2
  142. package/examples/wallet-offline.js +10 -9
  143. package/examples/wallet-offline.ts +1 -9
  144. package/generate-sdk.js +4 -6
  145. package/package.json +2 -2
  146. package/src/abi/interface.js +13 -7
  147. package/src/abi/js-abi-coder.js +23 -18
  148. package/src/constants.d.ts +0 -5
  149. package/src/constants.js +0 -7
  150. package/src/contract/contract-factory.js +9 -3
  151. package/src/contract/contract.js +9 -3
  152. package/src/errors/index.js +12 -0
  153. package/src/index.d.ts +0 -3
  154. package/src/providers/extra-providers.js +20 -6
  155. package/src/providers/json-rpc-provider.js +15 -5
  156. package/src/providers/provider.d.ts +0 -2
  157. package/src/providers/provider.js +1 -3
  158. package/src/utils/address.d.ts +0 -14
  159. package/src/utils/address.js +12 -49
  160. package/src/utils/hashing.d.ts +0 -6
  161. package/src/utils/hashing.js +8 -23
  162. package/src/utils/index.d.ts +0 -3
  163. package/src/utils/rlp.js +7 -4
  164. package/src/wallet/wallet.d.ts +11 -13
  165. package/src/wallet/wallet.js +135 -96
  166. package/test/security/malformed-input.test.js +295 -1
  167. package/test/unit/address-wallet.test.js +277 -128
  168. package/test/unit/address-wallet.test.ts +276 -127
  169. package/test/unit/hashing.test.js +0 -11
  170. package/test/unit/hashing.test.ts +0 -11
  171. package/test/unit/providers.test.js +3 -1
  172. package/test/unit/providers.test.ts +3 -1
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Single test: keyType 5, signingContext null — sign + RPC submit.
3
+ * Run to see console logs (e.g. transactionGetTransactionHash2).
4
+ */
5
+ const { describe, test, before } = require('node:test');
6
+ const assert = require('node:assert/strict');
7
+
8
+ const qcsdk = require('..');
9
+
10
+ const MAINNET_CHAIN_ID = 123123;
11
+ const READ_RELAY_URL = 'https://sdk.readrelay.quantumcoinapi.com';
12
+ const WRITE_RELAY_URL = 'https://sdk.writerelay.quantumcoinapi.com';
13
+ const PUBLIC_RPC_URL = 'https://public.rpc.quantumcoinapi.com';
14
+ const TO_ADDRESS_EXAMPLE =
15
+ '0x8293cd9b6ac502d2fe077b0c157dad39f36a5e546525b053151dced633634612';
16
+
17
+ function isCirclAvailable() {
18
+ const w = qcsdk.newWallet();
19
+ return (
20
+ typeof w === 'object' &&
21
+ w != null &&
22
+ w.privateKey != null &&
23
+ w.address != null &&
24
+ qcsdk.verifyWallet(w) === true
25
+ );
26
+ }
27
+
28
+ async function rpc(method, params) {
29
+ const response = await fetch(PUBLIC_RPC_URL, {
30
+ method: 'POST',
31
+ headers: { 'Content-Type': 'application/json' },
32
+ body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
33
+ });
34
+ assert.ok(response.ok, `RPC HTTP ${response.status}`);
35
+ return response.json();
36
+ }
37
+
38
+ function isInsufficientGasErrorMessage(message) {
39
+ if (!message || typeof message !== 'string') return false;
40
+ const m = message.toLowerCase();
41
+ return (m.includes('insufficient') && m.includes('fund')) && m.includes('gas');
42
+ }
43
+
44
+ function makeTxReq(wallet, signingContext, nonce = 0) {
45
+ return new qcsdk.TransactionSigningRequest(
46
+ wallet,
47
+ TO_ADDRESS_EXAMPLE,
48
+ '0x0',
49
+ nonce,
50
+ null,
51
+ 21000,
52
+ null,
53
+ MAINNET_CHAIN_ID,
54
+ signingContext,
55
+ );
56
+ }
57
+
58
+ async function signAndSubmitRpc(wallet, signingContext) {
59
+ console.log('[test] eth_getTransactionCount...');
60
+ const txnCount = await rpc('eth_getTransactionCount', [wallet.address, 'latest']);
61
+ assert.ok(txnCount && (txnCount.result != null || txnCount.error));
62
+ assert.ok(txnCount.result != null, `eth_getTransactionCount failed: ${txnCount.error?.message ?? JSON.stringify(txnCount)}`);
63
+ const nonce = parseInt(txnCount.result, 16);
64
+ assert.ok(Number.isInteger(nonce) && nonce >= 0);
65
+ console.log('[test] nonce:', nonce);
66
+
67
+ const txReq = makeTxReq(wallet, signingContext, nonce);
68
+ console.log('[test] signRawTransaction(keyType 5, signingContext null)...');
69
+ const sign = qcsdk.signRawTransaction(txReq);
70
+ console.log('[test] signRawTransaction resultCode:', sign.resultCode);
71
+ assert.equal(sign.resultCode, 0, `signRawTransaction failed with resultCode ${sign.resultCode}`);
72
+ assert.ok(typeof sign.txnData === 'string' && sign.txnData.startsWith('0x'));
73
+
74
+ console.log('[test] eth_sendRawTransaction...');
75
+ const send = await rpc('eth_sendRawTransaction', [sign.txnData]);
76
+ console.log('[test] send result:', send?.result ?? null, 'error:', send?.error?.message ?? null);
77
+
78
+ if (send && send.result && typeof send.result === 'string') {
79
+ assert.ok(send.result.startsWith('0x'), 'expected tx hash');
80
+ console.log('[test] OK: tx hash', send.result);
81
+ return;
82
+ }
83
+
84
+ const msg = send?.error?.message ?? '';
85
+ assert.ok(
86
+ isInsufficientGasErrorMessage(msg),
87
+ `RPC submit failed with unexpected error: ${msg || JSON.stringify(send)}`,
88
+ );
89
+ console.log('[test] OK: insufficient funds for gas (expected for new wallet)');
90
+ }
91
+
92
+ describe('signRawTransaction keyType 5 signingContext null', () => {
93
+ before(async () => {
94
+ console.log('[test] initialize SDK...');
95
+ const cfg = new qcsdk.Config(READ_RELAY_URL, WRITE_RELAY_URL, MAINNET_CHAIN_ID, '', '');
96
+ const initResult = await qcsdk.initialize(cfg);
97
+ assert.equal(initResult, true, 'SDK initialize should succeed');
98
+ });
99
+
100
+ test('keyType 5, signingContext null — sign + RPC submit', { timeout: 120_000 }, async () => {
101
+ assert.ok(isCirclAvailable());
102
+ const wallet = qcsdk.newWallet(5);
103
+ assert.ok(wallet && typeof wallet === 'object');
104
+ console.log('[test] wallet address:', wallet.address);
105
+ await signAndSubmitRpc(wallet, null);
106
+ });
107
+ });
@@ -0,0 +1,196 @@
1
+ const { describe, test, before } = require('node:test');
2
+ const assert = require('node:assert/strict');
3
+
4
+ /**
5
+ * signRawTransaction tests: keyType (null, 3, 5) × signingContext (null, 0, 1, 2).
6
+ * Positive: sign then eth_sendRawTransaction; expect no error or insufficient funds for gas.
7
+ * Negative: signRawTransaction returns resultCode !== 0.
8
+ */
9
+ const qcsdk = require('..');
10
+
11
+ const MAINNET_CHAIN_ID = 123123;
12
+ const READ_RELAY_URL = 'https://sdk.readrelay.quantumcoinapi.com';
13
+ const WRITE_RELAY_URL = 'https://sdk.writerelay.quantumcoinapi.com';
14
+ const PUBLIC_RPC_URL = 'https://public.rpc.quantumcoinapi.com';
15
+ const TO_ADDRESS_EXAMPLE =
16
+ '0x8293cd9b6ac502d2fe077b0c157dad39f36a5e546525b053151dced633634612';
17
+
18
+ function isCirclAvailable() {
19
+ const w = qcsdk.newWallet();
20
+ return (
21
+ typeof w === 'object' &&
22
+ w != null &&
23
+ w.privateKey != null &&
24
+ w.address != null &&
25
+ qcsdk.verifyWallet(w) === true
26
+ );
27
+ }
28
+
29
+ function isHex0x(str) {
30
+ return typeof str === 'string' && /^0x[0-9a-fA-F]*$/.test(str);
31
+ }
32
+
33
+ async function rpc(method, params) {
34
+ const response = await fetch(PUBLIC_RPC_URL, {
35
+ method: 'POST',
36
+ headers: { 'Content-Type': 'application/json' },
37
+ body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
38
+ });
39
+ assert.ok(response.ok, `RPC HTTP ${response.status}`);
40
+ return response.json();
41
+ }
42
+
43
+ function isInsufficientGasErrorMessage(message) {
44
+ if (!message || typeof message !== 'string') return false;
45
+ const m = message.toLowerCase();
46
+ return (m.includes('insufficient') && m.includes('fund')) && m.includes('gas');
47
+ }
48
+
49
+ function makeTxReq(wallet, signingContext, nonce = 0) {
50
+ return new qcsdk.TransactionSigningRequest(
51
+ wallet,
52
+ TO_ADDRESS_EXAMPLE,
53
+ '0x0',
54
+ nonce,
55
+ null,
56
+ 21000,
57
+ null,
58
+ MAINNET_CHAIN_ID,
59
+ signingContext,
60
+ );
61
+ }
62
+
63
+ /** Sign, submit via RPC; assert success (tx hash) or insufficient funds for gas only. */
64
+ async function signAndSubmitRpc(wallet, signingContext) {
65
+ const txnCount = await rpc('eth_getTransactionCount', [wallet.address, 'latest']);
66
+ assert.ok(txnCount && (txnCount.result != null || txnCount.error), `RPC error: ${txnCount.error?.message ?? 'unknown'}`);
67
+ assert.ok(txnCount.result != null, `eth_getTransactionCount failed: ${txnCount.error?.message ?? JSON.stringify(txnCount)}`);
68
+ const nonce = parseInt(txnCount.result, 16);
69
+ assert.ok(Number.isInteger(nonce) && nonce >= 0);
70
+
71
+ const txReq = makeTxReq(wallet, signingContext, nonce);
72
+ const sign = qcsdk.signRawTransaction(txReq);
73
+ assert.equal(sign.resultCode, 0, `signRawTransaction failed with resultCode ${sign.resultCode}`);
74
+ assert.ok(typeof sign.txnData === 'string' && sign.txnData.startsWith('0x'));
75
+
76
+ const send = await rpc('eth_sendRawTransaction', [sign.txnData]);
77
+
78
+ if (send && send.result && typeof send.result === 'string') {
79
+ assert.ok(send.result.startsWith('0x'), 'expected tx hash');
80
+ return;
81
+ }
82
+
83
+ const msg = send?.error?.message ?? '';
84
+ assert.ok(
85
+ isInsufficientGasErrorMessage(msg),
86
+ `RPC submit failed with unexpected error: ${msg || JSON.stringify(send)}`,
87
+ );
88
+ }
89
+
90
+ describe('signRawTransaction', () => {
91
+ before(async () => {
92
+ const cfg = new qcsdk.Config(READ_RELAY_URL, WRITE_RELAY_URL, MAINNET_CHAIN_ID, '', '');
93
+ const initResult = await qcsdk.initialize(cfg);
94
+ assert.equal(initResult, true, 'SDK initialize should succeed');
95
+ });
96
+
97
+ test('CIRCL is available', () => {
98
+ assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded and verifyWallet(newWallet()) must pass');
99
+ });
100
+
101
+ describe('positive: sign + RPC submit (no error or insufficient funds for gas only)', { concurrency: 1 }, () => {
102
+ test('keyType null, signingContext null', { timeout: 120_000 }, async () => {
103
+ assert.ok(isCirclAvailable());
104
+ const wallet = qcsdk.newWallet(null);
105
+ assert.ok(wallet && typeof wallet === 'object', 'newWallet(null) must return a wallet');
106
+ await signAndSubmitRpc(wallet, null);
107
+ });
108
+
109
+ test('keyType null, signingContext 0', { timeout: 120_000 }, async () => {
110
+ assert.ok(isCirclAvailable());
111
+ const wallet = qcsdk.newWallet(null);
112
+ assert.ok(wallet && typeof wallet === 'object');
113
+ await signAndSubmitRpc(wallet, 0);
114
+ });
115
+
116
+ test('keyType null, signingContext 2', { timeout: 120_000 }, async () => {
117
+ assert.ok(isCirclAvailable());
118
+ const wallet = qcsdk.newWallet(null);
119
+ assert.ok(wallet && typeof wallet === 'object');
120
+ await signAndSubmitRpc(wallet, 2);
121
+ });
122
+
123
+ test('keyType 3, signingContext null', { timeout: 120_000 }, async () => {
124
+ assert.ok(isCirclAvailable());
125
+ const wallet = qcsdk.newWallet(3);
126
+ assert.ok(wallet && typeof wallet === 'object');
127
+ await signAndSubmitRpc(wallet, null);
128
+ });
129
+
130
+ test('keyType 3, signingContext 0', { timeout: 120_000 }, async () => {
131
+ assert.ok(isCirclAvailable());
132
+ const wallet = qcsdk.newWallet(3);
133
+ assert.ok(wallet && typeof wallet === 'object');
134
+ await signAndSubmitRpc(wallet, 0);
135
+ });
136
+
137
+ test('keyType 3, signingContext 2', { timeout: 120_000 }, async () => {
138
+ assert.ok(isCirclAvailable());
139
+ const wallet = qcsdk.newWallet(3);
140
+ assert.ok(wallet && typeof wallet === 'object');
141
+ await signAndSubmitRpc(wallet, 2);
142
+ });
143
+
144
+ test('keyType 5, signingContext null', { timeout: 120_000 }, async () => {
145
+ assert.ok(isCirclAvailable());
146
+ const wallet = qcsdk.newWallet(5);
147
+ assert.ok(wallet && typeof wallet === 'object');
148
+ await signAndSubmitRpc(wallet, null);
149
+ });
150
+
151
+ test('keyType 5, signingContext 1', { timeout: 120_000 }, async () => {
152
+ assert.ok(isCirclAvailable());
153
+ const wallet = qcsdk.newWallet(5);
154
+ assert.ok(wallet && typeof wallet === 'object');
155
+ await signAndSubmitRpc(wallet, 1);
156
+ });
157
+ });
158
+
159
+ describe('negative: signRawTransaction returns error (resultCode !== 0)', () => {
160
+ test('keyType 3 wallet with signingContext 1 (hybrid5) -> mismatch', () => {
161
+ assert.ok(isCirclAvailable());
162
+ const wallet = qcsdk.newWallet(3);
163
+ assert.ok(wallet && typeof wallet === 'object');
164
+ const txReq = makeTxReq(wallet, 1);
165
+ const result = qcsdk.signRawTransaction(txReq);
166
+ assert.notEqual(result.resultCode, 0, `expected error, got resultCode ${result.resultCode}`);
167
+ });
168
+
169
+ test('keyType 5 wallet with signingContext 0 (hybrid compact) -> mismatch', () => {
170
+ assert.ok(isCirclAvailable());
171
+ const wallet = qcsdk.newWallet(5);
172
+ assert.ok(wallet && typeof wallet === 'object');
173
+ const txReq = makeTxReq(wallet, 0);
174
+ const result = qcsdk.signRawTransaction(txReq);
175
+ assert.notEqual(result.resultCode, 0, `expected error, got resultCode ${result.resultCode}`);
176
+ });
177
+
178
+ test('keyType 5 wallet with signingContext 2 (hybrid full) -> mismatch', () => {
179
+ assert.ok(isCirclAvailable());
180
+ const wallet = qcsdk.newWallet(5);
181
+ assert.ok(wallet && typeof wallet === 'object');
182
+ const txReq = makeTxReq(wallet, 2);
183
+ const result = qcsdk.signRawTransaction(txReq);
184
+ assert.notEqual(result.resultCode, 0, `expected error, got resultCode ${result.resultCode}`);
185
+ });
186
+
187
+ test('invalid signingContext (e.g. 99) -> error', () => {
188
+ assert.ok(isCirclAvailable());
189
+ const wallet = qcsdk.newWallet(3);
190
+ assert.ok(wallet && typeof wallet === 'object');
191
+ const txReq = makeTxReq(wallet, 99);
192
+ const result = qcsdk.signRawTransaction(txReq);
193
+ assert.notEqual(result.resultCode, 0, `expected error for signingContext 99, got ${result.resultCode}`);
194
+ });
195
+ });
196
+ });
@@ -0,0 +1,311 @@
1
+ /**
2
+ * Tests for sign(privateKey, message) and verify(publicKey, signature, message).
3
+ * Covers all 3 key types: default (null → type 3), 3, and 5.
4
+ */
5
+ const { describe, test, before } = require('node:test');
6
+ const assert = require('node:assert/strict');
7
+
8
+ const qcsdk = require('..');
9
+
10
+ const MAINNET_CHAIN_ID = 123123;
11
+ const READ_RELAY_URL = 'https://sdk.readrelay.quantumcoinapi.com';
12
+ const WRITE_RELAY_URL = 'https://sdk.writerelay.quantumcoinapi.com';
13
+
14
+ // 32-byte message (CIRCL expects fixed length where applicable)
15
+ const MESSAGE_32 = new Uint8Array(32);
16
+ for (let i = 0; i < 32; i++) MESSAGE_32[i] = (i + 1) & 0xff;
17
+
18
+ function isCirclAvailable() {
19
+ const w = qcsdk.newWallet();
20
+ return (
21
+ typeof w === 'object' &&
22
+ w != null &&
23
+ w.privateKey != null &&
24
+ w.address != null &&
25
+ qcsdk.verifyWallet(w) === true
26
+ );
27
+ }
28
+
29
+ function toByteArray(buf) {
30
+ return buf instanceof Uint8Array ? Array.from(buf) : buf;
31
+ }
32
+
33
+ describe('sign and verify', () => {
34
+ before(async () => {
35
+ const cfg = new qcsdk.Config(READ_RELAY_URL, WRITE_RELAY_URL, MAINNET_CHAIN_ID, '', '');
36
+ const initResult = await qcsdk.initialize(cfg);
37
+ assert.equal(initResult, true, 'SDK initialize should succeed');
38
+ });
39
+
40
+ test('CIRCL is available', () => {
41
+ assert.ok(isCirclAvailable(), 'CIRCL must be loaded and verifyWallet(newWallet()) must pass');
42
+ });
43
+
44
+ test('keyType default (null): sign then verify with wallet bytes', () => {
45
+ assert.ok(isCirclAvailable());
46
+ const wallet = qcsdk.newWallet(null);
47
+ assert.ok(wallet && typeof wallet === 'object');
48
+ const privateKey = wallet.privateKey;
49
+ const publicKey = wallet.publicKey;
50
+ const message = toByteArray(MESSAGE_32);
51
+
52
+ const signResult = qcsdk.sign(privateKey, message);
53
+ assert.equal(signResult.resultCode, 0, `sign failed: resultCode ${signResult.resultCode}`);
54
+ assert.ok(signResult.signature != null && signResult.signature.length > 0);
55
+
56
+ const verifyResult = qcsdk.verify(publicKey, signResult.signature, message);
57
+ assert.equal(verifyResult.resultCode, 0, `verify failed: resultCode ${verifyResult.resultCode}`);
58
+ assert.equal(verifyResult.valid, true);
59
+ });
60
+
61
+ test('keyType 3: sign then verify with wallet bytes', () => {
62
+ assert.ok(isCirclAvailable());
63
+ const wallet = qcsdk.newWallet(3);
64
+ assert.ok(wallet && typeof wallet === 'object');
65
+ const privateKey = wallet.privateKey;
66
+ const publicKey = wallet.publicKey;
67
+ const message = toByteArray(MESSAGE_32);
68
+
69
+ const signResult = qcsdk.sign(privateKey, message);
70
+ assert.equal(signResult.resultCode, 0, `sign failed: resultCode ${signResult.resultCode}`);
71
+ assert.ok(signResult.signature != null && signResult.signature.length > 0);
72
+
73
+ const verifyResult = qcsdk.verify(publicKey, signResult.signature, message);
74
+ assert.equal(verifyResult.resultCode, 0, `verify failed: resultCode ${verifyResult.resultCode}`);
75
+ assert.equal(verifyResult.valid, true);
76
+ });
77
+
78
+ test('keyType 5: sign then verify with wallet bytes', () => {
79
+ assert.ok(isCirclAvailable());
80
+ const wallet = qcsdk.newWallet(5);
81
+ assert.ok(wallet && typeof wallet === 'object');
82
+ const privateKey = wallet.privateKey;
83
+ const publicKey = wallet.publicKey;
84
+ const message = toByteArray(MESSAGE_32);
85
+
86
+ const signResult = qcsdk.sign(privateKey, message);
87
+ assert.equal(signResult.resultCode, 0, `sign failed: resultCode ${signResult.resultCode}`);
88
+ assert.ok(signResult.signature != null && signResult.signature.length > 0);
89
+
90
+ const verifyResult = qcsdk.verify(publicKey, signResult.signature, message);
91
+ assert.equal(verifyResult.resultCode, 0, `verify failed: resultCode ${verifyResult.resultCode}`);
92
+ assert.equal(verifyResult.valid, true);
93
+ });
94
+
95
+ test('verify with wrong message returns valid: false', () => {
96
+ assert.ok(isCirclAvailable());
97
+ const wallet = qcsdk.newWallet(null);
98
+ const message = toByteArray(MESSAGE_32);
99
+ const signResult = qcsdk.sign(wallet.privateKey, message);
100
+ assert.equal(signResult.resultCode, 0);
101
+
102
+ const wrongMessage = new Uint8Array(32);
103
+ wrongMessage[0] = 0xff;
104
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, wrongMessage);
105
+ assert.equal(verifyResult.valid, false, 'valid must be false for wrong message');
106
+ // resultCode may be -717 (CIRCL error) or -719 (signature invalid)
107
+ assert.ok(verifyResult.resultCode === -717 || verifyResult.resultCode === -719);
108
+ });
109
+
110
+ test('sign with invalid privateKey returns error code', () => {
111
+ const result = qcsdk.sign(null, MESSAGE_32);
112
+ assert.notEqual(result.resultCode, 0);
113
+ assert.equal(result.signature, null);
114
+ });
115
+
116
+ test('verify with invalid publicKey returns error code', () => {
117
+ assert.ok(isCirclAvailable());
118
+ const wallet = qcsdk.newWallet(null);
119
+ const signResult = qcsdk.sign(wallet.privateKey, toByteArray(MESSAGE_32));
120
+ assert.equal(signResult.resultCode, 0);
121
+
122
+ const result = qcsdk.verify(null, signResult.signature, toByteArray(MESSAGE_32));
123
+ assert.notEqual(result.resultCode, 0);
124
+ assert.equal(result.valid, false);
125
+ });
126
+
127
+ test('sign with explicit signingContext 0 (keyType 3 wallet) then verify', () => {
128
+ assert.ok(isCirclAvailable());
129
+ const wallet = qcsdk.newWallet(3);
130
+ const message = toByteArray(MESSAGE_32);
131
+ const signResult = qcsdk.sign(wallet.privateKey, message, 0);
132
+ assert.equal(signResult.resultCode, 0, `sign failed: ${signResult.resultCode}`);
133
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
134
+ assert.equal(verifyResult.resultCode, 0);
135
+ assert.equal(verifyResult.valid, true);
136
+ });
137
+
138
+ test('sign with explicit signingContext 1 (keyType 5 wallet) then verify', () => {
139
+ assert.ok(isCirclAvailable());
140
+ const wallet = qcsdk.newWallet(5);
141
+ const message = toByteArray(MESSAGE_32);
142
+ const signResult = qcsdk.sign(wallet.privateKey, message, 1);
143
+ assert.equal(signResult.resultCode, 0, `sign failed: ${signResult.resultCode}`);
144
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
145
+ assert.equal(verifyResult.resultCode, 0);
146
+ assert.equal(verifyResult.valid, true);
147
+ });
148
+
149
+ test('sign with explicit signingContext 2 (keyType 3 wallet) then verify', () => {
150
+ assert.ok(isCirclAvailable());
151
+ const wallet = qcsdk.newWallet(3);
152
+ const message = toByteArray(MESSAGE_32);
153
+ const signResult = qcsdk.sign(wallet.privateKey, message, 2);
154
+ assert.equal(signResult.resultCode, 0, `sign failed: ${signResult.resultCode}`);
155
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
156
+ assert.equal(verifyResult.resultCode, 0);
157
+ assert.equal(verifyResult.valid, true);
158
+ });
159
+
160
+ test('sign with invalid signingContext returns error code', () => {
161
+ assert.ok(isCirclAvailable());
162
+ const wallet = qcsdk.newWallet(3);
163
+ const result = qcsdk.sign(wallet.privateKey, toByteArray(MESSAGE_32), 99);
164
+ assert.notEqual(result.resultCode, 0);
165
+ assert.equal(result.signature, null);
166
+ });
167
+ });
168
+
169
+ describe('verify by signature first byte (types 3, 4, 5)', () => {
170
+ test('verify type 3 (signCompact): sign(..., 0) then verify', () => {
171
+ const wallet = qcsdk.newWallet(3);
172
+ const message = toByteArray(MESSAGE_32);
173
+ const signResult = qcsdk.sign(wallet.privateKey, message, 0);
174
+ assert.equal(signResult.resultCode, 0);
175
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
176
+ assert.equal(verifyResult.resultCode, 0);
177
+ assert.equal(verifyResult.valid, true);
178
+ });
179
+
180
+ test('verify type 4 (hybrid full): sign(..., 2) then verify', () => {
181
+ const wallet = qcsdk.newWallet(3);
182
+ const message = toByteArray(MESSAGE_32);
183
+ const signResult = qcsdk.sign(wallet.privateKey, message, 2);
184
+ assert.equal(signResult.resultCode, 0);
185
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
186
+ assert.equal(verifyResult.resultCode, 0);
187
+ assert.equal(verifyResult.valid, true);
188
+ });
189
+
190
+ test('verify type 5 (hybrid5): sign(..., 1) then verify', () => {
191
+ const wallet = qcsdk.newWallet(5);
192
+ const message = toByteArray(MESSAGE_32);
193
+ const signResult = qcsdk.sign(wallet.privateKey, message, 1);
194
+ assert.equal(signResult.resultCode, 0);
195
+ const verifyResult = qcsdk.verify(wallet.publicKey, signResult.signature, message);
196
+ assert.equal(verifyResult.resultCode, 0);
197
+ assert.equal(verifyResult.valid, true);
198
+ });
199
+
200
+ test('verify with invalid signature first byte returns -718', () => {
201
+ const wallet = qcsdk.newWallet(3);
202
+ const signResult = qcsdk.sign(wallet.privateKey, toByteArray(MESSAGE_32), 0);
203
+ assert.equal(signResult.resultCode, 0);
204
+ const sig = signResult.signature;
205
+ const badSig = Array.isArray(sig) ? sig.slice() : Array.from(sig);
206
+ badSig[0] = 0;
207
+ const result = qcsdk.verify(wallet.publicKey, badSig, toByteArray(MESSAGE_32));
208
+ assert.equal(result.resultCode, -718, 'first byte 0 is unknown type');
209
+ assert.equal(result.valid, false);
210
+ });
211
+
212
+ test('verify type 1 (hybrideds verifyCompact): dispatch runs, wrong sig fails with -717 or -719', () => {
213
+ const wallet = qcsdk.newWallet(3);
214
+ const signResult = qcsdk.sign(wallet.privateKey, toByteArray(MESSAGE_32), 0);
215
+ assert.equal(signResult.resultCode, 0);
216
+ const sig = signResult.signature;
217
+ const sigWithType1 = Array.isArray(sig) ? sig.slice() : Array.from(sig);
218
+ sigWithType1[0] = 1;
219
+ const result = qcsdk.verify(wallet.publicKey, sigWithType1, toByteArray(MESSAGE_32));
220
+ assert.equal(result.valid, false);
221
+ assert.ok(result.resultCode === -717 || result.resultCode === -719, 'type 1 dispatch should run and fail verify');
222
+ });
223
+
224
+ test('verify type 2 (hybrideds verify): dispatch runs, wrong sig fails with -717 or -719', () => {
225
+ const wallet = qcsdk.newWallet(3);
226
+ const signResult = qcsdk.sign(wallet.privateKey, toByteArray(MESSAGE_32), 0);
227
+ assert.equal(signResult.resultCode, 0);
228
+ const sig = signResult.signature;
229
+ const sigWithType2 = Array.isArray(sig) ? sig.slice() : Array.from(sig);
230
+ sigWithType2[0] = 2;
231
+ const result = qcsdk.verify(wallet.publicKey, sigWithType2, toByteArray(MESSAGE_32));
232
+ assert.equal(result.valid, false);
233
+ assert.ok(result.resultCode === -717 || result.resultCode === -719, 'type 2 dispatch should run and fail verify');
234
+ });
235
+ });
236
+
237
+ describe('verify hardcoded deterministic', () => {
238
+ const vectors = require('./verify-vectors.json');
239
+
240
+ describe('keyType 3 verifyCompact (32-word seed, sign context 0)', () => {
241
+ const { publicKey: PUBLIC_KEY, signature: SIGNATURE, message: MESSAGE } = vectors.type3Compact;
242
+
243
+ test('accepts hardcoded publicKey + signature + message', () => {
244
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, MESSAGE);
245
+ assert.equal(result.resultCode, 0, `expected resultCode 0, got ${result.resultCode}`);
246
+ assert.equal(result.valid, true, 'valid must be true for correct vector');
247
+ });
248
+
249
+ test('rejects hardcoded vector with wrong signature', () => {
250
+ const wrongSignature = SIGNATURE.slice();
251
+ wrongSignature[0] = (wrongSignature[0] + 1) % 256;
252
+ const result = qcsdk.verify(PUBLIC_KEY, wrongSignature, MESSAGE);
253
+ assert.equal(result.valid, false, 'valid must be false for wrong signature');
254
+ });
255
+
256
+ test('rejects hardcoded vector with wrong message', () => {
257
+ const wrongMessage = MESSAGE.slice();
258
+ wrongMessage[0] = (wrongMessage[0] + 1) % 256;
259
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, wrongMessage);
260
+ assert.equal(result.valid, false, 'valid must be false for wrong message');
261
+ });
262
+ });
263
+
264
+ describe('keyType 3 verify full (32-word seed, sign context 2)', () => {
265
+ const { publicKey: PUBLIC_KEY, signature: SIGNATURE, message: MESSAGE } = vectors.type3Full;
266
+
267
+ test('accepts hardcoded publicKey + signature + message', () => {
268
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, MESSAGE);
269
+ assert.equal(result.resultCode, 0, `expected resultCode 0, got ${result.resultCode}`);
270
+ assert.equal(result.valid, true, 'valid must be true for correct vector');
271
+ });
272
+
273
+ test('rejects hardcoded vector with wrong signature', () => {
274
+ const wrongSignature = SIGNATURE.slice();
275
+ wrongSignature[0] = (wrongSignature[0] + 1) % 256;
276
+ const result = qcsdk.verify(PUBLIC_KEY, wrongSignature, MESSAGE);
277
+ assert.equal(result.valid, false, 'valid must be false for wrong signature');
278
+ });
279
+
280
+ test('rejects hardcoded vector with wrong message', () => {
281
+ const wrongMessage = MESSAGE.slice();
282
+ wrongMessage[0] = (wrongMessage[0] + 1) % 256;
283
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, wrongMessage);
284
+ assert.equal(result.valid, false, 'valid must be false for wrong message');
285
+ });
286
+ });
287
+
288
+ describe('keyType 5 (36-word seed, sign context 1)', () => {
289
+ const { publicKey: PUBLIC_KEY, signature: SIGNATURE, message: MESSAGE } = vectors.type5;
290
+
291
+ test('accepts hardcoded publicKey + signature + message', () => {
292
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, MESSAGE);
293
+ assert.equal(result.resultCode, 0, `expected resultCode 0, got ${result.resultCode}`);
294
+ assert.equal(result.valid, true, 'valid must be true for correct vector');
295
+ });
296
+
297
+ test('rejects hardcoded vector with wrong signature', () => {
298
+ const wrongSignature = SIGNATURE.slice();
299
+ wrongSignature[0] = (wrongSignature[0] + 1) % 256;
300
+ const result = qcsdk.verify(PUBLIC_KEY, wrongSignature, MESSAGE);
301
+ assert.equal(result.valid, false, 'valid must be false for wrong signature');
302
+ });
303
+
304
+ test('rejects hardcoded vector with wrong message', () => {
305
+ const wrongMessage = MESSAGE.slice();
306
+ wrongMessage[0] = (wrongMessage[0] + 1) % 256;
307
+ const result = qcsdk.verify(PUBLIC_KEY, SIGNATURE, wrongMessage);
308
+ assert.equal(result.valid, false, 'valid must be false for wrong message');
309
+ });
310
+ });
311
+ });