quantumcoin 7.0.3 → 7.0.5

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 (155) hide show
  1. package/.github/workflows/publish-npmjs.yaml +22 -22
  2. package/.gitignore +15 -15
  3. package/LICENSE +21 -21
  4. package/README-SDK.md +758 -754
  5. package/README.md +165 -150
  6. package/SPEC.md +3845 -3843
  7. package/config.d.ts +50 -50
  8. package/config.js +115 -115
  9. package/examples/AllSolidityTypes.sol +184 -184
  10. package/examples/SimpleIERC20.sol +74 -74
  11. package/examples/events.js +41 -35
  12. package/examples/events.ts +35 -0
  13. package/examples/example-generator-sdk-js.js +100 -95
  14. package/examples/example-generator-sdk-js.ts +77 -0
  15. package/examples/example-generator-sdk-ts.js +100 -95
  16. package/examples/example-generator-sdk-ts.ts +77 -0
  17. package/examples/example.js +72 -61
  18. package/examples/example.ts +61 -0
  19. package/examples/offline-signing.js +79 -73
  20. package/examples/offline-signing.ts +66 -0
  21. package/examples/package-lock.json +596 -57
  22. package/examples/package.json +32 -16
  23. package/examples/read-operations.js +32 -27
  24. package/examples/read-operations.ts +31 -0
  25. package/examples/sdk-generator-erc20.inline.json +251 -251
  26. package/examples/solidity-types.ts +43 -43
  27. package/examples/wallet-offline.js +35 -29
  28. package/examples/wallet-offline.ts +34 -0
  29. package/generate-sdk.js +1824 -1490
  30. package/index.js +12 -12
  31. package/package.json +95 -75
  32. package/scripts/copy-declarations.js +31 -0
  33. package/scripts/run-all-one-by-one.js +151 -0
  34. package/src/abi/fragments.d.ts +42 -42
  35. package/src/abi/fragments.js +63 -63
  36. package/src/abi/index.d.ts +13 -13
  37. package/src/abi/index.js +9 -9
  38. package/src/abi/interface.d.ts +128 -132
  39. package/src/abi/interface.js +590 -590
  40. package/src/abi/js-abi-coder.d.ts +8 -0
  41. package/src/abi/js-abi-coder.js +474 -474
  42. package/src/constants.d.ts +66 -61
  43. package/src/constants.js +101 -94
  44. package/src/contract/contract-factory.d.ts +28 -28
  45. package/src/contract/contract-factory.js +105 -105
  46. package/src/contract/contract.d.ts +113 -114
  47. package/src/contract/contract.js +354 -354
  48. package/src/contract/index.d.ts +9 -9
  49. package/src/contract/index.js +9 -9
  50. package/src/errors/index.d.ts +92 -92
  51. package/src/errors/index.js +188 -188
  52. package/src/generator/index.d.ts +74 -0
  53. package/src/generator/index.js +1404 -1404
  54. package/src/index.d.ts +125 -127
  55. package/src/index.js +41 -41
  56. package/src/internal/hex.d.ts +61 -61
  57. package/src/internal/hex.js +144 -144
  58. package/src/providers/extra-providers.d.ts +139 -128
  59. package/src/providers/extra-providers.js +600 -575
  60. package/src/providers/index.d.ts +17 -16
  61. package/src/providers/index.js +10 -10
  62. package/src/providers/json-rpc-provider.d.ts +12 -12
  63. package/src/providers/json-rpc-provider.js +79 -79
  64. package/src/providers/provider.d.ts +208 -203
  65. package/src/providers/provider.js +393 -371
  66. package/src/types/index.d.ts +214 -462
  67. package/src/types/index.js +9 -9
  68. package/src/utils/address.d.ts +72 -72
  69. package/src/utils/address.js +181 -182
  70. package/src/utils/encoding.d.ts +120 -120
  71. package/src/utils/encoding.js +306 -306
  72. package/src/utils/hashing.d.ts +82 -76
  73. package/src/utils/hashing.js +313 -298
  74. package/src/utils/index.d.ts +65 -55
  75. package/src/utils/index.js +13 -13
  76. package/src/utils/result.d.ts +57 -57
  77. package/src/utils/result.js +128 -128
  78. package/src/utils/rlp.d.ts +12 -12
  79. package/src/utils/rlp.js +200 -200
  80. package/src/utils/units.d.ts +29 -29
  81. package/src/utils/units.js +107 -107
  82. package/src/wallet/index.d.ts +10 -10
  83. package/src/wallet/index.js +8 -8
  84. package/src/wallet/wallet.d.ts +168 -160
  85. package/src/wallet/wallet.js +500 -489
  86. package/test/e2e/all-solidity-types.dynamic.test.js +207 -200
  87. package/test/e2e/all-solidity-types.dynamic.test.ts +191 -0
  88. package/test/e2e/all-solidity-types.fixtures.js +231 -231
  89. package/test/e2e/all-solidity-types.generated-sdks.e2e.test.js +387 -368
  90. package/test/e2e/all-solidity-types.generated-sdks.e2e.test.ts +350 -0
  91. package/test/e2e/helpers.js +59 -47
  92. package/test/e2e/signing-context-and-fee.e2e.test.js +141 -0
  93. package/test/e2e/signing-context-and-fee.e2e.test.ts +128 -0
  94. package/test/e2e/simple-erc20.generated-sdks.e2e.test.js +168 -151
  95. package/test/e2e/simple-erc20.generated-sdks.e2e.test.ts +141 -0
  96. package/test/e2e/transactional.test.js +245 -191
  97. package/test/e2e/transactional.test.ts +208 -0
  98. package/test/e2e/typed-generator.e2e.test.js +407 -404
  99. package/test/e2e/typed-generator.e2e.test.ts +337 -0
  100. package/test/fixtures/ConstructorParam.sol +23 -23
  101. package/test/fixtures/MultiContracts.sol +37 -37
  102. package/test/fixtures/SimpleStorage.sol +18 -18
  103. package/test/fixtures/StakingContract.abi.json +1 -1
  104. package/test/integration/ipc-provider.test.js +49 -44
  105. package/test/integration/ipc-provider.test.ts +44 -0
  106. package/test/integration/provider.test.js +88 -72
  107. package/test/integration/provider.test.ts +85 -0
  108. package/test/integration/ws-provider.test.js +41 -33
  109. package/test/integration/ws-provider.test.ts +38 -0
  110. package/test/security/malformed-input.test.js +37 -31
  111. package/test/security/malformed-input.test.ts +35 -0
  112. package/test/unit/_encrypted-output.txt +6 -0
  113. package/test/unit/_log-encrypted-jsons.js +45 -0
  114. package/test/unit/_write-keystore-fixture.js +16 -0
  115. package/test/unit/abi-interface.test.js +103 -98
  116. package/test/unit/abi-interface.test.ts +102 -0
  117. package/test/unit/address-wallet.test.js +392 -257
  118. package/test/unit/address-wallet.test.ts +379 -0
  119. package/test/unit/browser-provider.test.js +85 -82
  120. package/test/unit/browser-provider.test.ts +79 -0
  121. package/test/unit/contract.test.js +85 -82
  122. package/test/unit/contract.test.ts +83 -0
  123. package/test/unit/encoding-units-rlp.test.js +92 -89
  124. package/test/unit/encoding-units-rlp.test.ts +91 -0
  125. package/test/unit/errors.test.js +77 -74
  126. package/test/unit/errors.test.ts +76 -0
  127. package/test/unit/filter-by-blockhash.test.js +55 -52
  128. package/test/unit/filter-by-blockhash.test.ts +54 -0
  129. package/test/unit/fixtures/encrypted-keystores-48-32-36.js +9 -0
  130. package/test/unit/generate-contract-cli.test.js +42 -39
  131. package/test/unit/generate-contract-cli.test.ts +41 -0
  132. package/test/unit/generate-sdk-artifacts-json.test.js +113 -110
  133. package/test/unit/generate-sdk-artifacts-json.test.ts +110 -0
  134. package/test/unit/generator.test.js +102 -99
  135. package/test/unit/generator.test.ts +101 -0
  136. package/test/unit/hashing.test.js +68 -54
  137. package/test/unit/hashing.test.ts +67 -0
  138. package/test/unit/init.test.js +39 -36
  139. package/test/unit/init.test.ts +38 -0
  140. package/test/unit/interface.test.js +56 -53
  141. package/test/unit/interface.test.ts +54 -0
  142. package/test/unit/internal-hex.test.js +50 -47
  143. package/test/unit/internal-hex.test.ts +49 -0
  144. package/test/unit/populate-transaction.test.js +65 -62
  145. package/test/unit/populate-transaction.test.ts +64 -0
  146. package/test/unit/providers.test.js +200 -144
  147. package/test/unit/providers.test.ts +196 -0
  148. package/test/unit/result.test.js +80 -77
  149. package/test/unit/result.test.ts +79 -0
  150. package/test/unit/solidity-types.test.js +49 -46
  151. package/test/unit/solidity-types.test.ts +39 -0
  152. package/test/unit/utils.test.js +57 -54
  153. package/test/unit/utils.test.ts +56 -0
  154. package/test/verbose-logger.js +74 -0
  155. package/tsconfig.build.json +14 -0
