@atomiqlabs/chain-starknet 3.0.0-dev.8 → 4.0.0-dev.3

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 (146) hide show
  1. package/LICENSE +201 -201
  2. package/dist/index.d.ts +38 -38
  3. package/dist/index.js +54 -54
  4. package/dist/starknet/StarknetChainType.d.ts +13 -13
  5. package/dist/starknet/StarknetChainType.js +2 -2
  6. package/dist/starknet/StarknetInitializer.d.ts +27 -19
  7. package/dist/starknet/StarknetInitializer.js +69 -69
  8. package/dist/starknet/btcrelay/BtcRelayAbi.d.ts +250 -250
  9. package/dist/starknet/btcrelay/BtcRelayAbi.js +341 -341
  10. package/dist/starknet/btcrelay/StarknetBtcRelay.d.ts +186 -186
  11. package/dist/starknet/btcrelay/StarknetBtcRelay.js +379 -379
  12. package/dist/starknet/btcrelay/headers/StarknetBtcHeader.d.ts +31 -31
  13. package/dist/starknet/btcrelay/headers/StarknetBtcHeader.js +74 -74
  14. package/dist/starknet/btcrelay/headers/StarknetBtcStoredHeader.d.ts +51 -51
  15. package/dist/starknet/btcrelay/headers/StarknetBtcStoredHeader.js +113 -113
  16. package/dist/starknet/chain/StarknetAction.d.ts +19 -19
  17. package/dist/starknet/chain/StarknetAction.js +73 -73
  18. package/dist/starknet/chain/StarknetChainInterface.d.ts +52 -52
  19. package/dist/starknet/chain/StarknetChainInterface.js +91 -91
  20. package/dist/starknet/chain/StarknetModule.d.ts +14 -14
  21. package/dist/starknet/chain/StarknetModule.js +13 -13
  22. package/dist/starknet/chain/modules/ERC20Abi.d.ts +755 -755
  23. package/dist/starknet/chain/modules/ERC20Abi.js +1032 -1032
  24. package/dist/starknet/chain/modules/StarknetAccounts.d.ts +6 -6
  25. package/dist/starknet/chain/modules/StarknetAccounts.js +24 -24
  26. package/dist/starknet/chain/modules/StarknetAddresses.d.ts +9 -9
  27. package/dist/starknet/chain/modules/StarknetAddresses.js +26 -26
  28. package/dist/starknet/chain/modules/StarknetBlocks.d.ts +20 -19
  29. package/dist/starknet/chain/modules/StarknetBlocks.js +64 -49
  30. package/dist/starknet/chain/modules/StarknetEvents.d.ts +44 -44
  31. package/dist/starknet/chain/modules/StarknetEvents.js +88 -88
  32. package/dist/starknet/chain/modules/StarknetFees.d.ts +77 -77
  33. package/dist/starknet/chain/modules/StarknetFees.js +114 -114
  34. package/dist/starknet/chain/modules/StarknetSignatures.d.ts +29 -29
  35. package/dist/starknet/chain/modules/StarknetSignatures.js +72 -72
  36. package/dist/starknet/chain/modules/StarknetTokens.d.ts +69 -69
  37. package/dist/starknet/chain/modules/StarknetTokens.js +98 -98
  38. package/dist/starknet/chain/modules/StarknetTransactions.d.ts +93 -93
  39. package/dist/starknet/chain/modules/StarknetTransactions.js +255 -255
  40. package/dist/starknet/contract/StarknetContractBase.d.ts +13 -13
  41. package/dist/starknet/contract/StarknetContractBase.js +16 -16
  42. package/dist/starknet/contract/StarknetContractModule.d.ts +8 -8
  43. package/dist/starknet/contract/StarknetContractModule.js +11 -11
  44. package/dist/starknet/contract/modules/StarknetContractEvents.d.ts +51 -51
  45. package/dist/starknet/contract/modules/StarknetContractEvents.js +97 -97
  46. package/dist/starknet/events/StarknetChainEvents.d.ts +21 -21
  47. package/dist/starknet/events/StarknetChainEvents.js +52 -52
  48. package/dist/starknet/events/StarknetChainEventsBrowser.d.ts +90 -91
  49. package/dist/starknet/events/StarknetChainEventsBrowser.js +292 -294
  50. package/dist/starknet/provider/RpcProviderWithRetries.d.ts +21 -21
  51. package/dist/starknet/provider/RpcProviderWithRetries.js +32 -32
  52. package/dist/starknet/spv_swap/SpvVaultContractAbi.d.ts +488 -488
  53. package/dist/starknet/spv_swap/SpvVaultContractAbi.js +656 -656
  54. package/dist/starknet/spv_swap/StarknetSpvVaultContract.d.ts +66 -65
  55. package/dist/starknet/spv_swap/StarknetSpvVaultContract.js +382 -376
  56. package/dist/starknet/spv_swap/StarknetSpvVaultData.d.ts +49 -49
  57. package/dist/starknet/spv_swap/StarknetSpvVaultData.js +145 -144
  58. package/dist/starknet/spv_swap/StarknetSpvWithdrawalData.d.ts +25 -24
  59. package/dist/starknet/spv_swap/StarknetSpvWithdrawalData.js +72 -61
  60. package/dist/starknet/swaps/EscrowManagerAbi.d.ts +434 -434
  61. package/dist/starknet/swaps/EscrowManagerAbi.js +587 -587
  62. package/dist/starknet/swaps/StarknetSwapContract.d.ts +190 -196
  63. package/dist/starknet/swaps/StarknetSwapContract.js +409 -395
  64. package/dist/starknet/swaps/StarknetSwapData.d.ts +67 -67
  65. package/dist/starknet/swaps/StarknetSwapData.js +290 -290
  66. package/dist/starknet/swaps/StarknetSwapModule.d.ts +10 -10
  67. package/dist/starknet/swaps/StarknetSwapModule.js +11 -11
  68. package/dist/starknet/swaps/handlers/IHandler.d.ts +13 -13
  69. package/dist/starknet/swaps/handlers/IHandler.js +2 -2
  70. package/dist/starknet/swaps/handlers/claim/ClaimHandlers.d.ts +13 -13
  71. package/dist/starknet/swaps/handlers/claim/ClaimHandlers.js +13 -13
  72. package/dist/starknet/swaps/handlers/claim/HashlockClaimHandler.d.ts +21 -21
  73. package/dist/starknet/swaps/handlers/claim/HashlockClaimHandler.js +44 -44
  74. package/dist/starknet/swaps/handlers/claim/btc/BitcoinNoncedOutputClaimHandler.d.ts +24 -24
  75. package/dist/starknet/swaps/handlers/claim/btc/BitcoinNoncedOutputClaimHandler.js +48 -48
  76. package/dist/starknet/swaps/handlers/claim/btc/BitcoinOutputClaimHandler.d.ts +25 -25
  77. package/dist/starknet/swaps/handlers/claim/btc/BitcoinOutputClaimHandler.js +40 -40
  78. package/dist/starknet/swaps/handlers/claim/btc/BitcoinTxIdClaimHandler.d.ts +20 -20
  79. package/dist/starknet/swaps/handlers/claim/btc/BitcoinTxIdClaimHandler.js +30 -30
  80. package/dist/starknet/swaps/handlers/claim/btc/IBitcoinClaimHandler.d.ts +45 -45
  81. package/dist/starknet/swaps/handlers/claim/btc/IBitcoinClaimHandler.js +52 -52
  82. package/dist/starknet/swaps/handlers/refund/TimelockRefundHandler.d.ts +17 -17
  83. package/dist/starknet/swaps/handlers/refund/TimelockRefundHandler.js +27 -27
  84. package/dist/starknet/swaps/modules/StarknetLpVault.d.ts +69 -69
  85. package/dist/starknet/swaps/modules/StarknetLpVault.js +122 -122
  86. package/dist/starknet/swaps/modules/StarknetSwapClaim.d.ts +53 -53
  87. package/dist/starknet/swaps/modules/StarknetSwapClaim.js +100 -100
  88. package/dist/starknet/swaps/modules/StarknetSwapInit.d.ts +86 -84
  89. package/dist/starknet/swaps/modules/StarknetSwapInit.js +224 -200
  90. package/dist/starknet/swaps/modules/StarknetSwapRefund.d.ts +62 -62
  91. package/dist/starknet/swaps/modules/StarknetSwapRefund.js +128 -128
  92. package/dist/starknet/wallet/StarknetKeypairWallet.d.ts +7 -7
  93. package/dist/starknet/wallet/StarknetKeypairWallet.js +30 -30
  94. package/dist/starknet/wallet/StarknetSigner.d.ts +12 -12
  95. package/dist/starknet/wallet/StarknetSigner.js +46 -46
  96. package/dist/utils/Utils.d.ts +37 -37
  97. package/dist/utils/Utils.js +261 -257
  98. package/package.json +37 -37
  99. package/src/index.ts +47 -47
  100. package/src/starknet/StarknetChainType.ts +28 -28
  101. package/src/starknet/StarknetInitializer.ts +108 -100
  102. package/src/starknet/btcrelay/BtcRelayAbi.ts +338 -338
  103. package/src/starknet/btcrelay/StarknetBtcRelay.ts +494 -494
  104. package/src/starknet/btcrelay/headers/StarknetBtcHeader.ts +100 -100
  105. package/src/starknet/btcrelay/headers/StarknetBtcStoredHeader.ts +141 -141
  106. package/src/starknet/chain/StarknetAction.ts +85 -85
  107. package/src/starknet/chain/StarknetChainInterface.ts +149 -149
  108. package/src/starknet/chain/StarknetModule.ts +19 -19
  109. package/src/starknet/chain/modules/ERC20Abi.ts +1029 -1029
  110. package/src/starknet/chain/modules/StarknetAccounts.ts +25 -25
  111. package/src/starknet/chain/modules/StarknetAddresses.ts +22 -22
  112. package/src/starknet/chain/modules/StarknetBlocks.ts +74 -58
  113. package/src/starknet/chain/modules/StarknetEvents.ts +104 -104
  114. package/src/starknet/chain/modules/StarknetFees.ts +154 -154
  115. package/src/starknet/chain/modules/StarknetSignatures.ts +91 -91
  116. package/src/starknet/chain/modules/StarknetTokens.ts +116 -116
  117. package/src/starknet/chain/modules/StarknetTransactions.ts +277 -277
  118. package/src/starknet/contract/StarknetContractBase.ts +26 -26
  119. package/src/starknet/contract/StarknetContractModule.ts +16 -16
  120. package/src/starknet/contract/modules/StarknetContractEvents.ts +134 -134
  121. package/src/starknet/events/StarknetChainEvents.ts +67 -67
  122. package/src/starknet/events/StarknetChainEventsBrowser.ts +410 -412
  123. package/src/starknet/provider/RpcProviderWithRetries.ts +43 -43
  124. package/src/starknet/spv_swap/SpvVaultContractAbi.ts +656 -656
  125. package/src/starknet/spv_swap/StarknetSpvVaultContract.ts +483 -477
  126. package/src/starknet/spv_swap/StarknetSpvVaultData.ts +195 -194
  127. package/src/starknet/spv_swap/StarknetSpvWithdrawalData.ts +79 -68
  128. package/src/starknet/swaps/EscrowManagerAbi.ts +586 -586
  129. package/src/starknet/swaps/StarknetSwapContract.ts +628 -605
  130. package/src/starknet/swaps/StarknetSwapData.ts +403 -403
  131. package/src/starknet/swaps/StarknetSwapModule.ts +17 -17
  132. package/src/starknet/swaps/handlers/IHandler.ts +20 -20
  133. package/src/starknet/swaps/handlers/claim/ClaimHandlers.ts +23 -23
  134. package/src/starknet/swaps/handlers/claim/HashlockClaimHandler.ts +53 -53
  135. package/src/starknet/swaps/handlers/claim/btc/BitcoinNoncedOutputClaimHandler.ts +73 -73
  136. package/src/starknet/swaps/handlers/claim/btc/BitcoinOutputClaimHandler.ts +67 -67
  137. package/src/starknet/swaps/handlers/claim/btc/BitcoinTxIdClaimHandler.ts +50 -50
  138. package/src/starknet/swaps/handlers/claim/btc/IBitcoinClaimHandler.ts +102 -102
  139. package/src/starknet/swaps/handlers/refund/TimelockRefundHandler.ts +38 -38
  140. package/src/starknet/swaps/modules/StarknetLpVault.ts +147 -147
  141. package/src/starknet/swaps/modules/StarknetSwapClaim.ts +141 -141
  142. package/src/starknet/swaps/modules/StarknetSwapInit.ts +286 -260
  143. package/src/starknet/swaps/modules/StarknetSwapRefund.ts +196 -196
  144. package/src/starknet/wallet/StarknetKeypairWallet.ts +39 -39
  145. package/src/starknet/wallet/StarknetSigner.ts +55 -55
  146. package/src/utils/Utils.ts +252 -248
