@thru/programs 0.4.1 → 0.4.2

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 (58) hide show
  1. package/dist/abi-manager/index.cjs +39 -2
  2. package/dist/abi-manager/index.cjs.map +1 -1
  3. package/dist/abi-manager/index.js +2 -2
  4. package/dist/amm/index.cjs +39 -2
  5. package/dist/amm/index.cjs.map +1 -1
  6. package/dist/amm/index.js +1 -1
  7. package/dist/bootstrap-addresses/index.cjs +41 -2
  8. package/dist/bootstrap-addresses/index.cjs.map +1 -1
  9. package/dist/bootstrap-addresses/index.d.cts +8 -1
  10. package/dist/bootstrap-addresses/index.d.ts +8 -1
  11. package/dist/bootstrap-addresses/index.js +1 -1
  12. package/dist/{chunk-TRPUGPZJ.js → chunk-2FFCNXCE.js} +58 -5
  13. package/dist/chunk-2FFCNXCE.js.map +1 -0
  14. package/dist/{chunk-QCJFKBAS.js → chunk-I3DLOUB4.js} +3 -3
  15. package/dist/{chunk-QCJFKBAS.js.map → chunk-I3DLOUB4.js.map} +1 -1
  16. package/dist/clob/index.cjs +41 -2
  17. package/dist/clob/index.cjs.map +1 -1
  18. package/dist/clob/index.d.cts +7 -1
  19. package/dist/clob/index.d.ts +7 -1
  20. package/dist/clob/index.js +3 -2
  21. package/dist/clob/index.js.map +1 -1
  22. package/dist/deploy/index.cjs +39 -2
  23. package/dist/deploy/index.cjs.map +1 -1
  24. package/dist/deploy/index.js +3 -3
  25. package/dist/oracle/index.cjs +39 -2
  26. package/dist/oracle/index.cjs.map +1 -1
  27. package/dist/oracle/index.js +1 -1
  28. package/dist/passkey-manager/index.cjs +42 -5
  29. package/dist/passkey-manager/index.cjs.map +1 -1
  30. package/dist/passkey-manager/index.js +1 -1
  31. package/dist/perp/index.cjs +1785 -162
  32. package/dist/perp/index.cjs.map +1 -1
  33. package/dist/perp/index.d.cts +558 -13
  34. package/dist/perp/index.d.ts +558 -13
  35. package/dist/perp/index.js +1749 -163
  36. package/dist/perp/index.js.map +1 -1
  37. package/dist/ratelimit/index.cjs +4757 -0
  38. package/dist/ratelimit/index.cjs.map +1 -0
  39. package/dist/ratelimit/index.d.cts +171 -0
  40. package/dist/ratelimit/index.d.ts +171 -0
  41. package/dist/ratelimit/index.js +4527 -0
  42. package/dist/ratelimit/index.js.map +1 -0
  43. package/package.json +7 -2
  44. package/src/bootstrap-addresses/index.test.ts +17 -0
  45. package/src/bootstrap-addresses/index.ts +12 -0
  46. package/src/clob/index.ts +7 -0
  47. package/src/perp/abi/thru/program/perp/types.ts +1949 -149
  48. package/src/perp/index.test.ts +189 -3
  49. package/src/perp/index.ts +316 -3
  50. package/src/ratelimit/abi/thru/program/ratelimit/types.ts +5448 -0
  51. package/src/ratelimit/accounts.ts +105 -0
  52. package/src/ratelimit/constants.ts +49 -0
  53. package/src/ratelimit/derivation.ts +93 -0
  54. package/src/ratelimit/index.test.ts +185 -0
  55. package/src/ratelimit/index.ts +30 -0
  56. package/src/ratelimit/instructions.ts +244 -0
  57. package/tsup.config.ts +1 -0
  58. package/dist/chunk-TRPUGPZJ.js.map +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@thru/programs",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
4
4
  "description": "Typed TypeScript clients for Thru's core on-chain programs: token, AMM, CLOB, oracle, multicall, passkey manager, and others.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://thru.org/docs/sdks/web-packages/programs/",
