perp-cli 0.9.8 → 0.12.0

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 (254) hide show
  1. package/README.md +30 -25
  2. package/dist/_stderr-filter.d.ts +0 -0
  3. package/dist/_stderr-filter.js +30 -0
  4. package/dist/agent-wallet/expiry.d.ts +15 -0
  5. package/dist/agent-wallet/expiry.js +26 -0
  6. package/dist/agent-wallet/lighter-keystore.d.ts +34 -0
  7. package/dist/agent-wallet/lighter-keystore.js +232 -0
  8. package/dist/agent-wallet/passphrase.d.ts +13 -0
  9. package/dist/agent-wallet/passphrase.js +54 -0
  10. package/dist/agent-wallet/signing-strategy.d.ts +67 -0
  11. package/dist/agent-wallet/signing-strategy.js +51 -0
  12. package/dist/agent-wallet/store.d.ts +37 -0
  13. package/dist/agent-wallet/store.js +172 -0
  14. package/dist/api/public/_http.d.ts +15 -0
  15. package/dist/api/public/_http.js +24 -0
  16. package/dist/api/public/hyperliquid.js +36 -24
  17. package/dist/api/public/lighter.d.ts +7 -1
  18. package/dist/api/public/lighter.js +85 -37
  19. package/dist/api/public/pacifica.js +47 -18
  20. package/dist/bot/engine.js +23 -4
  21. package/dist/bot/presets.js +3 -3
  22. package/dist/bot/strategies/funding-arb-strategy.d.ts +0 -23
  23. package/dist/bot/strategies/funding-arb-strategy.js +41 -176
  24. package/dist/bot/strategies/funding-auto.js +2 -2
  25. package/dist/bridge-engine.js +102 -49
  26. package/dist/cli-spec.js +1 -2
  27. package/dist/commands/account.js +2 -500
  28. package/dist/commands/agent.d.ts +8 -2
  29. package/dist/commands/agent.js +1903 -366
  30. package/dist/commands/alerts.js +3 -1
  31. package/dist/commands/arb/index.js +37 -7
  32. package/dist/commands/arb-auto.js +44 -11
  33. package/dist/commands/arb.js +83 -34
  34. package/dist/commands/bot.d.ts +1 -1
  35. package/dist/commands/bot.js +20 -16
  36. package/dist/commands/bridge.d.ts +1 -1
  37. package/dist/commands/bridge.js +4 -4
  38. package/dist/commands/funds.d.ts +1 -1
  39. package/dist/commands/funds.js +18 -68
  40. package/dist/commands/jobs.d.ts +1 -1
  41. package/dist/commands/jobs.js +2 -2
  42. package/dist/commands/manage.d.ts +1 -1
  43. package/dist/commands/manage.js +12 -84
  44. package/dist/commands/plan.d.ts +1 -1
  45. package/dist/commands/plan.js +2 -2
  46. package/dist/commands/portfolio.d.ts +19 -3
  47. package/dist/commands/portfolio.js +747 -163
  48. package/dist/commands/rebalance.d.ts +1 -1
  49. package/dist/commands/rebalance.js +18 -12
  50. package/dist/commands/risk.js +2 -6
  51. package/dist/commands/settings.js +30 -53
  52. package/dist/commands/trade.js +16 -15
  53. package/dist/commands/wallet.d.ts +2 -1
  54. package/dist/commands/wallet.js +1122 -176
  55. package/dist/config.d.ts +9 -0
  56. package/dist/config.js +55 -9
  57. package/dist/errors.d.ts +64 -0
  58. package/dist/errors.js +82 -2
  59. package/dist/event-stream.js +12 -1
  60. package/dist/exchanges/aster-typed-data.d.ts +156 -0
  61. package/dist/exchanges/aster-typed-data.js +189 -0
  62. package/dist/exchanges/aster.d.ts +60 -11
  63. package/dist/exchanges/aster.js +278 -136
  64. package/dist/exchanges/hyperliquid.d.ts +14 -0
  65. package/dist/exchanges/hyperliquid.js +88 -34
  66. package/dist/exchanges/lighter-spot.js +19 -5
  67. package/dist/exchanges/lighter.d.ts +66 -0
  68. package/dist/exchanges/lighter.js +213 -31
  69. package/dist/exchanges/pacifica-typed-data.d.ts +75 -0
  70. package/dist/exchanges/pacifica-typed-data.js +74 -0
  71. package/dist/exchanges/pacifica.d.ts +29 -1
  72. package/dist/exchanges/pacifica.js +94 -6
  73. package/dist/funding/rates.js +59 -21
  74. package/dist/guardrail/contracts.d.ts +14 -0
  75. package/dist/guardrail/contracts.js +72 -0
  76. package/dist/guardrail/perp-guardrail.d.ts +21 -0
  77. package/dist/guardrail/perp-guardrail.js +145 -0
  78. package/dist/index.d.ts +1 -1
  79. package/dist/index.js +307 -362
  80. package/dist/jobs.js +3 -1
  81. package/dist/mcp-server.js +92 -88
  82. package/dist/position-history.js +47 -4
  83. package/dist/settings.d.ts +69 -3
  84. package/dist/settings.js +3 -2
  85. package/dist/signer/index.d.ts +2 -0
  86. package/dist/signer/index.js +2 -0
  87. package/dist/signer/ows-evm.d.ts +32 -0
  88. package/dist/signer/ows-evm.js +86 -0
  89. package/dist/signer/ows-loader.d.ts +2 -0
  90. package/dist/signer/ows-loader.js +6 -0
  91. package/dist/signer/ows-solana.d.ts +25 -0
  92. package/dist/signer/ows-solana.js +56 -0
  93. package/dist/smart-order.d.ts +8 -2
  94. package/dist/smart-order.js +46 -11
  95. package/dist/strategies/funding-arb.js +29 -8
  96. package/dist/trade-validator.js +30 -5
  97. package/dist/utils.d.ts +10 -0
  98. package/dist/utils.js +19 -0
  99. package/package.json +4 -2
  100. package/skills/perp-cli/SKILL.md +23 -14
  101. package/skills/perp-cli/references/agent-operations.md +6 -4
  102. package/skills/perp-cli/references/commands.md +55 -34
  103. package/skills/perp-cli/scripts/preflight.sh +4 -4
  104. package/skills/perp-cli/scripts/spot-perp-scan.sh +2 -2
  105. package/dist/__tests__/alert-logic.test.d.ts +0 -1
  106. package/dist/__tests__/alert-logic.test.js +0 -107
  107. package/dist/__tests__/arb-auto-3dex.test.d.ts +0 -1
  108. package/dist/__tests__/arb-auto-3dex.test.js +0 -397
  109. package/dist/__tests__/arb-history-stats.test.d.ts +0 -1
  110. package/dist/__tests__/arb-history-stats.test.js +0 -176
  111. package/dist/__tests__/arb-logic.test.d.ts +0 -1
  112. package/dist/__tests__/arb-logic.test.js +0 -84
  113. package/dist/__tests__/arb-manage.test.d.ts +0 -1
  114. package/dist/__tests__/arb-manage.test.js +0 -253
  115. package/dist/__tests__/arb-new-features.test.d.ts +0 -1
  116. package/dist/__tests__/arb-new-features.test.js +0 -457
  117. package/dist/__tests__/arb-sizing.test.d.ts +0 -1
  118. package/dist/__tests__/arb-sizing.test.js +0 -48
  119. package/dist/__tests__/arb-state.test.d.ts +0 -1
  120. package/dist/__tests__/arb-state.test.js +0 -284
  121. package/dist/__tests__/arb-userflow.test.d.ts +0 -1
  122. package/dist/__tests__/arb-userflow.test.js +0 -945
  123. package/dist/__tests__/arb-utils.test.d.ts +0 -1
  124. package/dist/__tests__/arb-utils.test.js +0 -264
  125. package/dist/__tests__/bot-conditions.test.d.ts +0 -1
  126. package/dist/__tests__/bot-conditions.test.js +0 -341
  127. package/dist/__tests__/client-id-tracker.test.d.ts +0 -1
  128. package/dist/__tests__/client-id-tracker.test.js +0 -137
  129. package/dist/__tests__/commands/new-atomic-commands.test.d.ts +0 -1
  130. package/dist/__tests__/commands/new-atomic-commands.test.js +0 -502
  131. package/dist/__tests__/commands/order-intent.test.d.ts +0 -1
  132. package/dist/__tests__/commands/order-intent.test.js +0 -600
  133. package/dist/__tests__/commands/trade-commands.test.d.ts +0 -1
  134. package/dist/__tests__/commands/trade-commands.test.js +0 -821
  135. package/dist/__tests__/config.test.d.ts +0 -1
  136. package/dist/__tests__/config.test.js +0 -86
  137. package/dist/__tests__/cross-chain-margin.test.d.ts +0 -1
  138. package/dist/__tests__/cross-chain-margin.test.js +0 -287
  139. package/dist/__tests__/dex-asset-map.test.d.ts +0 -1
  140. package/dist/__tests__/dex-asset-map.test.js +0 -191
  141. package/dist/__tests__/errors.test.d.ts +0 -1
  142. package/dist/__tests__/errors.test.js +0 -110
  143. package/dist/__tests__/event-stream.test.d.ts +0 -1
  144. package/dist/__tests__/event-stream.test.js +0 -276
  145. package/dist/__tests__/exchanges/interface.test.d.ts +0 -1
  146. package/dist/__tests__/exchanges/interface.test.js +0 -132
  147. package/dist/__tests__/exchanges/mock-adapter.d.ts +0 -69
  148. package/dist/__tests__/exchanges/mock-adapter.js +0 -137
  149. package/dist/__tests__/execution-log.test.d.ts +0 -1
  150. package/dist/__tests__/execution-log.test.js +0 -106
  151. package/dist/__tests__/funding-calc.test.d.ts +0 -1
  152. package/dist/__tests__/funding-calc.test.js +0 -71
  153. package/dist/__tests__/funding-history.test.d.ts +0 -1
  154. package/dist/__tests__/funding-history.test.js +0 -343
  155. package/dist/__tests__/funding-rates.test.d.ts +0 -1
  156. package/dist/__tests__/funding-rates.test.js +0 -342
  157. package/dist/__tests__/funding.test.d.ts +0 -1
  158. package/dist/__tests__/funding.test.js +0 -173
  159. package/dist/__tests__/gap-logic.test.d.ts +0 -1
  160. package/dist/__tests__/gap-logic.test.js +0 -43
  161. package/dist/__tests__/hip3-dex.test.d.ts +0 -1
  162. package/dist/__tests__/hip3-dex.test.js +0 -234
  163. package/dist/__tests__/integration/agent-features.integration.test.d.ts +0 -1
  164. package/dist/__tests__/integration/agent-features.integration.test.js +0 -553
  165. package/dist/__tests__/integration/atomic-commands.integration.test.d.ts +0 -13
  166. package/dist/__tests__/integration/atomic-commands.integration.test.js +0 -246
  167. package/dist/__tests__/integration/bridge-simulation.integration.test.d.ts +0 -1
  168. package/dist/__tests__/integration/bridge-simulation.integration.test.js +0 -453
  169. package/dist/__tests__/integration/bridge-strict.integration.test.d.ts +0 -1
  170. package/dist/__tests__/integration/bridge-strict.integration.test.js +0 -812
  171. package/dist/__tests__/integration/bridge.integration.test.d.ts +0 -1
  172. package/dist/__tests__/integration/bridge.integration.test.js +0 -309
  173. package/dist/__tests__/integration/cli-e2e.integration.test.d.ts +0 -1
  174. package/dist/__tests__/integration/cli-e2e.integration.test.js +0 -202
  175. package/dist/__tests__/integration/dex-arb.integration.test.d.ts +0 -1
  176. package/dist/__tests__/integration/dex-arb.integration.test.js +0 -116
  177. package/dist/__tests__/integration/envelope-consistency.integration.test.d.ts +0 -13
  178. package/dist/__tests__/integration/envelope-consistency.integration.test.js +0 -205
  179. package/dist/__tests__/integration/hip3-dex.integration.test.d.ts +0 -1
  180. package/dist/__tests__/integration/hip3-dex.integration.test.js +0 -147
  181. package/dist/__tests__/integration/hyperliquid.integration.test.d.ts +0 -1
  182. package/dist/__tests__/integration/hyperliquid.integration.test.js +0 -79
  183. package/dist/__tests__/integration/lighter.integration.test.d.ts +0 -1
  184. package/dist/__tests__/integration/lighter.integration.test.js +0 -53
  185. package/dist/__tests__/integration/new-commands-e2e.integration.test.d.ts +0 -9
  186. package/dist/__tests__/integration/new-commands-e2e.integration.test.js +0 -236
  187. package/dist/__tests__/integration/order-verification.integration.test.d.ts +0 -1
  188. package/dist/__tests__/integration/order-verification.integration.test.js +0 -321
  189. package/dist/__tests__/integration/pacifica.integration.test.d.ts +0 -1
  190. package/dist/__tests__/integration/pacifica.integration.test.js +0 -75
  191. package/dist/__tests__/integration/response-shapes.integration.test.d.ts +0 -1
  192. package/dist/__tests__/integration/response-shapes.integration.test.js +0 -278
  193. package/dist/__tests__/liquidity.test.d.ts +0 -1
  194. package/dist/__tests__/liquidity.test.js +0 -225
  195. package/dist/__tests__/plan-executor.test.d.ts +0 -1
  196. package/dist/__tests__/plan-executor.test.js +0 -314
  197. package/dist/__tests__/position-history.test.d.ts +0 -1
  198. package/dist/__tests__/position-history.test.js +0 -367
  199. package/dist/__tests__/retry.test.d.ts +0 -1
  200. package/dist/__tests__/retry.test.js +0 -310
  201. package/dist/__tests__/risk-assessment.test.d.ts +0 -1
  202. package/dist/__tests__/risk-assessment.test.js +0 -288
  203. package/dist/__tests__/security-adversarial.test.d.ts +0 -1
  204. package/dist/__tests__/security-adversarial.test.js +0 -574
  205. package/dist/__tests__/strategies.test.d.ts +0 -1
  206. package/dist/__tests__/strategies.test.js +0 -539
  207. package/dist/__tests__/trade-execution.test.d.ts +0 -1
  208. package/dist/__tests__/trade-execution.test.js +0 -129
  209. package/dist/__tests__/trade-validator.test.d.ts +0 -1
  210. package/dist/__tests__/trade-validator.test.js +0 -655
  211. package/dist/__tests__/utils.test.d.ts +0 -1
  212. package/dist/__tests__/utils.test.js +0 -76
  213. package/dist/arb/reconcile.d.ts +0 -28
  214. package/dist/arb/reconcile.js +0 -162
  215. package/dist/commands/alert.d.ts +0 -2
  216. package/dist/commands/alert.js +0 -421
  217. package/dist/commands/analytics.d.ts +0 -3
  218. package/dist/commands/analytics.js +0 -311
  219. package/dist/commands/arb-manage.d.ts +0 -5
  220. package/dist/commands/arb-manage.js +0 -5
  221. package/dist/commands/dashboard.d.ts +0 -3
  222. package/dist/commands/dashboard.js +0 -176
  223. package/dist/commands/deposit.d.ts +0 -4
  224. package/dist/commands/deposit.js +0 -573
  225. package/dist/commands/dex.d.ts +0 -3
  226. package/dist/commands/dex.js +0 -120
  227. package/dist/commands/env.d.ts +0 -2
  228. package/dist/commands/env.js +0 -136
  229. package/dist/commands/funding.d.ts +0 -3
  230. package/dist/commands/funding.js +0 -554
  231. package/dist/commands/gap.d.ts +0 -2
  232. package/dist/commands/gap.js +0 -305
  233. package/dist/commands/health.d.ts +0 -2
  234. package/dist/commands/health.js +0 -67
  235. package/dist/commands/multileg.d.ts +0 -16
  236. package/dist/commands/multileg.js +0 -174
  237. package/dist/commands/pnl.d.ts +0 -12
  238. package/dist/commands/pnl.js +0 -243
  239. package/dist/commands/run.d.ts +0 -3
  240. package/dist/commands/run.js +0 -202
  241. package/dist/commands/stream.d.ts +0 -5
  242. package/dist/commands/stream.js +0 -200
  243. package/dist/commands/withdraw.d.ts +0 -3
  244. package/dist/commands/withdraw.js +0 -187
  245. package/dist/exchanges/edgex.d.ts +0 -62
  246. package/dist/exchanges/edgex.js +0 -552
  247. package/dist/exchanges/nado.d.ts +0 -52
  248. package/dist/exchanges/nado.js +0 -223
  249. package/dist/funding/index.d.ts +0 -3
  250. package/dist/funding/index.js +0 -3
  251. package/dist/retry.d.ts +0 -74
  252. package/dist/retry.js +0 -129
  253. package/dist/ws/market-feed.d.ts +0 -74
  254. package/dist/ws/market-feed.js +0 -227
