@thru/programs 0.3.3 → 0.3.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 (122) hide show
  1. package/README.md +123 -37
  2. package/dist/abi-manager/index.cjs +9568 -0
  3. package/dist/abi-manager/index.cjs.map +1 -0
  4. package/dist/abi-manager/index.d.cts +2169 -0
  5. package/dist/abi-manager/index.d.ts +2169 -0
  6. package/dist/abi-manager/index.js +4 -0
  7. package/dist/abi-manager/index.js.map +1 -0
  8. package/dist/amm/index.cjs +1 -3
  9. package/dist/amm/index.cjs.map +1 -1
  10. package/dist/amm/index.d.cts +1 -1
  11. package/dist/amm/index.d.ts +1 -1
  12. package/dist/amm/index.js +2 -2
  13. package/dist/amm/index.js.map +1 -1
  14. package/dist/chunk-6IC6CO5S.js +9443 -0
  15. package/dist/chunk-6IC6CO5S.js.map +1 -0
  16. package/dist/chunk-7DRJVAYI.js +8587 -0
  17. package/dist/chunk-7DRJVAYI.js.map +1 -0
  18. package/dist/chunk-7FBCBZIY.js +41 -0
  19. package/dist/chunk-7FBCBZIY.js.map +1 -0
  20. package/dist/chunk-BNYDH4ZP.js +4351 -0
  21. package/dist/chunk-BNYDH4ZP.js.map +1 -0
  22. package/dist/chunk-OODN6LJA.js +6567 -0
  23. package/dist/chunk-OODN6LJA.js.map +1 -0
  24. package/dist/chunk-YX7BLFQZ.js +81 -0
  25. package/dist/chunk-YX7BLFQZ.js.map +1 -0
  26. package/dist/clob/index.cjs +19361 -6851
  27. package/dist/clob/index.cjs.map +1 -1
  28. package/dist/clob/index.d.cts +1243 -63
  29. package/dist/clob/index.d.ts +1243 -63
  30. package/dist/clob/index.js +6826 -2818
  31. package/dist/clob/index.js.map +1 -1
  32. package/dist/deploy/index.cjs +24734 -0
  33. package/dist/deploy/index.cjs.map +1 -0
  34. package/dist/deploy/index.d.cts +180 -0
  35. package/dist/deploy/index.d.ts +180 -0
  36. package/dist/deploy/index.js +1846 -0
  37. package/dist/deploy/index.js.map +1 -0
  38. package/dist/helpers-DD7q61nr.d.cts +7 -0
  39. package/dist/helpers-DD7q61nr.d.ts +7 -0
  40. package/dist/manager/index.cjs +6680 -0
  41. package/dist/manager/index.cjs.map +1 -0
  42. package/dist/manager/index.d.cts +1279 -0
  43. package/dist/manager/index.d.ts +1279 -0
  44. package/dist/manager/index.js +4 -0
  45. package/dist/manager/index.js.map +1 -0
  46. package/dist/passkey-manager/index.cjs +4 -5
  47. package/dist/passkey-manager/index.cjs.map +1 -1
  48. package/dist/passkey-manager/index.js +2 -2
  49. package/dist/token/index.js +1 -8585
  50. package/dist/token/index.js.map +1 -1
  51. package/dist/uploader/index.cjs +4442 -0
  52. package/dist/uploader/index.cjs.map +1 -0
  53. package/dist/uploader/index.d.cts +761 -0
  54. package/dist/uploader/index.d.ts +761 -0
  55. package/dist/uploader/index.js +4 -0
  56. package/dist/uploader/index.js.map +1 -0
  57. package/package.json +22 -2
  58. package/src/abi-manager/abi/thru/blockchain/state_proof/types.ts +1906 -0
  59. package/src/abi-manager/abi/thru/common/primitives/types.ts +2428 -0
  60. package/src/abi-manager/abi/thru/program/abi_manager/types.ts +7037 -0
  61. package/src/abi-manager/accounts.ts +91 -0
  62. package/src/abi-manager/constants.ts +19 -0
  63. package/src/abi-manager/derivation.ts +86 -0
  64. package/src/abi-manager/errors.ts +48 -0
  65. package/src/abi-manager/index.test.ts +136 -0
  66. package/src/abi-manager/index.ts +56 -0
  67. package/src/abi-manager/instructions.ts +573 -0
  68. package/src/abi-manager/types.ts +150 -0
  69. package/src/amm/index.test.ts +8 -2
  70. package/src/amm/index.ts +1 -1
  71. package/src/clob/abi/thru/program/clob/types.ts +6981 -3070
  72. package/src/clob/exchange-client.test.ts +592 -0
  73. package/src/clob/exchange-client.ts +953 -0
  74. package/src/clob/exchange.test.ts +18 -16
  75. package/src/clob/exchange.ts +4 -0
  76. package/src/clob/index.test.ts +134 -7
  77. package/src/clob/index.ts +303 -10
  78. package/src/clob/price.test.ts +32 -0
  79. package/src/clob/price.ts +77 -0
  80. package/src/deploy/accounts.ts +208 -0
  81. package/src/deploy/chain.ts +163 -0
  82. package/src/deploy/constants.ts +25 -0
  83. package/src/deploy/deploy.test.ts +349 -0
  84. package/src/deploy/errors.ts +72 -0
  85. package/src/deploy/index.ts +44 -0
  86. package/src/deploy/inspection.ts +146 -0
  87. package/src/deploy/seeds.ts +29 -0
  88. package/src/deploy/types.ts +178 -0
  89. package/src/deploy/uploader.test.ts +326 -0
  90. package/src/deploy/uploader.ts +558 -0
  91. package/src/deploy/validation-imports.test.ts +55 -0
  92. package/src/deploy/validation.ts +183 -0
  93. package/src/deploy/workflows.test.ts +422 -0
  94. package/src/deploy/workflows.ts +1088 -0
  95. package/src/helpers/bytes.test.ts +58 -0
  96. package/src/helpers/bytes.ts +28 -3
  97. package/src/manager/abi/thru/blockchain/state_proof/types.ts +1906 -0
  98. package/src/manager/abi/thru/common/primitives/types.ts +2428 -0
  99. package/src/manager/abi/thru/program/manager/types.ts +3814 -0
  100. package/src/manager/accounts.ts +44 -0
  101. package/src/manager/constants.ts +16 -0
  102. package/src/manager/derivation.ts +32 -0
  103. package/src/manager/errors.ts +47 -0
  104. package/src/manager/index.test.ts +108 -0
  105. package/src/manager/index.ts +68 -0
  106. package/src/manager/instructions.ts +281 -0
  107. package/src/manager/types.ts +95 -0
  108. package/src/manager/validation.ts +35 -0
  109. package/src/uploader/abi/thru/common/primitives/types.ts +2428 -0
  110. package/src/uploader/abi/thru/program/uploader/types.ts +3022 -0
  111. package/src/uploader/accounts.ts +38 -0
  112. package/src/uploader/constants.ts +14 -0
  113. package/src/uploader/derivation.ts +34 -0
  114. package/src/uploader/errors.ts +25 -0
  115. package/src/uploader/index.test.ts +107 -0
  116. package/src/uploader/index.ts +34 -0
  117. package/src/uploader/instructions.ts +163 -0
  118. package/src/uploader/types.ts +67 -0
  119. package/src/utils/helpers.ts +121 -0
  120. package/tsup.config.ts +4 -0
  121. package/dist/chunk-P5OABVJI.js +0 -28
  122. package/dist/chunk-P5OABVJI.js.map +0 -1