@@ -1,10 +1,10 @@
1
- declare const _exports: {
2
- SigningKey: typeof import("./wallet").SigningKey;
3
- AbstractSigner: typeof import("./wallet").AbstractSigner;
4
- BaseWallet: typeof import("./wallet").BaseWallet;
5
- Wallet: typeof import("./wallet").Wallet;
6
- NonceManager: typeof import("./wallet").NonceManager;
7
- JsonRpcSigner: typeof import("./wallet").JsonRpcSigner;
8
- VoidSigner: typeof import("./wallet").VoidSigner;
9
- };
10
- export = _exports;
1
+ declare const _exports: {
2
+ SigningKey: typeof import("./wallet").SigningKey;
3
+ AbstractSigner: typeof import("./wallet").AbstractSigner;
4
+ BaseWallet: typeof import("./wallet").BaseWallet;
5
+ Wallet: typeof import("./wallet").Wallet;
6
+ NonceManager: typeof import("./wallet").NonceManager;
7
+ JsonRpcSigner: typeof import("./wallet").JsonRpcSigner;
8
+ VoidSigner: typeof import("./wallet").VoidSigner;
9
+ };
10
+ export = _exports;
@@ -1,8 +1,8 @@
1
- /**
2
- * @fileoverview Wallet exports.
3
- */
4
-
5
- module.exports = {
6
- ...require("./wallet"),
7
- };
8
-
1
+ /**
2
+ * @fileoverview Wallet exports.
3
+ */
4
+
5
+ module.exports = {
6
+ ...require("./wallet"),
7
+ };
8
+
@@ -1,160 +1,168 @@
1
- /**
2
- * SigningKey wrapper (PQC private/public key bytes).
3
- */
4
- export class SigningKey {
5
- /**
6
- * @param {Uint8Array} privateKeyBytes
7
- * @param {Uint8Array} publicKeyBytes
8
- */
9
- constructor(privateKeyBytes: Uint8Array, publicKeyBytes: Uint8Array);
10
- privateKeyBytes: Uint8Array<ArrayBuffer>;
11
- publicKeyBytes: Uint8Array<ArrayBuffer>;
12
- }
13
- /**
14
- * AbstractSigner base (minimal).
15
- */
16
- export class AbstractSigner {
17
- /**
18
- * @param {import("../providers/provider").AbstractProvider|null} provider
19
- */
20
- constructor(provider: import("../providers/provider").AbstractProvider | null);
21
- provider: import("../providers/provider").AbstractProvider;
22
- getAddress(): Promise<void>;
23
- }
24
- /**
25
- * BaseWallet - core signing implementation.
26
- */
27
- export class BaseWallet extends AbstractSigner {
28
- /**
29
- * @param {SigningKey} signingKey
30
- * @param {import("../providers/provider").AbstractProvider|null=} provider
31
- * @param {{ address: string }=} precomputed
32
- * @param {any=} qcWallet Internal quantum-coin-js-sdk Wallet (optional)
33
- */
34
- constructor(signingKey: SigningKey, provider?: (import("../providers/provider").AbstractProvider | null) | undefined, precomputed?: {
35
- address: string;
36
- } | undefined, qcWallet?: any | undefined);
37
- signingKey: SigningKey;
38
- _qcWallet: any;
39
- /** @type {string} */
40
- address: string;
41
- getAddress(): Promise<string>;
42
- /**
43
- * Sign a message synchronously.
44
- * Signature format: combined publicKey+signature as a hex string.
45
- * @param {string|Uint8Array} message
46
- * @returns {string}
47
- */
48
- signMessageSync(message: string | Uint8Array): string;
49
- /**
50
- * Sign a transaction using quantum-coin-js-sdk signRawTransaction().
51
- * @param {import("../providers/provider").TransactionRequest} tx
52
- * @returns {Promise<string>}
53
- */
54
- signTransaction(tx: import("../providers/provider").TransactionRequest): Promise<string>;
55
- /**
56
- * Signs and sends a transaction.
57
- * @param {import("../providers/provider").TransactionRequest} tx
58
- * @returns {Promise<import("../providers/provider").TransactionResponse>}
59
- */
60
- sendTransaction(tx: import("../providers/provider").TransactionRequest): Promise<import("../providers/provider").TransactionResponse>;
61
- }
62
- /**
63
- * Wallet - convenience methods around BaseWallet.
64
- */
65
- export class Wallet extends BaseWallet {
66
- /**
67
- * Creates a new random wallet.
68
- * @param {import("../providers/provider").AbstractProvider=} provider
69
- * @returns {Wallet}
70
- */
71
- static createRandom(provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
72
- /**
73
- * Creates a wallet from an encrypted JSON string.
74
- * @param {string} json
75
- * @param {string} password
76
- * @param {import("../providers/provider").AbstractProvider=} provider
77
- * @returns {Wallet}
78
- */
79
- static fromEncryptedJsonSync(json: string, password: string, provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
80
- /**
81
- * Creates a wallet from a seed phrase (48 words).
82
- * @param {string|string[]} phrase
83
- * @param {import("../providers/provider").AbstractProvider=} provider
84
- * @returns {Wallet}
85
- */
86
- static fromPhrase(phrase: string | string[], provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
87
- /**
88
- * Internal helper: build a Wallet from a quantum-coin-js-sdk Wallet object.
89
- * @param {any} qcWallet
90
- * @param {import("../providers/provider").AbstractProvider|null} provider
91
- * @returns {Wallet}
92
- */
93
- static _fromQcWallet(qcWallet: any, provider: import("../providers/provider").AbstractProvider | null): Wallet;
94
- /**
95
- * @param {string|Uint8Array|SigningKey} key
96
- * @param {import("../providers/provider").AbstractProvider=} provider
97
- */
98
- constructor(key: string | Uint8Array | SigningKey, provider?: import("../providers/provider").AbstractProvider | undefined);
99
- /**
100
- * Returns wallet address (sync).
101
- * @returns {string}
102
- */
103
- getAddress(): string;
104
- /**
105
- * Returns wallet balance.
106
- * @param {string=} blockTag
107
- * @returns {Promise<bigint>}
108
- */
109
- getBalance(blockTag?: string | undefined): Promise<bigint>;
110
- /**
111
- * Returns wallet nonce.
112
- * @param {string=} blockTag
113
- * @returns {Promise<number>}
114
- */
115
- getTransactionCount(blockTag?: string | undefined): Promise<number>;
116
- /**
117
- * Encrypts and serializes this wallet to JSON.
118
- * @param {string|Uint8Array} password
119
- * @returns {string}
120
- */
121
- encryptSync(password: string | Uint8Array): string;
122
- /**
123
- * Returns a new wallet connected to a provider.
124
- * @param {import("../providers/provider").AbstractProvider} provider
125
- * @returns {Wallet}
126
- */
127
- connect(provider: import("../providers/provider").AbstractProvider): Wallet;
128
- }
129
- /**
130
- * NonceManager wrapper.
131
- */
132
- export class NonceManager extends AbstractSigner {
133
- /**
134
- * @param {AbstractSigner} signer
135
- */
136
- constructor(signer: AbstractSigner);
137
- signer: AbstractSigner;
138
- _nonce: any;
139
- getTransactionCount(blockTag: any): any;
140
- sendTransaction(tx: any): Promise<any>;
141
- reset(): void;
142
- increment(): void;
143
- }
144
- /**
145
- * JsonRpcSigner placeholder (ethers-like).
146
- * This SDK encourages using Wallet directly for signing.
147
- */
148
- export class JsonRpcSigner extends AbstractSigner {
149
- constructor(provider: any, address: any);
150
- _address: any;
151
- getAddress(): Promise<any>;
152
- }
153
- /**
154
- * VoidSigner (cannot sign, only provides address).
155
- */
156
- export class VoidSigner extends AbstractSigner {
157
- constructor(address: any, provider: any);
158
- _address: string;
159
- getAddress(): Promise<string>;
160
- }
1
+ /**
2
+ * SigningKey wrapper (PQC private/public key bytes).
3
+ */
4
+ export class SigningKey {
5
+ /**
6
+ * @param {Uint8Array} privateKeyBytes
7
+ * @param {Uint8Array} publicKeyBytes
8
+ */
9
+ constructor(privateKeyBytes: Uint8Array, publicKeyBytes: Uint8Array);
10
+ privateKeyBytes: Uint8Array<ArrayBuffer>;
11
+ publicKeyBytes: Uint8Array<ArrayBuffer>;
12
+ }
13
+ /**
14
+ * AbstractSigner base (minimal).
15
+ */
16
+ export class AbstractSigner {
17
+ /**
18
+ * @param {import("../providers/provider").AbstractProvider|null} provider
19
+ */
20
+ constructor(provider: import("../providers/provider").AbstractProvider | null);
21
+ provider: import("../providers/provider").AbstractProvider;
22
+ getAddress(): Promise<void>;
23
+ }
24
+ /**
25
+ * BaseWallet - core signing implementation.
26
+ */
27
+ export class BaseWallet extends AbstractSigner {
28
+ /**
29
+ * @param {SigningKey} signingKey
30
+ * @param {import("../providers/provider").AbstractProvider|null=} provider
31
+ * @param {{ address: string }=} precomputed
32
+ * @param {any=} qcWallet Internal quantum-coin-js-sdk Wallet (optional)
33
+ */
34
+ constructor(signingKey: SigningKey, provider?: (import("../providers/provider").AbstractProvider | null) | undefined, precomputed?: {
35
+ address: string;
36
+ } | undefined, qcWallet?: any | undefined);
37
+ signingKey: SigningKey;
38
+ _qcWallet: any;
39
+ /** @type {string} */
40
+ address: string;
41
+ getAddress(): Promise<string>;
42
+ /**
43
+ * Sign a message synchronously.
44
+ * Signature format: combined publicKey+signature as a hex string.
45
+ * @param {string|Uint8Array} message
46
+ * @returns {string}
47
+ */
48
+ signMessageSync(message: string | Uint8Array): string;
49
+ /**
50
+ * Sign a transaction using quantum-coin-js-sdk signRawTransaction().
51
+ * @param {import("../providers/provider").TransactionRequest} tx
52
+ * @returns {Promise<string>}
53
+ */
54
+ signTransaction(tx: import("../providers/provider").TransactionRequest): Promise<string>;
55
+ /**
56
+ * Signs and sends a transaction.
57
+ * @param {import("../providers/provider").TransactionRequest} tx
58
+ * @returns {Promise<import("../providers/provider").TransactionResponse>}
59
+ */
60
+ sendTransaction(tx: import("../providers/provider").TransactionRequest): Promise<import("../providers/provider").TransactionResponse>;
61
+ }
62
+ /**
63
+ * Wallet - convenience methods around BaseWallet.
64
+ */
65
+ export class Wallet extends BaseWallet {
66
+ /**
67
+ * Creates a new random wallet.
68
+ * @param {import("../providers/provider").AbstractProvider=} provider
69
+ * @returns {Wallet}
70
+ */
71
+ static createRandom(provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
72
+ /**
73
+ * Creates a wallet from an encrypted JSON string.
74
+ * @param {string} json
75
+ * @param {string} password
76
+ * @param {import("../providers/provider").AbstractProvider=} provider
77
+ * @returns {Wallet}
78
+ */
79
+ static fromEncryptedJsonSync(json: string, password: string, provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
80
+ /**
81
+ * Creates a wallet from a seed phrase (32, 36, or 48 words).
82
+ * @param {string|string[]} phrase
83
+ * @param {import("../providers/provider").AbstractProvider=} provider
84
+ * @returns {Wallet}
85
+ */
86
+ static fromPhrase(phrase: string | string[], provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
87
+ /**
88
+ * Creates a wallet from raw private and public key bytes.
89
+ * @param {Uint8Array|string} privateKey Private key bytes or hex string
90
+ * @param {Uint8Array|string} publicKey Public key bytes or hex string
91
+ * @param {import("../providers/provider").AbstractProvider=} provider
92
+ * @returns {Wallet}
93
+ */
94
+ static fromKeys(privateKey: Uint8Array | string, publicKey: Uint8Array | string, provider?: import("../providers/provider").AbstractProvider | undefined): Wallet;
95
+ /**
96
+ * Internal helper: build a Wallet from a quantum-coin-js-sdk Wallet object.
97
+ * @param {any} qcWallet
98
+ * @param {import("../providers/provider").AbstractProvider|null} provider
99
+ * @returns {Wallet}
100
+ */
101
+ static _fromQcWallet(qcWallet: any, provider: import("../providers/provider").AbstractProvider | null): Wallet;
102
+ /**
103
+ * @param {string|Uint8Array|SigningKey} key
104
+ * @param {import("../providers/provider").AbstractProvider=} provider
105
+ */
106
+ constructor(key: string | Uint8Array | SigningKey, provider?: import("../providers/provider").AbstractProvider | undefined);
107
+ /**
108
+ * Returns wallet address (sync).
109
+ * @returns {string}
110
+ */
111
+ getAddress(): string;
112
+ /**
113
+ * Returns wallet balance.
114
+ * @param {string=} blockTag
115
+ * @returns {Promise<bigint>}
116
+ */
117
+ getBalance(blockTag?: string | undefined): Promise<bigint>;
118
+ /**
119
+ * Returns wallet nonce.
120
+ * @param {string=} blockTag
121
+ * @returns {Promise<number>}
122
+ */
123
+ getTransactionCount(blockTag?: string | undefined): Promise<number>;
124
+ /**
125
+ * Encrypts and serializes this wallet to JSON.
126
+ * @param {string|Uint8Array} password
127
+ * @returns {string}
128
+ */
129
+ encryptSync(password: string | Uint8Array): string;
130
+ /**
131
+ * Returns a new wallet connected to a provider.
132
+ * @param {import("../providers/provider").AbstractProvider} provider
133
+ * @returns {Wallet}
134
+ */
135
+ connect(provider: import("../providers/provider").AbstractProvider): Wallet;
136
+ }
137
+ /**
138
+ * NonceManager wrapper.
139
+ */
140
+ export class NonceManager extends AbstractSigner {
141
+ /**
142
+ * @param {AbstractSigner} signer
143
+ */
144
+ constructor(signer: AbstractSigner);
145
+ signer: AbstractSigner;
146
+ _nonce: any;
147
+ getTransactionCount(blockTag: any): any;
148
+ sendTransaction(tx: any): Promise<any>;
149
+ reset(): void;
150
+ increment(): void;
151
+ }
152
+ /**
153
+ * JsonRpcSigner placeholder (ethers-like).
154
+ * This SDK encourages using Wallet directly for signing.
155
+ */
156
+ export class JsonRpcSigner extends AbstractSigner {
157
+ constructor(provider: any, address: any);
158
+ _address: any;
159
+ getAddress(): Promise<any>;
160
+ }
161
+ /**
162
+ * VoidSigner (cannot sign, only provides address).
163
+ */
164
+ export class VoidSigner extends AbstractSigner {
165
+ constructor(address: any, provider: any);
166
+ _address: string;
167
+ getAddress(): Promise<string>;
168
+ }