@@ -1,284 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
- import { existsSync, unlinkSync, mkdirSync, writeFileSync } from "fs";
3
- import { resolve } from "path";
4
- import { loadArbState, saveArbState, addPosition, removePosition, updatePosition, getPositions, createInitialState, setStateFilePath, resetStateFilePath, } from "../arb-state.js";
5
- const TEST_DIR = resolve(process.env.HOME || "~", ".perp", "test-arb-state");
6
- const TEST_FILE = resolve(TEST_DIR, "arb-state.json");
7
- function makePosition(overrides = {}) {
8
- return {
9
- id: `test-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
10
- symbol: "ETH",
11
- longExchange: "hyperliquid",
12
- shortExchange: "pacifica",
13
- longSize: 0.5,
14
- shortSize: 0.5,
15
- entryTime: "2025-01-15T10:00:00.000Z",
16
- entrySpread: 35.2,
17
- entryLongPrice: 3200.5,
18
- entryShortPrice: 3201.0,
19
- accumulatedFunding: 0,
20
- lastCheckTime: "2025-01-15T10:00:00.000Z",
21
- ...overrides,
22
- };
23
- }
24
- describe("Arb State Persistence", () => {
25
- const TMP_FILE = TEST_FILE + ".tmp";
26
- beforeEach(() => {
27
- if (!existsSync(TEST_DIR))
28
- mkdirSync(TEST_DIR, { recursive: true });
29
- if (existsSync(TEST_FILE))
30
- unlinkSync(TEST_FILE);
31
- if (existsSync(TMP_FILE))
32
- unlinkSync(TMP_FILE);
33
- setStateFilePath(TEST_FILE);
34
- });
35
- afterEach(() => {
36
- if (existsSync(TEST_FILE))
37
- unlinkSync(TEST_FILE);
38
- if (existsSync(TMP_FILE))
39
- unlinkSync(TMP_FILE);
40
- resetStateFilePath();
41
- });
42
- it("loadArbState returns null when no file exists", () => {
43
- const state = loadArbState();
44
- expect(state).toBeNull();
45
- });
46
- it("saveArbState + loadArbState roundtrip", () => {
47
- const state = createInitialState({
48
- minSpread: 30,
49
- closeSpread: 5,
50
- size: 100,
51
- holdDays: 7,
52
- bridgeCost: 0.5,
53
- maxPositions: 5,
54
- settleStrategy: "aware",
55
- });
56
- state.positions.push(makePosition({ symbol: "BTC", longSize: 0.01, shortSize: 0.01 }));
57
- saveArbState(state);
58
- const loaded = loadArbState();
59
- expect(loaded).not.toBeNull();
60
- expect(loaded.version).toBe(1);
61
- expect(loaded.config.minSpread).toBe(30);
62
- expect(loaded.config.closeSpread).toBe(5);
63
- expect(loaded.config.size).toBe(100);
64
- expect(loaded.positions).toHaveLength(1);
65
- expect(loaded.positions[0].symbol).toBe("BTC");
66
- expect(loaded.positions[0].longSize).toBe(0.01);
67
- });
68
- it("addPosition adds to existing state", () => {
69
- const state = createInitialState({
70
- minSpread: 30,
71
- closeSpread: 5,
72
- size: 100,
73
- holdDays: 7,
74
- bridgeCost: 0.5,
75
- maxPositions: 5,
76
- settleStrategy: "aware",
77
- });
78
- saveArbState(state);
79
- addPosition(makePosition({ symbol: "ETH" }));
80
- addPosition(makePosition({ symbol: "BTC" }));
81
- const positions = getPositions();
82
- expect(positions).toHaveLength(2);
83
- expect(positions.map(p => p.symbol).sort()).toEqual(["BTC", "ETH"]);
84
- });
85
- it("addPosition replaces duplicate symbol", () => {
86
- const state = createInitialState({
87
- minSpread: 30,
88
- closeSpread: 5,
89
- size: 100,
90
- holdDays: 7,
91
- bridgeCost: 0.5,
92
- maxPositions: 5,
93
- settleStrategy: "aware",
94
- });
95
- saveArbState(state);
96
- addPosition(makePosition({ symbol: "ETH", longSize: 1.0 }));
97
- addPosition(makePosition({ symbol: "ETH", longSize: 2.0 }));
98
- const positions = getPositions();
99
- expect(positions).toHaveLength(1);
100
- expect(positions[0].longSize).toBe(2.0);
101
- });
102
- it("removePosition removes by symbol", () => {
103
- const state = createInitialState({
104
- minSpread: 30,
105
- closeSpread: 5,
106
- size: 100,
107
- holdDays: 7,
108
- bridgeCost: 0.5,
109
- maxPositions: 5,
110
- settleStrategy: "aware",
111
- });
112
- saveArbState(state);
113
- addPosition(makePosition({ symbol: "ETH" }));
114
- addPosition(makePosition({ symbol: "BTC" }));
115
- addPosition(makePosition({ symbol: "SOL" }));
116
- removePosition("BTC");
117
- const positions = getPositions();
118
- expect(positions).toHaveLength(2);
119
- expect(positions.map(p => p.symbol).sort()).toEqual(["ETH", "SOL"]);
120
- });
121
- it("removePosition is a no-op for unknown symbol", () => {
122
- const state = createInitialState({
123
- minSpread: 30,
124
- closeSpread: 5,
125
- size: 100,
126
- holdDays: 7,
127
- bridgeCost: 0.5,
128
- maxPositions: 5,
129
- settleStrategy: "aware",
130
- });
131
- saveArbState(state);
132
- addPosition(makePosition({ symbol: "ETH" }));
133
- removePosition("NONEXISTENT");
134
- const positions = getPositions();
135
- expect(positions).toHaveLength(1);
136
- });
137
- it("updatePosition updates partial fields", () => {
138
- const state = createInitialState({
139
- minSpread: 30,
140
- closeSpread: 5,
141
- size: 100,
142
- holdDays: 7,
143
- bridgeCost: 0.5,
144
- maxPositions: 5,
145
- settleStrategy: "aware",
146
- });
147
- saveArbState(state);
148
- addPosition(makePosition({
149
- symbol: "ETH",
150
- accumulatedFunding: 0,
151
- lastCheckTime: "2025-01-15T10:00:00.000Z",
152
- }));
153
- updatePosition("ETH", {
154
- accumulatedFunding: 1.234,
155
- lastCheckTime: "2025-01-15T12:00:00.000Z",
156
- });
157
- const positions = getPositions();
158
- expect(positions).toHaveLength(1);
159
- expect(positions[0].accumulatedFunding).toBe(1.234);
160
- expect(positions[0].lastCheckTime).toBe("2025-01-15T12:00:00.000Z");
161
- // Other fields unchanged
162
- expect(positions[0].symbol).toBe("ETH");
163
- expect(positions[0].longExchange).toBe("hyperliquid");
164
- });
165
- it("updatePosition is a no-op for unknown symbol", () => {
166
- const state = createInitialState({
167
- minSpread: 30,
168
- closeSpread: 5,
169
- size: 100,
170
- holdDays: 7,
171
- bridgeCost: 0.5,
172
- maxPositions: 5,
173
- settleStrategy: "aware",
174
- });
175
- saveArbState(state);
176
- addPosition(makePosition({ symbol: "ETH" }));
177
- updatePosition("NONEXISTENT", { accumulatedFunding: 999 });
178
- const positions = getPositions();
179
- expect(positions).toHaveLength(1);
180
- expect(positions[0].symbol).toBe("ETH");
181
- });
182
- it("getPositions returns empty list when no state", () => {
183
- const positions = getPositions();
184
- expect(positions).toEqual([]);
185
- });
186
- it("state survives simulated crash (save, reload in new context)", () => {
187
- // Simulate a daemon saving state then crashing
188
- const state = createInitialState({
189
- minSpread: 25,
190
- closeSpread: 3,
191
- size: "auto",
192
- holdDays: 5,
193
- bridgeCost: 1.0,
194
- maxPositions: 3,
195
- settleStrategy: "aware",
196
- });
197
- state.positions.push(makePosition({ symbol: "ETH", accumulatedFunding: 5.67 }));
198
- state.positions.push(makePosition({ symbol: "BTC", accumulatedFunding: 12.34 }));
199
- state.lastScanTime = "2025-01-15T12:00:00.000Z";
200
- saveArbState(state);
201
- // Simulate crash: reset in-memory state by reloading
202
- const recovered = loadArbState();
203
- expect(recovered).not.toBeNull();
204
- expect(recovered.positions).toHaveLength(2);
205
- expect(recovered.positions.find(p => p.symbol === "ETH").accumulatedFunding).toBe(5.67);
206
- expect(recovered.positions.find(p => p.symbol === "BTC").accumulatedFunding).toBe(12.34);
207
- expect(recovered.config.minSpread).toBe(25);
208
- expect(recovered.config.size).toBe("auto");
209
- expect(recovered.lastScanTime).toBe("2025-01-15T12:00:00.000Z");
210
- });
211
- it("loadArbState returns null for corrupt JSON", () => {
212
- writeFileSync(TEST_FILE, "not valid json{{{", { mode: 0o600 });
213
- const state = loadArbState();
214
- expect(state).toBeNull();
215
- });
216
- it("loadArbState returns null for wrong version", () => {
217
- writeFileSync(TEST_FILE, JSON.stringify({ version: 99 }), { mode: 0o600 });
218
- const state = loadArbState();
219
- expect(state).toBeNull();
220
- });
221
- it("saveArbState uses atomic write (no .tmp left after success)", () => {
222
- const state = createInitialState({
223
- minSpread: 30, closeSpread: 5, size: 100,
224
- holdDays: 7, bridgeCost: 0.5, maxPositions: 5, settleStrategy: "aware",
225
- });
226
- saveArbState(state);
227
- // Main file should exist, .tmp should NOT exist after successful save
228
- expect(existsSync(TEST_FILE)).toBe(true);
229
- expect(existsSync(TMP_FILE)).toBe(false);
230
- });
231
- it("loadArbState recovers from .tmp when main is corrupted", () => {
232
- // Simulate: valid .tmp exists but main file is corrupted (crash mid-rename)
233
- const state = createInitialState({
234
- minSpread: 25, closeSpread: 3, size: 200,
235
- holdDays: 5, bridgeCost: 1.0, maxPositions: 3, settleStrategy: "aware",
236
- });
237
- state.positions.push(makePosition({ symbol: "BTC", accumulatedFunding: 99.99 }));
238
- // Write valid state to .tmp, corrupt data to main
239
- writeFileSync(TMP_FILE, JSON.stringify(state, null, 2), { mode: 0o600 });
240
- writeFileSync(TEST_FILE, "corrupted{{{partial write", { mode: 0o600 });
241
- const recovered = loadArbState();
242
- expect(recovered).not.toBeNull();
243
- expect(recovered.positions).toHaveLength(1);
244
- expect(recovered.positions[0].symbol).toBe("BTC");
245
- expect(recovered.positions[0].accumulatedFunding).toBe(99.99);
246
- // After recovery, .tmp should be promoted to main
247
- expect(existsSync(TEST_FILE)).toBe(true);
248
- });
249
- it("loadArbState recovers from .tmp when main is missing", () => {
250
- const state = createInitialState({
251
- minSpread: 30, closeSpread: 5, size: 100,
252
- holdDays: 7, bridgeCost: 0.5, maxPositions: 5, settleStrategy: "aware",
253
- });
254
- state.positions.push(makePosition({ symbol: "SOL" }));
255
- // Only .tmp exists (crash before rename completed)
256
- writeFileSync(TMP_FILE, JSON.stringify(state, null, 2), { mode: 0o600 });
257
- const recovered = loadArbState();
258
- expect(recovered).not.toBeNull();
259
- expect(recovered.positions[0].symbol).toBe("SOL");
260
- });
261
- it("loadArbState returns null when both main and .tmp are corrupt", () => {
262
- writeFileSync(TEST_FILE, "corrupt main{{{", { mode: 0o600 });
263
- writeFileSync(TMP_FILE, "corrupt tmp{{{", { mode: 0o600 });
264
- const state = loadArbState();
265
- expect(state).toBeNull();
266
- });
267
- it("createInitialState produces valid structure", () => {
268
- const state = createInitialState({
269
- minSpread: 20,
270
- closeSpread: 5,
271
- size: 200,
272
- holdDays: 10,
273
- bridgeCost: 0.3,
274
- maxPositions: 8,
275
- settleStrategy: "disabled",
276
- });
277
- expect(state.version).toBe(1);
278
- expect(state.positions).toEqual([]);
279
- expect(state.config.minSpread).toBe(20);
280
- expect(state.config.maxPositions).toBe(8);
281
- expect(state.lastStartTime).toBeTruthy();
282
- expect(state.lastScanTime).toBeTruthy();
283
- });
284
- });
@@ -1 +0,0 @@
1
- export {};