@@ -0,0 +1,592 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { Pubkey } from '@thru/sdk';
3
+ import { encodeAddress } from '@thru/sdk/helpers';
4
+ import type { Thru } from '@thru/sdk/client';
5
+ import { deriveTokenAccountAddress } from '../token';
6
+ import {
7
+ TickerFieldBuilder,
8
+ TokenAccountBuilder,
9
+ TokenMintAccountBuilder,
10
+ } from '../token/abi/thru/program/token/types';
11
+ import {
12
+ CLOB_PROGRAM_ADDRESS,
13
+ CLOB_STATUS_FLAG_DEPOSITS_FROZEN,
14
+ CLOB_STATUS_FLAG_PAUSED,
15
+ SeatEntryBuilder,
16
+ } from './index';
17
+ import {
18
+ ClobExchangeClientError,
19
+ createClobExchangeClient,
20
+ type ClobExchangeDataSource,
21
+ } from './exchange-client';
22
+ import type { ClobAssetBalanceAllocation, ClobTradingMarket } from './exchange';
23
+
24
+ const AUTHORITY = address(10);
25
+ const TOKEN_PROGRAM = address(11);
26
+ const EXCHANGE_META = address(12);
27
+ const BTC = address(20);
28
+ const ETH = address(21);
29
+ const USD = address(22);
30
+ const OTHER = address(23);
31
+
32
+ describe('ClobExchangeClient', () => {
33
+ it('discovers assets by mint and token program and reads each canonical account once', async () => {
34
+ const markets = [market(30, BTC, USD), market(31, USD, ETH)];
35
+ const harness = createHarness({
36
+ markets,
37
+ allocations: [
38
+ balance(markets[0]!, USD, 'quote', 40n),
39
+ balance(markets[1]!, USD, 'base', 60n),
40
+ ],
41
+ });
42
+ harness.setMint(USD, 6, 'USD');
43
+
44
+ const snapshot = await harness.client.getAccountSnapshot({ authority: AUTHORITY });
45
+
46
+ expect(snapshot.assets.map((asset) => asset.mint)).toEqual([BTC, ETH, USD].sort());
47
+ expect(snapshot.assets.find((asset) => asset.mint === USD)?.exchange.freeAmount).toBe(100n);
48
+ expect(snapshot.assets.find((asset) => asset.mint === USD)).toMatchObject({
49
+ symbol: 'USD',
50
+ decimals: 6,
51
+ });
52
+ expect(snapshot.unavailableMarkets).toEqual([]);
53
+ for (const asset of snapshot.assets) {
54
+ expect(asset.discoveryComplete).toBe(true);
55
+ expect(asset.wallet).toMatchObject({ amount: 0n, exists: false });
56
+ expect(harness.reads.get(asset.wallet.tokenAccount)).toBe(1);
57
+ }
58
+ });
59
+
60
+ it('returns healthy assets when an unrelated market is unavailable', async () => {
61
+ const healthy = market(32, BTC, USD);
62
+ const unavailable = market(33, ETH, OTHER);
63
+ const harness = createHarness({
64
+ markets: [healthy],
65
+ unavailableMarkets: [{
66
+ market: unavailable.address,
67
+ baseMint: unavailable.baseMint,
68
+ quoteMint: unavailable.quoteMint,
69
+ reason: 'detail request failed',
70
+ }],
71
+ });
72
+
73
+ const snapshot = await harness.client.getAccountSnapshot({ authority: AUTHORITY });
74
+
75
+ expect(snapshot.assets.map((asset) => asset.mint)).toEqual([BTC, USD].sort());
76
+ expect(snapshot.assets.every((asset) => asset.discoveryComplete)).toBe(true);
77
+ expect(snapshot.unavailableMarkets).toHaveLength(1);
78
+ });
79
+
80
+ it('keeps allocation-only assets visible and marks their balances partial', async () => {
81
+ const healthy = market(34, BTC, USD);
82
+ const unavailable = market(35, ETH, OTHER);
83
+ const harness = createHarness({
84
+ markets: [healthy],
85
+ allocations: [balance(unavailable, ETH, 'base', 7n)],
86
+ unavailableMarkets: [{
87
+ market: unavailable.address,
88
+ baseMint: unavailable.baseMint,
89
+ quoteMint: unavailable.quoteMint,
90
+ reason: 'detail request failed',
91
+ }],
92
+ });
93
+
94
+ const snapshot = await harness.client.getAccountSnapshot({ authority: AUTHORITY });
95
+ const eth = snapshot.assets.find((asset) => asset.mint === ETH);
96
+
97
+ expect(eth).toMatchObject({
98
+ discoveryComplete: false,
99
+ exchange: { freeAmount: 7n },
100
+ });
101
+ expect(snapshot.assets.find((asset) => asset.mint === BTC)?.discoveryComplete).toBe(true);
102
+ });
103
+
104
+ it('marks every returned asset partial when unavailable metadata has unknown mints', async () => {
105
+ const healthy = market(36, BTC, USD);
106
+ const harness = createHarness({
107
+ markets: [healthy],
108
+ unavailableMarkets: [{
109
+ market: address(37),
110
+ baseMint: null,
111
+ quoteMint: null,
112
+ reason: 'metadata is unavailable',
113
+ }],
114
+ });
115
+
116
+ const snapshot = await harness.client.getAccountSnapshot({ authority: AUTHORITY });
117
+
118
+ expect(snapshot.assets).not.toHaveLength(0);
119
+ expect(snapshot.assets.every((asset) => !asset.discoveryComplete)).toBe(true);
120
+ });
121
+
122
+ it('selects a deterministic fallback market and creates a seat when none exists', async () => {
123
+ const later = market(81, BTC, USD);
124
+ const earlier = market(80, BTC, USD);
125
+ const harness = createHarness({ markets: [later, earlier] });
126
+ harness.setWalletBalance(BTC, 100n);
127
+ harness.setSeats(later, []);
128
+ harness.setSeats(earlier, []);
129
+
130
+ const prepared = await harness.client.prepareDeposit({
131
+ authority: AUTHORITY,
132
+ mint: BTC,
133
+ amount: 10n,
134
+ });
135
+
136
+ expect(prepared.market.address).toBe(earlier.address);
137
+ expect(prepared.seatIndex).toBeNull();
138
+ });
139
+
140
+ it('prefers a market with an existing seat and returns authoritative balance effects', async () => {
141
+ const first = market(40, BTC, USD);
142
+ const second = market(41, BTC, USD);
143
+ const allocation = balance(second, BTC, 'base', 25n);
144
+ const harness = createHarness({ markets: [first, second], allocations: [allocation] });
145
+ harness.setWalletBalance(BTC, 100n);
146
+ harness.setSeats(second, [{ authority: AUTHORITY, base: 25n, quote: 0n }]);
147
+
148
+ const prepared = await harness.client.prepareDeposit({
149
+ authority: AUTHORITY,
150
+ mint: BTC,
151
+ amount: 10n,
152
+ });
153
+
154
+ expect(prepared.market.address).toBe(second.address);
155
+ expect(prepared.seatIndex).toBe(2);
156
+ expect(prepared.tokenSide).toBe('base');
157
+ expect(prepared.effects).toEqual([
158
+ { location: 'wallet', mint: BTC, tokenProgram: TOKEN_PROGRAM, delta: -10n },
159
+ { location: 'exchange', mint: BTC, tokenProgram: TOKEN_PROGRAM, delta: 10n, market: second.address },
160
+ ]);
161
+ });
162
+
163
+ it('skips a frozen existing market when another market accepts deposits', async () => {
164
+ const frozen = { ...market(42, BTC, USD), statusFlags: CLOB_STATUS_FLAG_DEPOSITS_FROZEN };
165
+ const available = market(43, BTC, USD);
166
+ const harness = createHarness({
167
+ markets: [frozen, available],
168
+ allocations: [balance(frozen, BTC, 'base', 25n)],
169
+ });
170
+ harness.setWalletBalance(BTC, 100n);
171
+ harness.setSeats(available, []);
172
+
173
+ const prepared = await harness.client.prepareDeposit({
174
+ authority: AUTHORITY,
175
+ mint: BTC,
176
+ amount: 10n,
177
+ });
178
+
179
+ expect(prepared.market.address).toBe(available.address);
180
+ });
181
+
182
+ it('skips a paused existing market when an active market accepts deposits', async () => {
183
+ const paused = { ...market(44, BTC, USD), statusFlags: CLOB_STATUS_FLAG_PAUSED };
184
+ const active = market(45, BTC, USD);
185
+ const harness = createHarness({
186
+ markets: [paused, active],
187
+ allocations: [balance(paused, BTC, 'base', 25n)],
188
+ });
189
+ harness.setWalletBalance(BTC, 100n);
190
+ harness.setSeats(active, []);
191
+
192
+ const prepared = await harness.client.prepareDeposit({
193
+ authority: AUTHORITY,
194
+ mint: BTC,
195
+ amount: 10n,
196
+ });
197
+
198
+ expect(prepared.market.address).toBe(active.address);
199
+ });
200
+
201
+ it('rejects deposits when every compatible market is paused', async () => {
202
+ const paused = { ...market(46, BTC, USD), statusFlags: CLOB_STATUS_FLAG_PAUSED };
203
+ const harness = createHarness({ markets: [paused] });
204
+
205
+ await expect(harness.client.prepareDeposit({
206
+ authority: AUTHORITY,
207
+ mint: BTC,
208
+ amount: 10n,
209
+ })).rejects.toMatchObject({ code: 'market_paused' });
210
+ });
211
+
212
+ it('keeps paused markets available for withdrawals', async () => {
213
+ const paused = { ...market(48, BTC, USD), statusFlags: CLOB_STATUS_FLAG_PAUSED };
214
+ const harness = createHarness({
215
+ markets: [paused],
216
+ allocations: [balance(paused, BTC, 'base', 25n)],
217
+ });
218
+ harness.setSeats(paused, [{ authority: AUTHORITY, base: 25n, quote: 0n }]);
219
+
220
+ await expect(harness.client.prepareWithdrawal({
221
+ authority: AUTHORITY,
222
+ mint: BTC,
223
+ amount: 10n,
224
+ })).resolves.toMatchObject({ market: { address: paused.address } });
225
+ });
226
+
227
+ it('rejects a selected vault whose on-chain mint does not match', async () => {
228
+ const target = market(47, BTC, USD);
229
+ const harness = createHarness({ markets: [target] });
230
+ harness.setWalletBalance(BTC, 100n);
231
+ harness.setSeats(target, []);
232
+ harness.setVaultMint(target.baseVault, OTHER);
233
+
234
+ await expect(harness.client.prepareDeposit({
235
+ authority: AUTHORITY,
236
+ mint: BTC,
237
+ amount: 10n,
238
+ })).rejects.toMatchObject({
239
+ code: 'invalid_token_account',
240
+ details: {
241
+ market: target.address,
242
+ vault: target.baseVault,
243
+ expectedMint: BTC,
244
+ actualMint: OTHER,
245
+ },
246
+ });
247
+ });
248
+
249
+ it('uses fresh seat balances for withdrawals and reports fragmented funds', async () => {
250
+ const first = market(50, BTC, USD);
251
+ const second = market(51, BTC, USD);
252
+ const harness = createHarness({
253
+ markets: [first, second],
254
+ allocations: [balance(first, BTC, 'base', 60n), balance(second, BTC, 'base', 60n)],
255
+ });
256
+ harness.setSeats(first, [{ authority: AUTHORITY, base: 60n, quote: 0n }]);
257
+ harness.setSeats(second, [{ authority: AUTHORITY, base: 60n, quote: 0n }]);
258
+
259
+ await expect(harness.client.prepareWithdrawal({
260
+ authority: AUTHORITY,
261
+ mint: BTC,
262
+ amount: 100n,
263
+ })).rejects.toMatchObject<Partial<ClobExchangeClientError>>({ code: 'fragmented_balance' });
264
+
265
+ const prepared = await harness.client.prepareWithdrawal({
266
+ authority: AUTHORITY,
267
+ mint: BTC,
268
+ amount: 50n,
269
+ });
270
+ expect(prepared.market.address).toBe(first.address);
271
+ expect(prepared.effects.map((effect) => effect.delta)).toEqual([-50n, 50n]);
272
+ });
273
+
274
+ it('rejects an indexed funded-order plan when a source seat changed on chain', async () => {
275
+ const target = market(60, BTC, USD);
276
+ const source = market(61, ETH, USD);
277
+ const harness = createHarness({
278
+ markets: [target, source],
279
+ allocations: [
280
+ balance(target, USD, 'quote', 30n),
281
+ balance(source, USD, 'quote', 80n),
282
+ ],
283
+ });
284
+ harness.setSeats(target, [{ authority: AUTHORITY, base: 0n, quote: 30n }]);
285
+ harness.setSeats(source, [{ authority: AUTHORITY, base: 0n, quote: 20n }]);
286
+
287
+ await expect(harness.client.prepareOrder({
288
+ authority: AUTHORITY,
289
+ market: target.address,
290
+ side: 'buy',
291
+ orderType: 'gtc',
292
+ price: 10n,
293
+ quantity: 10n,
294
+ })).rejects.toMatchObject({ code: 'stale_balance' });
295
+ });
296
+
297
+ it('prepares one funded order from multiple compatible market allocations', async () => {
298
+ const target = market(90, BTC, USD);
299
+ const firstSource = market(91, ETH, USD);
300
+ const secondSource = market(92, BTC, USD);
301
+ const harness = createHarness({
302
+ markets: [target, firstSource, secondSource],
303
+ allocations: [
304
+ balance(target, USD, 'quote', 30n),
305
+ balance(firstSource, USD, 'quote', 40n),
306
+ balance(secondSource, USD, 'quote', 40n),
307
+ ],
308
+ });
309
+ harness.setSeats(target, [{ authority: AUTHORITY, base: 0n, quote: 30n }]);
310
+ harness.setSeats(firstSource, [{ authority: AUTHORITY, base: 0n, quote: 40n }]);
311
+ harness.setSeats(secondSource, [{ authority: AUTHORITY, base: 0n, quote: 40n }]);
312
+
313
+ const prepared = await harness.client.prepareOrder({
314
+ authority: AUTHORITY,
315
+ market: target.address,
316
+ side: 'buy',
317
+ orderType: 'gtc',
318
+ price: 10n,
319
+ quantity: 10n,
320
+ });
321
+
322
+ expect(prepared.funding.sources).toHaveLength(2);
323
+ expect(prepared.sourceMarkets.map((entry) => entry.address)).toEqual([
324
+ firstSource.address,
325
+ secondSource.address,
326
+ ]);
327
+ expect(prepared.effects).toEqual([{
328
+ location: 'exchange',
329
+ mint: USD,
330
+ tokenProgram: TOKEN_PROGRAM,
331
+ delta: -100n,
332
+ market: target.address,
333
+ }]);
334
+ });
335
+
336
+ it('rejects a canonical account owned by another wallet', async () => {
337
+ const onlyMarket = market(70, BTC, USD);
338
+ const harness = createHarness({ markets: [onlyMarket] });
339
+ harness.setWalletBalance(BTC, 10n, address(99));
340
+
341
+ await expect(harness.client.getAccountSnapshot({ authority: AUTHORITY })).rejects.toMatchObject({
342
+ code: 'invalid_token_account',
343
+ });
344
+ });
345
+
346
+ it('allows an operation when unavailable market metadata is unrelated to its asset', async () => {
347
+ const healthy = market(71, BTC, USD);
348
+ const unavailable = market(72, ETH, OTHER);
349
+ const harness = createHarness({
350
+ markets: [healthy],
351
+ unavailableMarkets: [{
352
+ market: unavailable.address,
353
+ baseMint: unavailable.baseMint,
354
+ quoteMint: unavailable.quoteMint,
355
+ reason: 'detail request failed',
356
+ }],
357
+ });
358
+ harness.setWalletBalance(BTC, 10n);
359
+ harness.setSeats(healthy, []);
360
+
361
+ await expect(harness.client.prepareDeposit({
362
+ authority: AUTHORITY,
363
+ mint: BTC,
364
+ amount: 1n,
365
+ })).resolves.toMatchObject({ market: { address: healthy.address } });
366
+ });
367
+
368
+ it('rejects an operation when unavailable market metadata may affect its asset', async () => {
369
+ const healthy = market(73, BTC, USD);
370
+ const unavailable = market(74, BTC, ETH);
371
+ const harness = createHarness({
372
+ markets: [healthy],
373
+ unavailableMarkets: [{
374
+ market: unavailable.address,
375
+ baseMint: unavailable.baseMint,
376
+ quoteMint: unavailable.quoteMint,
377
+ reason: 'detail request failed',
378
+ }],
379
+ });
380
+
381
+ await expect(harness.client.prepareDeposit({
382
+ authority: AUTHORITY,
383
+ mint: BTC,
384
+ amount: 1n,
385
+ })).rejects.toMatchObject({
386
+ code: 'data_source_unavailable',
387
+ details: { unavailableMarkets: unavailable.address, mint: BTC },
388
+ });
389
+ });
390
+
391
+ it('reports an unavailable target market specifically', async () => {
392
+ const unavailable = market(75, BTC, USD);
393
+ const harness = createHarness({
394
+ markets: [],
395
+ unavailableMarkets: [{
396
+ market: unavailable.address,
397
+ baseMint: unavailable.baseMint,
398
+ quoteMint: unavailable.quoteMint,
399
+ reason: 'market account metadata is unavailable',
400
+ }],
401
+ });
402
+
403
+ await expect(harness.client.prepareOrder({
404
+ authority: AUTHORITY,
405
+ market: unavailable.address,
406
+ side: 'buy',
407
+ price: 1n,
408
+ quantity: 1n,
409
+ })).rejects.toMatchObject({
410
+ code: 'incomplete_market_metadata',
411
+ details: { market: unavailable.address },
412
+ });
413
+ });
414
+ });
415
+
416
+ function createHarness({
417
+ markets,
418
+ allocations = [],
419
+ unavailableMarkets = [],
420
+ }: {
421
+ markets: ClobTradingMarket[];
422
+ allocations?: ClobAssetBalanceAllocation[];
423
+ unavailableMarkets?: Array<{
424
+ market: string;
425
+ baseMint: string | null;
426
+ quoteMint: string | null;
427
+ reason: string;
428
+ }>;
429
+ }) {
430
+ const accounts = new Map<string, Uint8Array>();
431
+ const reads = new Map<string, number>();
432
+ const thruClient = {
433
+ accounts: {
434
+ get: async (accountAddress: string) => {
435
+ reads.set(accountAddress, (reads.get(accountAddress) ?? 0) + 1);
436
+ const data = accounts.get(accountAddress);
437
+ if (!data) throw Object.assign(new Error('not found'), { code: 5 });
438
+ return { data: { data } };
439
+ },
440
+ },
441
+ proofs: {
442
+ generate: async () => ({ proof: new Uint8Array([1]) }),
443
+ },
444
+ helpers: {
445
+ deriveAddress: (seeds: Uint8Array[]) => {
446
+ const bytes = hashBytes(seeds);
447
+ return { address: encodeAddress(bytes), bytes };
448
+ },
449
+ deriveProgramAddress: ({ programAddress, seed }: {
450
+ programAddress: string;
451
+ seed: Uint8Array;
452
+ }) => {
453
+ const bytes = hashBytes([bytesFor(programAddress), seed]);
454
+ return { address: encodeAddress(bytes), bytes };
455
+ },
456
+ },
457
+ } as unknown as Thru;
458
+ const dataSource: ClobExchangeDataSource = {
459
+ getMarkets: async () => ({ markets, unavailableMarkets }),
460
+ getAssetAllocations: async () => allocations,
461
+ };
462
+ const client = createClobExchangeClient({
463
+ thruClient,
464
+ dataSource,
465
+ tokenProgramAddress: TOKEN_PROGRAM,
466
+ });
467
+
468
+ for (const target of markets) {
469
+ accounts.set(target.baseVault, tokenAccount(target.baseMint, CLOB_PROGRAM_ADDRESS));
470
+ accounts.set(target.quoteVault, tokenAccount(target.quoteMint, CLOB_PROGRAM_ADDRESS));
471
+ }
472
+
473
+ return {
474
+ client,
475
+ reads,
476
+ setMint(mint: string, decimals: number, symbol: string) {
477
+ const symbolBytes = new TextEncoder().encode(symbol);
478
+ const paddedSymbol = new Uint8Array(8);
479
+ paddedSymbol.set(symbolBytes);
480
+ const ticker = new TickerFieldBuilder()
481
+ .set_length(symbolBytes.length)
482
+ .set_bytes(Array.from(paddedSymbol))
483
+ .build();
484
+ accounts.set(mint, new TokenMintAccountBuilder()
485
+ .set_decimals(decimals)
486
+ .set_ticker(ticker)
487
+ .build());
488
+ },
489
+ setWalletBalance(mint: string, amount: bigint, owner = AUTHORITY) {
490
+ const tokenAccount = deriveTokenAccountAddress(
491
+ thruClient,
492
+ AUTHORITY,
493
+ mint,
494
+ TOKEN_PROGRAM
495
+ ).address;
496
+ accounts.set(tokenAccount, new TokenAccountBuilder()
497
+ .set_mint(bytesFor(mint))
498
+ .set_owner(bytesFor(owner))
499
+ .set_amount(amount)
500
+ .set_is_frozen(0)
501
+ .build());
502
+ },
503
+ setVaultMint(vault: string, mint: string) {
504
+ accounts.set(vault, tokenAccount(mint, CLOB_PROGRAM_ADDRESS));
505
+ },
506
+ setSeats(target: ClobTradingMarket, seats: Array<{
507
+ authority: string;
508
+ base: bigint;
509
+ quote: bigint;
510
+ }>) {
511
+ const data = new Uint8Array(320 + (seats.length + 1) * 64);
512
+ seats.forEach((seat, index) => {
513
+ data.set(new SeatEntryBuilder()
514
+ .set_seat_authority_pubkey(bytesFor(seat.authority))
515
+ .set_quantity_base(seat.base)
516
+ .set_quantity_quote(seat.quote)
517
+ .set_head_order_entry_idx(0)
518
+ .set_reserved0(0)
519
+ .set_non_nullable_reserved(1n)
520
+ .build(), 320 + (index + 1) * 64);
521
+ });
522
+ accounts.set(target.address, data);
523
+ },
524
+ };
525
+ }
526
+
527
+ function tokenAccount(mint: string, owner: string): Uint8Array {
528
+ return new TokenAccountBuilder()
529
+ .set_mint(bytesFor(mint))
530
+ .set_owner(bytesFor(owner))
531
+ .set_amount(0n)
532
+ .set_is_frozen(0)
533
+ .build();
534
+ }
535
+
536
+ function market(id: number, baseMint: string, quoteMint: string): ClobTradingMarket {
537
+ return {
538
+ address: address(id),
539
+ orderArena: address(id + 40),
540
+ bidsCbook: address(id + 80),
541
+ asksCbook: address(id + 120),
542
+ exchangeMeta: EXCHANGE_META,
543
+ tokenProgram: TOKEN_PROGRAM,
544
+ baseMint,
545
+ quoteMint,
546
+ baseVault: address(id + 160),
547
+ quoteVault: address(id + 180),
548
+ marketAuthority: address(id + 200),
549
+ statusFlags: 0,
550
+ };
551
+ }
552
+
553
+ function balance(
554
+ target: ClobTradingMarket,
555
+ mint: string,
556
+ tokenSide: 'base' | 'quote',
557
+ freeAmount: bigint
558
+ ): ClobAssetBalanceAllocation {
559
+ return {
560
+ market: target.address,
561
+ authority: AUTHORITY,
562
+ seatIndex: 2,
563
+ tokenSide,
564
+ mint,
565
+ vault: tokenSide === 'base' ? target.baseVault : target.quoteVault,
566
+ freeAmount,
567
+ statusFlags: 0,
568
+ tokenProgram: TOKEN_PROGRAM,
569
+ metadataReady: true,
570
+ };
571
+ }
572
+
573
+ function address(id: number): string {
574
+ const bytes = new Uint8Array(32);
575
+ bytes[0] = id & 0xff;
576
+ bytes[1] = (id >> 8) & 0xff;
577
+ return encodeAddress(bytes);
578
+ }
579
+
580
+ function bytesFor(value: string): Uint8Array {
581
+ return Pubkey.from(value).toBytes();
582
+ }
583
+
584
+ function hashBytes(seeds: Uint8Array[]): Uint8Array {
585
+ const bytes = new Uint8Array(32);
586
+ seeds.forEach((seed, seedIndex) => seed.forEach((value, index) => {
587
+ bytes[(index + seedIndex * 7) % bytes.length] = (
588
+ bytes[(index + seedIndex * 7) % bytes.length]! + value + seedIndex + 1
589
+ ) & 0xff;
590
+ }));
591
+ return bytes;
592
+ }