@@ -1,248 +1,252 @@
1
- import {EDAMode} from "@starknet-io/starknet-types-08";
2
- import {BigNumberish, CallData, hash, Uint256} from "starknet";
3
- import {StarknetTx} from "../starknet/chain/modules/StarknetTransactions";
4
- import {Buffer} from "buffer";
5
- import {StarknetSwapData} from "../starknet/swaps/StarknetSwapData";
6
- import {IClaimHandler} from "../starknet/swaps/handlers/claim/ClaimHandlers";
7
-
8
- export function isUint256(val: any): val is Uint256 {
9
- return val.low!=null && val.high!=null;
10
- }
11
-
12
- export function timeoutPromise(timeoutMillis: number, abortSignal?: AbortSignal): Promise<void> {
13
- return new Promise((resolve, reject) => {
14
- const timeout = setTimeout(resolve, timeoutMillis)
15
- if(abortSignal!=null) abortSignal.addEventListener("abort", () => {
16
- clearTimeout(timeout);
17
- reject(new Error("Aborted"));
18
- })
19
- });
20
- }
21
-
22
- export function onceAsync<T>(executor: () => Promise<T>): () => Promise<T> {
23
- let promise: Promise<T>;
24
-
25
- return () => {
26
- if(promise==null) {
27
- promise = executor();
28
- return promise;
29
- } else {
30
- return promise.catch(() => promise = executor());
31
- }
32
- }
33
- }
34
-
35
- export function getLogger(prefix: string) {
36
- return {
37
- debug: (msg, ...args) => console.debug(prefix+msg, ...args),
38
- info: (msg, ...args) => console.info(prefix+msg, ...args),
39
- warn: (msg, ...args) => console.warn(prefix+msg, ...args),
40
- error: (msg, ...args) => console.error(prefix+msg, ...args)
41
- };
42
- }
43
-
44
- const logger = getLogger("Utils: ");
45
-
46
- export async function tryWithRetries<T>(func: () => Promise<T>, retryPolicy?: {
47
- maxRetries?: number, delay?: number, exponential?: boolean
48
- }, errorAllowed?: (e: any) => boolean, abortSignal?: AbortSignal): Promise<T> {
49
- retryPolicy = retryPolicy || {};
50
- retryPolicy.maxRetries = retryPolicy.maxRetries || 5;
51
- retryPolicy.delay = retryPolicy.delay || 500;
52
- retryPolicy.exponential = retryPolicy.exponential==null ? true : retryPolicy.exponential;
53
-
54
- let err = null;
55
-
56
- for(let i=0;i<retryPolicy.maxRetries;i++) {
57
- try {
58
- const resp: T = await func();
59
- return resp;
60
- } catch (e) {
61
- if(errorAllowed!=null && errorAllowed(e)) throw e;
62
- err = e;
63
- logger.error("tryWithRetries(): error on try number: "+i, e);
64
- }
65
- if(abortSignal!=null && abortSignal.aborted) throw new Error("Aborted");
66
- if(i!==retryPolicy.maxRetries-1) {
67
- await timeoutPromise(
68
- retryPolicy.exponential ? retryPolicy.delay*Math.pow(2, i) : retryPolicy.delay,
69
- abortSignal
70
- );
71
- }
72
- }
73
-
74
- throw err;
75
- }
76
-
77
- export function toHex(value: number | bigint | string | Buffer, length: number = 64): string {
78
- if(value==null) return null;
79
- switch(typeof(value)) {
80
- case "string":
81
- if(value.startsWith("0x")) {
82
- return "0x"+value.slice(2).padStart(length, "0");
83
- } else {
84
- return "0x"+BigInt(value).toString(16).padStart(length, "0");
85
- }
86
- case "number":
87
- case "bigint":
88
- return "0x"+value.toString(16).padStart(length, "0");
89
- }
90
- return "0x"+value.toString("hex").padStart(length, "0");
91
- }
92
-
93
- export function calculateHash(tx: StarknetTx): string {
94
- const commonData = {
95
- version: tx.details.version,
96
- maxFee: tx.details.maxFee,
97
- chainId: tx.details.chainId,
98
- nonce: tx.details.nonce,
99
- accountDeploymentData: tx.details.version==="0x3" ? tx.details.accountDeploymentData : null,
100
- nonceDataAvailabilityMode: tx.details.version==="0x3" ? EDAMode[tx.details.nonceDataAvailabilityMode] : null,
101
- feeDataAvailabilityMode: tx.details.version==="0x3" ? EDAMode[tx.details.feeDataAvailabilityMode] : null,
102
- resourceBounds: tx.details.version==="0x3" ? tx.details.resourceBounds : null,
103
- tip: tx.details.version==="0x3" ? tx.details.tip : null,
104
- paymasterData: tx.details.version==="0x3" ? tx.details.paymasterData : null
105
- };
106
- switch(tx.type) {
107
- case "INVOKE":
108
- const invokeData = CallData.compile(tx.signed.calldata);
109
- return tx.txId = hash.calculateInvokeTransactionHash({
110
- senderAddress: tx.details.walletAddress,
111
- compiledCalldata: invokeData,
112
- ...commonData
113
- });
114
- case "DEPLOY_ACCOUNT":
115
- const deployAccountData = CallData.compile(tx.signed.constructorCalldata);
116
- return tx.txId = hash.calculateDeployAccountTransactionHash({
117
- contractAddress: tx.tx.contractAddress,
118
- classHash: tx.signed.classHash,
119
- constructorCalldata: deployAccountData,
120
- compiledConstructorCalldata: deployAccountData,
121
- salt: tx.signed.addressSalt,
122
- ...commonData
123
- });
124
- default:
125
- throw new Error("Unsupported tx type!");
126
- }
127
- }
128
-
129
- export function u32ArrayToBuffer(arr: BigNumberish[]): Buffer {
130
- const buffer = Buffer.alloc(4*arr.length);
131
- for(let i=0;i<arr.length;i++) {
132
- buffer.writeUInt32BE(Number(arr[i]), i*4);
133
- }
134
- return buffer;
135
- }
136
-
137
- export function bufferToU32Array(buffer: Buffer): number[] {
138
- const result: number[] = [];
139
- for(let i=0;i<buffer.length;i+=4) {
140
- result.push(buffer.readUInt32BE(i));
141
- }
142
- return result;
143
- }
144
-
145
- export function u32ReverseEndianness(value: number): number {
146
- const valueBN = BigInt(value);
147
- return Number(((valueBN & 0xFFn) << 24n) |
148
- ((valueBN & 0xFF00n) << 8n) |
149
- ((valueBN >> 8n) & 0xFF00n) |
150
- ((valueBN >> 24n) & 0xFFn));
151
- }
152
-
153
- export function bigNumberishToBuffer(value: BigNumberish | Uint256, length?: number): Buffer {
154
- if(isUint256(value)) {
155
- return Buffer.concat([bigNumberishToBuffer(value.high, 16), bigNumberishToBuffer(value.low, 16)])
156
- }
157
- if(typeof(value)==="string") {
158
- if(value.startsWith("0x")) {
159
- value = value.slice(2);
160
- } else {
161
- value = BigInt(value).toString(16);
162
- }
163
- } else {
164
- value = value.toString(16);
165
- }
166
- if(length!=null) value = value.padStart(length*2, "0");
167
- const buff = Buffer.from(value, "hex");
168
- if(buff.length > length) return buff.slice(buff.length-length);
169
- return buff;
170
- }
171
-
172
- export function toBigInt(value: BigNumberish | Uint256): bigint {
173
- if(value==null) return null;
174
- if(isUint256(value)) {
175
- return (toBigInt(value.high) << 128n) | toBigInt(value.low);
176
- }
177
- if(typeof(value)==="string") {
178
- if(!value.startsWith("0x")) value = "0x"+value;
179
- return BigInt(value);
180
- }
181
- if(typeof(value)==="bigint") {
182
- return value;
183
- }
184
- return BigInt(value);
185
- }
186
-
187
- export function bytes31SpanToBuffer(span: BigNumberish[], length: number): Buffer {
188
- const buffers: Buffer[] = [];
189
- const numFullBytes31 = Math.floor(length/31);
190
- const additionalBytes = length - (numFullBytes31*31);
191
- const requiredSpanLength = numFullBytes31 + (additionalBytes===0 ? 0 : 1);
192
- if(span.length<requiredSpanLength) throw new Error("Not enough bytes in the felt array!");
193
- let i = 0;
194
- for(; i<numFullBytes31; i++) {
195
- buffers.push(bigNumberishToBuffer(span[i], 31));
196
- }
197
- if(additionalBytes!==0) buffers.push(bigNumberishToBuffer(span[i], additionalBytes));
198
- return Buffer.concat(buffers);
199
- }
200
-
201
- export function bufferToBytes31Span(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish[] {
202
- const values: BigNumberish[] = [];
203
- for(let i=startIndex+31;i<endIndex;i+=31) {
204
- values.push(BigInt("0x"+buffer.slice(i-31, i).toString("hex")));
205
- }
206
- if(endIndex > startIndex + (values.length*31)) values.push(BigInt("0x"+buffer.slice(startIndex + (values.length*31), endIndex).toString("hex")));
207
- return values;
208
- }
209
-
210
- export function bufferToByteArray(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish[] {
211
- const values: BigNumberish[] = [];
212
- for(let i=startIndex+31;i<endIndex;i+=31) {
213
- values.push(BigInt("0x"+buffer.slice(i-31, i).toString("hex")));
214
- }
215
- let pendingWord: BigNumberish = BigInt(0);
216
- let pendingWordLen: BigNumberish = BigInt(endIndex - (startIndex + (values.length*31)));
217
- if(pendingWordLen !== BigInt(0)) {
218
- pendingWord = BigInt("0x"+buffer.slice(startIndex + (values.length*31), endIndex).toString("hex"));
219
- }
220
- return [
221
- BigInt(values.length),
222
- ...values,
223
- pendingWord,
224
- pendingWordLen
225
- ];
226
- }
227
-
228
- export function poseidonHashRange(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish {
229
- return hash.computePoseidonHashOnElements(bufferToBytes31Span(buffer, startIndex, endIndex));
230
- }
231
-
232
- export function parseInitFunctionCalldata(calldata: BigNumberish[], claimHandler: IClaimHandler<any, any>): {escrow: StarknetSwapData, signature: BigNumberish[], timeout: bigint, extraData: BigNumberish[]} {
233
- const escrow = StarknetSwapData.fromSerializedFeltArray(calldata, claimHandler);
234
- const signatureLen = Number(toBigInt(calldata.shift()));
235
- const signature = calldata.splice(0, signatureLen);
236
- const timeout = toBigInt(calldata.shift());
237
- const extraDataLen = Number(toBigInt(calldata.shift()));
238
- const extraData = calldata.splice(0, extraDataLen);
239
- if(calldata.length!==0) throw new Error("Calldata not read fully!");
240
- return {escrow, signature, timeout, extraData};
241
- }
242
-
243
- export function findLastIndex<T>(array: T[], callback: (value: T, index: number) => boolean): number {
244
- for(let i=array.length-1;i>=0;i--){
245
- if(callback(array[i], i)) return i;
246
- }
247
- return -1;
248
- }
1
+ import {EDAMode} from "@starknet-io/starknet-types-08";
2
+ import {BigNumberish, CallData, hash, Uint256} from "starknet";
3
+ import {StarknetTx} from "../starknet/chain/modules/StarknetTransactions";
4
+ import {Buffer} from "buffer";
5
+ import {StarknetSwapData} from "../starknet/swaps/StarknetSwapData";
6
+ import {IClaimHandler} from "../starknet/swaps/handlers/claim/ClaimHandlers";
7
+
8
+ export function isUint256(val: any): val is Uint256 {
9
+ return val.low!=null && val.high!=null;
10
+ }
11
+
12
+ export function timeoutPromise(timeoutMillis: number, abortSignal?: AbortSignal): Promise<void> {
13
+ return new Promise((resolve, reject) => {
14
+ const timeout = setTimeout(resolve, timeoutMillis)
15
+ if(abortSignal!=null) abortSignal.addEventListener("abort", () => {
16
+ clearTimeout(timeout);
17
+ reject(new Error("Aborted"));
18
+ })
19
+ });
20
+ }
21
+
22
+ export function onceAsync<T>(executor: () => Promise<T>): () => Promise<T> {
23
+ let promise: Promise<T>;
24
+
25
+ return () => {
26
+ if(promise==null) {
27
+ promise = executor();
28
+ return promise;
29
+ } else {
30
+ return promise.catch(() => promise = executor());
31
+ }
32
+ }
33
+ }
34
+
35
+ export function getLogger(prefix: string) {
36
+ return {
37
+ // @ts-ignore
38
+ debug: (msg, ...args) => global.atomiqLogLevel >= 3 && console.debug(prefix+msg, ...args),
39
+ // @ts-ignore
40
+ info: (msg, ...args) => global.atomiqLogLevel >= 2 && console.info(prefix+msg, ...args),
41
+ // @ts-ignore
42
+ warn: (msg, ...args) => (global.atomiqLogLevel==null || global.atomiqLogLevel >= 1) && console.warn(prefix+msg, ...args),
43
+ // @ts-ignore
44
+ error: (msg, ...args) => (global.atomiqLogLevel==null || global.atomiqLogLevel >= 0) && console.error(prefix+msg, ...args)
45
+ };
46
+ }
47
+
48
+ const logger = getLogger("Utils: ");
49
+
50
+ export async function tryWithRetries<T>(func: () => Promise<T>, retryPolicy?: {
51
+ maxRetries?: number, delay?: number, exponential?: boolean
52
+ }, errorAllowed?: (e: any) => boolean, abortSignal?: AbortSignal): Promise<T> {
53
+ retryPolicy = retryPolicy || {};
54
+ retryPolicy.maxRetries = retryPolicy.maxRetries || 5;
55
+ retryPolicy.delay = retryPolicy.delay || 500;
56
+ retryPolicy.exponential = retryPolicy.exponential==null ? true : retryPolicy.exponential;
57
+
58
+ let err = null;
59
+
60
+ for(let i=0;i<retryPolicy.maxRetries;i++) {
61
+ try {
62
+ const resp: T = await func();
63
+ return resp;
64
+ } catch (e) {
65
+ if(errorAllowed!=null && errorAllowed(e)) throw e;
66
+ err = e;
67
+ logger.error("tryWithRetries(): error on try number: "+i, e);
68
+ }
69
+ if(abortSignal!=null && abortSignal.aborted) throw new Error("Aborted");
70
+ if(i!==retryPolicy.maxRetries-1) {
71
+ await timeoutPromise(
72
+ retryPolicy.exponential ? retryPolicy.delay*Math.pow(2, i) : retryPolicy.delay,
73
+ abortSignal
74
+ );
75
+ }
76
+ }
77
+
78
+ throw err;
79
+ }
80
+
81
+ export function toHex(value: number | bigint | string | Buffer, length: number = 64): string {
82
+ if(value==null) return null;
83
+ switch(typeof(value)) {
84
+ case "string":
85
+ if(value.startsWith("0x")) {
86
+ return "0x"+value.slice(2).padStart(length, "0");
87
+ } else {
88
+ return "0x"+BigInt(value).toString(16).padStart(length, "0");
89
+ }
90
+ case "number":
91
+ case "bigint":
92
+ return "0x"+value.toString(16).padStart(length, "0");
93
+ }
94
+ return "0x"+value.toString("hex").padStart(length, "0");
95
+ }
96
+
97
+ export function calculateHash(tx: StarknetTx): string {
98
+ const commonData = {
99
+ version: tx.details.version,
100
+ maxFee: tx.details.maxFee,
101
+ chainId: tx.details.chainId,
102
+ nonce: tx.details.nonce,
103
+ accountDeploymentData: tx.details.version==="0x3" ? tx.details.accountDeploymentData : null,
104
+ nonceDataAvailabilityMode: tx.details.version==="0x3" ? EDAMode[tx.details.nonceDataAvailabilityMode] : null,
105
+ feeDataAvailabilityMode: tx.details.version==="0x3" ? EDAMode[tx.details.feeDataAvailabilityMode] : null,
106
+ resourceBounds: tx.details.version==="0x3" ? tx.details.resourceBounds : null,
107
+ tip: tx.details.version==="0x3" ? tx.details.tip : null,
108
+ paymasterData: tx.details.version==="0x3" ? tx.details.paymasterData : null
109
+ };
110
+ switch(tx.type) {
111
+ case "INVOKE":
112
+ const invokeData = CallData.compile(tx.signed.calldata);
113
+ return tx.txId = hash.calculateInvokeTransactionHash({
114
+ senderAddress: tx.details.walletAddress,
115
+ compiledCalldata: invokeData,
116
+ ...commonData
117
+ });
118
+ case "DEPLOY_ACCOUNT":
119
+ const deployAccountData = CallData.compile(tx.signed.constructorCalldata);
120
+ return tx.txId = hash.calculateDeployAccountTransactionHash({
121
+ contractAddress: tx.tx.contractAddress,
122
+ classHash: tx.signed.classHash,
123
+ constructorCalldata: deployAccountData,
124
+ compiledConstructorCalldata: deployAccountData,
125
+ salt: tx.signed.addressSalt,
126
+ ...commonData
127
+ });
128
+ default:
129
+ throw new Error("Unsupported tx type!");
130
+ }
131
+ }
132
+
133
+ export function u32ArrayToBuffer(arr: BigNumberish[]): Buffer {
134
+ const buffer = Buffer.alloc(4*arr.length);
135
+ for(let i=0;i<arr.length;i++) {
136
+ buffer.writeUInt32BE(Number(arr[i]), i*4);
137
+ }
138
+ return buffer;
139
+ }
140
+
141
+ export function bufferToU32Array(buffer: Buffer): number[] {
142
+ const result: number[] = [];
143
+ for(let i=0;i<buffer.length;i+=4) {
144
+ result.push(buffer.readUInt32BE(i));
145
+ }
146
+ return result;
147
+ }
148
+
149
+ export function u32ReverseEndianness(value: number): number {
150
+ const valueBN = BigInt(value);
151
+ return Number(((valueBN & 0xFFn) << 24n) |
152
+ ((valueBN & 0xFF00n) << 8n) |
153
+ ((valueBN >> 8n) & 0xFF00n) |
154
+ ((valueBN >> 24n) & 0xFFn));
155
+ }
156
+
157
+ export function bigNumberishToBuffer(value: BigNumberish | Uint256, length?: number): Buffer {
158
+ if(isUint256(value)) {
159
+ return Buffer.concat([bigNumberishToBuffer(value.high, 16), bigNumberishToBuffer(value.low, 16)])
160
+ }
161
+ if(typeof(value)==="string") {
162
+ if(value.startsWith("0x")) {
163
+ value = value.slice(2);
164
+ } else {
165
+ value = BigInt(value).toString(16);
166
+ }
167
+ } else {
168
+ value = value.toString(16);
169
+ }
170
+ if(length!=null) value = value.padStart(length*2, "0");
171
+ const buff = Buffer.from(value, "hex");
172
+ if(buff.length > length) return buff.slice(buff.length-length);
173
+ return buff;
174
+ }
175
+
176
+ export function toBigInt(value: BigNumberish | Uint256): bigint {
177
+ if(value==null) return null;
178
+ if(isUint256(value)) {
179
+ return (toBigInt(value.high) << 128n) | toBigInt(value.low);
180
+ }
181
+ if(typeof(value)==="string") {
182
+ if(!value.startsWith("0x")) value = "0x"+value;
183
+ return BigInt(value);
184
+ }
185
+ if(typeof(value)==="bigint") {
186
+ return value;
187
+ }
188
+ return BigInt(value);
189
+ }
190
+
191
+ export function bytes31SpanToBuffer(span: BigNumberish[], length: number): Buffer {
192
+ const buffers: Buffer[] = [];
193
+ const numFullBytes31 = Math.floor(length/31);
194
+ const additionalBytes = length - (numFullBytes31*31);
195
+ const requiredSpanLength = numFullBytes31 + (additionalBytes===0 ? 0 : 1);
196
+ if(span.length<requiredSpanLength) throw new Error("Not enough bytes in the felt array!");
197
+ let i = 0;
198
+ for(; i<numFullBytes31; i++) {
199
+ buffers.push(bigNumberishToBuffer(span[i], 31));
200
+ }
201
+ if(additionalBytes!==0) buffers.push(bigNumberishToBuffer(span[i], additionalBytes));
202
+ return Buffer.concat(buffers);
203
+ }
204
+
205
+ export function bufferToBytes31Span(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish[] {
206
+ const values: BigNumberish[] = [];
207
+ for(let i=startIndex+31;i<endIndex;i+=31) {
208
+ values.push(BigInt("0x"+buffer.slice(i-31, i).toString("hex")));
209
+ }
210
+ if(endIndex > startIndex + (values.length*31)) values.push(BigInt("0x"+buffer.slice(startIndex + (values.length*31), endIndex).toString("hex")));
211
+ return values;
212
+ }
213
+
214
+ export function bufferToByteArray(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish[] {
215
+ const values: BigNumberish[] = [];
216
+ for(let i=startIndex+31;i<endIndex;i+=31) {
217
+ values.push(BigInt("0x"+buffer.slice(i-31, i).toString("hex")));
218
+ }
219
+ let pendingWord: BigNumberish = BigInt(0);
220
+ let pendingWordLen: BigNumberish = BigInt(endIndex - (startIndex + (values.length*31)));
221
+ if(pendingWordLen !== BigInt(0)) {
222
+ pendingWord = BigInt("0x"+buffer.slice(startIndex + (values.length*31), endIndex).toString("hex"));
223
+ }
224
+ return [
225
+ BigInt(values.length),
226
+ ...values,
227
+ pendingWord,
228
+ pendingWordLen
229
+ ];
230
+ }
231
+
232
+ export function poseidonHashRange(buffer: Buffer, startIndex: number = 0, endIndex: number = buffer.length): BigNumberish {
233
+ return hash.computePoseidonHashOnElements(bufferToBytes31Span(buffer, startIndex, endIndex));
234
+ }
235
+
236
+ export function parseInitFunctionCalldata(calldata: BigNumberish[], claimHandler: IClaimHandler<any, any>): {escrow: StarknetSwapData, signature: BigNumberish[], timeout: bigint, extraData: BigNumberish[]} {
237
+ const escrow = StarknetSwapData.fromSerializedFeltArray(calldata, claimHandler);
238
+ const signatureLen = Number(toBigInt(calldata.shift()));
239
+ const signature = calldata.splice(0, signatureLen);
240
+ const timeout = toBigInt(calldata.shift());
241
+ const extraDataLen = Number(toBigInt(calldata.shift()));
242
+ const extraData = calldata.splice(0, extraDataLen);
243
+ if(calldata.length!==0) throw new Error("Calldata not read fully!");
244
+ return {escrow, signature, timeout, extraData};
245
+ }
246
+
247
+ export function findLastIndex<T>(array: T[], callback: (value: T, index: number) => boolean): number {
248
+ for(let i=array.length-1;i>=0;i--){
249
+ if(callback(array[i], i)) return i;
250
+ }
251
+ return -1;
252
+ }