@@ -42,6 +42,11 @@
42
42
  "import": "./dist/passkey-manager/index.js",
43
43
  "require": "./dist/passkey-manager/index.cjs"
44
44
  },
45
+ "./ratelimit": {
46
+ "types": "./dist/ratelimit/index.d.ts",
47
+ "import": "./dist/ratelimit/index.js",
48
+ "require": "./dist/ratelimit/index.cjs"
49
+ },
45
50
  "./multicall": {
46
51
  "types": "./dist/multicall/index.d.ts",
47
52
  "import": "./dist/multicall/index.js",
@@ -99,7 +104,7 @@
99
104
  }
100
105
  },
101
106
  "dependencies": {
102
- "@thru/sdk": "0.4.1"
107
+ "@thru/sdk": "0.4.2"
103
108
  },
104
109
  "devDependencies": {
105
110
  "@types/node": "^25.9.1",
@@ -4,12 +4,14 @@ import { describe, expect, it } from 'vitest';
4
4
  import { deriveManagedProgramAddresses, MANAGER_PROGRAM_PUBKEY, MANAGER_PROGRAM_ADDRESS, MANAGER_PROGRAM_SEED, ROOT_MANAGER_PROGRAM_ADDRESS } from '../manager';
5
5
  import { UPLOADER_PROGRAM_SEED, UPLOADER_PROGRAM_ADDRESS } from '../uploader';
6
6
  import {
7
+ BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ADDRESS,
7
8
  BOOTSTRAP_PROGRAM_ADDRESSES,
8
9
  BOOTSTRAP_PROGRAM_SEEDS,
9
10
  CREDITS_MINT_ADDRESS,
10
11
  CREDITS_MINT_AUTHORITY_ADDRESS,
11
12
  CREDITS_MINT_SEED_HEX,
12
13
  } from './index';
14
+ import { Pubkey } from '@thru/sdk';
13
15
  import { createThruClient } from '@thru/sdk/client';
14
16
  import { deriveMintAddress } from '../token';
15
17
 
@@ -32,6 +34,7 @@ const EXPECTED_ADDRESSES = {
32
34
  eoa: 'taEOAD2uLK1SLzPgtabFLUAx22yDlBs9DE9nZFTOESIGRr',
33
35
  uploader: 'taUPLMH5QYOAT4ktwQeO7DXAEKtqBhYehalNGf5BJFQDYq',
34
36
  compression: 'taRB54_92jNbBdcmt2jus88F-xrOSne1GR9mmyOh4RidAK',
37
+ ratelimit: 'taRATE6MTrtFFKY10oyskMcvokJs53iD5nWE8ZyUuGknMA',
35
38
  } as const;
36
39
 
37
40
  describe('bootstrap-managed program addresses', () => {
@@ -98,6 +101,20 @@ describe('bootstrap-managed program addresses', () => {
98
101
  }
99
102
  });
100
103
 
104
+ it('derives the VERIFIED faucet rate limit policy independently of any admin', () => {
105
+ const sha = (...parts: Uint8Array[]) => {
106
+ const hash = createHash('sha256');
107
+ for (const part of parts) hash.update(part);
108
+ return hash.digest();
109
+ };
110
+ const id = Buffer.alloc(8); // policy_id 0, u64 little-endian
111
+ const seed = sha(Buffer.from('tn_ratelimit_verified_policy_v1'),
112
+ Pubkey.from(BOOTSTRAP_PROGRAM_ADDRESSES.faucet).toBytes(), id);
113
+ const policy = sha(Pubkey.from(BOOTSTRAP_PROGRAM_ADDRESSES.ratelimit).toBytes(), Uint8Array.of(0), seed);
114
+ expect(Pubkey.from(BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ADDRESS).toBytes()).toEqual(new Uint8Array(policy));
115
+ expect(BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ADDRESS).toBe('taDrvTPLhMWuRsCyAAnyNm5pkkrlmegsHrwYsJQ1GoBvfd');
116
+ });
117
+
101
118
  it('derives the approved Alphanet THRUSD mint with the wallet setup default', () => {
102
119
  const client = createThruClient({ baseUrl: 'https://rpc.test' });
103
120
  expect(createHash('sha256').update('thru:credits:app-wide-mint:v1').digest('hex'))
@@ -1,4 +1,5 @@
1
1
  import { deriveManagedProgramAddresses } from '../manager/derivation.js';
2
+ import { deriveRatelimitPolicyAddress } from '../ratelimit/derivation.js';
2
3
  import { deriveAddress, deriveProgramAddress, Pubkey } from '@thru/sdk';
3
4
 
4
5
  /** Permanent seeds used by programs/bootstrap. Changing a seed changes every
@@ -22,6 +23,7 @@ export const BOOTSTRAP_PROGRAM_SEEDS = Object.freeze({
22
23
  eoa: 'thru-program:207434',
23
24
  uploader: 'thru-program:1073768',
24
25
  compression: 'thru-compression:v1',
26
+ ratelimit: 'thru-program:1697627',
25
27
  } as const);
26
28
 
27
29
  function managedProgramAddress(seed: string): string {
@@ -56,6 +58,7 @@ export const BOOTSTRAP_PROGRAM_ADDRESSES = Object.freeze({
56
58
  eoa: managedProgramAddress(BOOTSTRAP_PROGRAM_SEEDS.eoa),
57
59
  uploader: managedProgramAddress(BOOTSTRAP_PROGRAM_SEEDS.uploader),
58
60
  compression: managedProgramAddress(BOOTSTRAP_PROGRAM_SEEDS.compression),
61
+ ratelimit: managedProgramAddress(BOOTSTRAP_PROGRAM_SEEDS.ratelimit),
59
62
  } as const);
60
63
 
61
64
  function stateAddress(program: string, label: string): string {
@@ -68,6 +71,15 @@ const wthruSeed = new Uint8Array(32);
68
71
  /** Created by Faucet initialization after deployment, never by genesis. */
69
72
  export const BOOTSTRAP_FAUCET_VAULT_ADDRESS = stateAddress(BOOTSTRAP_PROGRAM_ADDRESSES.faucet, 'vault');
70
73
 
74
+ /** VERIFIED rate limiter policy 0 for the faucet, created by bootstrap
75
+ * ratelimit setup. Its address depends only on the rate limiter, the faucet
76
+ * and policy_id, so it is the same on every network. */
77
+ export const BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ID = 0n;
78
+ export const BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ADDRESS = deriveRatelimitPolicyAddress(
79
+ BOOTSTRAP_PROGRAM_ADDRESSES.ratelimit,
80
+ { target: BOOTSTRAP_PROGRAM_ADDRESSES.faucet, policyId: BOOTSTRAP_FAUCET_RATE_LIMIT_POLICY_ID, verified: true },
81
+ ).address;
82
+
71
83
  wthruSeed.set(new TextEncoder().encode('wthru'));
72
84
  const wthruMintSeed = deriveAddress([
73
85
  Pubkey.from(BOOTSTRAP_PROGRAM_ADDRESSES.wthru).toBytes(), wthruSeed,
package/src/clob/index.ts CHANGED
@@ -680,6 +680,13 @@ export function createMarketRecordInstruction(args: MarketRecordArgs): Instructi
680
680
  };
681
681
  }
682
682
 
683
+ /** State units a market_create transaction must request. The runtime charges
684
+ ceil((64 + data_sz) / 4096) per new account, and market_create creates six:
685
+ the seat arena (64320 bytes: 16), the order arena (64072 bytes: 16), the
686
+ bids and asks cbooks (96 bytes: 1 each) and the base and quote vault token
687
+ accounts (73 bytes: 1 each). Requesting fewer fails with SU_EXHAUSTED. */
688
+ export const CLOB_MARKET_CREATE_STATE_UNITS = 36;
689
+
683
690
  export function createMarketCreateInstruction(args: MarketCreateArgs): InstructionData {
684
691
  return async (context) => {
685
692
  assertU64(args.lotSize, 'lotSize');