@megatao/sdk 1.1.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 (228) hide show
  1. package/.env.example +37 -0
  2. package/CHANGELOG.md +19 -0
  3. package/README.md +199 -0
  4. package/bin/alf +4 -0
  5. package/cli/README.md +198 -0
  6. package/cli/TEST_MANUAL.md +577 -0
  7. package/cli/commands/account.ts +545 -0
  8. package/cli/commands/funding.ts +481 -0
  9. package/cli/commands/liquidation.ts +523 -0
  10. package/cli/commands/market.ts +590 -0
  11. package/cli/commands/orders.ts +395 -0
  12. package/cli/commands/position.ts +1085 -0
  13. package/cli/commands/shared/positionUtils.ts +239 -0
  14. package/cli/commands/trading.ts +483 -0
  15. package/cli/commands/utils.ts +281 -0
  16. package/cli/commands/vault.ts +522 -0
  17. package/cli/index.ts +169 -0
  18. package/cli/interactive.ts +530 -0
  19. package/cli/utils/client.ts +457 -0
  20. package/cli/utils/config.ts +226 -0
  21. package/cli/utils/display.ts +258 -0
  22. package/cli/utils/index.ts +10 -0
  23. package/cli/utils/prompts.ts +364 -0
  24. package/config.example.json +23 -0
  25. package/dist/AlphaFuturesClient.d.ts +36 -0
  26. package/dist/AlphaFuturesClient.d.ts.map +1 -0
  27. package/dist/AlphaFuturesClient.js +116 -0
  28. package/dist/AlphaFuturesClient.js.map +1 -0
  29. package/dist/abi/Alpha.json +5987 -0
  30. package/dist/abi/abis.d.ts +319 -0
  31. package/dist/abi/abis.d.ts.map +1 -0
  32. package/dist/abi/abis.js +128 -0
  33. package/dist/abi/abis.js.map +1 -0
  34. package/dist/abi/index.d.ts +11 -0
  35. package/dist/abi/index.d.ts.map +1 -0
  36. package/dist/abi/index.js +15 -0
  37. package/dist/abi/index.js.map +1 -0
  38. package/dist/config/contracts.config.d.ts +70 -0
  39. package/dist/config/contracts.config.d.ts.map +1 -0
  40. package/dist/config/contracts.config.js +137 -0
  41. package/dist/config/contracts.config.js.map +1 -0
  42. package/dist/config/environments/alpha.config.d.ts +17 -0
  43. package/dist/config/environments/alpha.config.d.ts.map +1 -0
  44. package/dist/config/environments/alpha.config.js +140 -0
  45. package/dist/config/environments/alpha.config.js.map +1 -0
  46. package/dist/config/environments/beta.config.d.ts +16 -0
  47. package/dist/config/environments/beta.config.d.ts.map +1 -0
  48. package/dist/config/environments/beta.config.js +131 -0
  49. package/dist/config/environments/beta.config.js.map +1 -0
  50. package/dist/config/environments/dev.config.d.ts +13 -0
  51. package/dist/config/environments/dev.config.d.ts.map +1 -0
  52. package/dist/config/environments/dev.config.js +123 -0
  53. package/dist/config/environments/dev.config.js.map +1 -0
  54. package/dist/config/environments/index.d.ts +48 -0
  55. package/dist/config/environments/index.d.ts.map +1 -0
  56. package/dist/config/environments/index.js +81 -0
  57. package/dist/config/environments/index.js.map +1 -0
  58. package/dist/config/environments/localhost.config.d.ts +16 -0
  59. package/dist/config/environments/localhost.config.d.ts.map +1 -0
  60. package/dist/config/environments/localhost.config.js +152 -0
  61. package/dist/config/environments/localhost.config.js.map +1 -0
  62. package/dist/config/environments/prod.config.d.ts +20 -0
  63. package/dist/config/environments/prod.config.d.ts.map +1 -0
  64. package/dist/config/environments/prod.config.js +143 -0
  65. package/dist/config/environments/prod.config.js.map +1 -0
  66. package/dist/config/index.d.ts +7 -0
  67. package/dist/config/index.d.ts.map +1 -0
  68. package/dist/config/index.js +41 -0
  69. package/dist/config/index.js.map +1 -0
  70. package/dist/constants/assets.d.ts +76 -0
  71. package/dist/constants/assets.d.ts.map +1 -0
  72. package/dist/constants/assets.js +277 -0
  73. package/dist/constants/assets.js.map +1 -0
  74. package/dist/constants/contracts.d.ts +41 -0
  75. package/dist/constants/contracts.d.ts.map +1 -0
  76. package/dist/constants/contracts.js +57 -0
  77. package/dist/constants/contracts.js.map +1 -0
  78. package/dist/constants/index.d.ts +36 -0
  79. package/dist/constants/index.d.ts.map +1 -0
  80. package/dist/constants/index.js +75 -0
  81. package/dist/constants/index.js.map +1 -0
  82. package/dist/constants/networks.d.ts +32 -0
  83. package/dist/constants/networks.d.ts.map +1 -0
  84. package/dist/constants/networks.js +174 -0
  85. package/dist/constants/networks.js.map +1 -0
  86. package/dist/contracts/index.d.ts +5 -0
  87. package/dist/contracts/index.d.ts.map +1 -0
  88. package/dist/contracts/index.js +21 -0
  89. package/dist/contracts/index.js.map +1 -0
  90. package/dist/contracts/viem/AlphaViem.d.ts +518 -0
  91. package/dist/contracts/viem/AlphaViem.d.ts.map +1 -0
  92. package/dist/contracts/viem/AlphaViem.js +1287 -0
  93. package/dist/contracts/viem/AlphaViem.js.map +1 -0
  94. package/dist/contracts/viem/PriceOracleViem.d.ts +71 -0
  95. package/dist/contracts/viem/PriceOracleViem.d.ts.map +1 -0
  96. package/dist/contracts/viem/PriceOracleViem.js +212 -0
  97. package/dist/contracts/viem/PriceOracleViem.js.map +1 -0
  98. package/dist/contracts/viem/index.d.ts +9 -0
  99. package/dist/contracts/viem/index.d.ts.map +1 -0
  100. package/dist/contracts/viem/index.js +17 -0
  101. package/dist/contracts/viem/index.js.map +1 -0
  102. package/dist/errors/index.d.ts +44 -0
  103. package/dist/errors/index.d.ts.map +1 -0
  104. package/dist/errors/index.js +83 -0
  105. package/dist/errors/index.js.map +1 -0
  106. package/dist/index.d.ts +19 -0
  107. package/dist/index.d.ts.map +1 -0
  108. package/dist/index.js +60 -0
  109. package/dist/index.js.map +1 -0
  110. package/dist/types/alpha.d.ts +299 -0
  111. package/dist/types/alpha.d.ts.map +1 -0
  112. package/dist/types/alpha.js +6 -0
  113. package/dist/types/alpha.js.map +1 -0
  114. package/dist/types/client.d.ts +24 -0
  115. package/dist/types/client.d.ts.map +1 -0
  116. package/dist/types/client.js +13 -0
  117. package/dist/types/client.js.map +1 -0
  118. package/dist/types/contracts.d.ts +48 -0
  119. package/dist/types/contracts.d.ts.map +1 -0
  120. package/dist/types/contracts.js +6 -0
  121. package/dist/types/contracts.js.map +1 -0
  122. package/dist/types/funding.d.ts +27 -0
  123. package/dist/types/funding.d.ts.map +1 -0
  124. package/dist/types/funding.js +6 -0
  125. package/dist/types/funding.js.map +1 -0
  126. package/dist/types/index.d.ts +92 -0
  127. package/dist/types/index.d.ts.map +1 -0
  128. package/dist/types/index.js +47 -0
  129. package/dist/types/index.js.map +1 -0
  130. package/dist/types/liquidation.d.ts +20 -0
  131. package/dist/types/liquidation.d.ts.map +1 -0
  132. package/dist/types/liquidation.js +6 -0
  133. package/dist/types/liquidation.js.map +1 -0
  134. package/dist/types/margin.d.ts +29 -0
  135. package/dist/types/margin.d.ts.map +1 -0
  136. package/dist/types/margin.js +6 -0
  137. package/dist/types/margin.js.map +1 -0
  138. package/dist/types/oracle.d.ts +21 -0
  139. package/dist/types/oracle.d.ts.map +1 -0
  140. package/dist/types/oracle.js +6 -0
  141. package/dist/types/oracle.js.map +1 -0
  142. package/dist/types/positions.d.ts +43 -0
  143. package/dist/types/positions.d.ts.map +1 -0
  144. package/dist/types/positions.js +13 -0
  145. package/dist/types/positions.js.map +1 -0
  146. package/dist/utils/calculations.d.ts +84 -0
  147. package/dist/utils/calculations.d.ts.map +1 -0
  148. package/dist/utils/calculations.js +155 -0
  149. package/dist/utils/calculations.js.map +1 -0
  150. package/dist/utils/errors.d.ts +24 -0
  151. package/dist/utils/errors.d.ts.map +1 -0
  152. package/dist/utils/errors.js +129 -0
  153. package/dist/utils/errors.js.map +1 -0
  154. package/dist/utils/events.d.ts +40 -0
  155. package/dist/utils/events.d.ts.map +1 -0
  156. package/dist/utils/events.js +73 -0
  157. package/dist/utils/events.js.map +1 -0
  158. package/dist/utils/format.d.ts +40 -0
  159. package/dist/utils/format.d.ts.map +1 -0
  160. package/dist/utils/format.js +86 -0
  161. package/dist/utils/format.js.map +1 -0
  162. package/dist/utils/index.d.ts +10 -0
  163. package/dist/utils/index.d.ts.map +1 -0
  164. package/dist/utils/index.js +26 -0
  165. package/dist/utils/index.js.map +1 -0
  166. package/dist/utils/network.d.ts +52 -0
  167. package/dist/utils/network.d.ts.map +1 -0
  168. package/dist/utils/network.js +192 -0
  169. package/dist/utils/network.js.map +1 -0
  170. package/dist/utils/positionCalculations.d.ts +145 -0
  171. package/dist/utils/positionCalculations.d.ts.map +1 -0
  172. package/dist/utils/positionCalculations.js +278 -0
  173. package/dist/utils/positionCalculations.js.map +1 -0
  174. package/dist/utils/validation.d.ts +28 -0
  175. package/dist/utils/validation.d.ts.map +1 -0
  176. package/dist/utils/validation.js +68 -0
  177. package/dist/utils/validation.js.map +1 -0
  178. package/docs/README.md +40 -0
  179. package/docs/api/API.md +831 -0
  180. package/docs/guides/GETTING_STARTED.md +316 -0
  181. package/docs/guides/TRADING_GUIDE.md +677 -0
  182. package/docs/integration/INTEGRATION_GUIDE.md +1679 -0
  183. package/docs/integration/VIEM_INTEGRATION.md +294 -0
  184. package/docs/reference/CLI_QUICK_REFERENCE.md +197 -0
  185. package/docs/reference/TROUBLESHOOTING.md +922 -0
  186. package/package.json +113 -0
  187. package/src/AlphaFuturesClient.ts +158 -0
  188. package/src/abi/.gitkeep +1 -0
  189. package/src/abi/Alpha.json +5987 -0
  190. package/src/abi/README.md +99 -0
  191. package/src/abi/abis.ts +131 -0
  192. package/src/abi/index.ts +13 -0
  193. package/src/config/contracts.config.ts +186 -0
  194. package/src/config/environments/alpha.config.ts +139 -0
  195. package/src/config/environments/beta.config.ts +130 -0
  196. package/src/config/environments/dev.config.ts +122 -0
  197. package/src/config/environments/index.ts +87 -0
  198. package/src/config/environments/localhost.config.ts +153 -0
  199. package/src/config/environments/prod.config.ts +142 -0
  200. package/src/config/index.ts +29 -0
  201. package/src/constants/assets.ts +299 -0
  202. package/src/constants/contracts.ts +64 -0
  203. package/src/constants/index.ts +69 -0
  204. package/src/constants/networks.ts +182 -0
  205. package/src/contracts/index.ts +5 -0
  206. package/src/contracts/viem/AlphaViem.ts +1615 -0
  207. package/src/contracts/viem/PriceOracleViem.ts +272 -0
  208. package/src/contracts/viem/index.ts +11 -0
  209. package/src/errors/index.ts +87 -0
  210. package/src/index.ts +59 -0
  211. package/src/types/VIEM_TYPES_README.md +70 -0
  212. package/src/types/alpha.ts +358 -0
  213. package/src/types/client.ts +27 -0
  214. package/src/types/contracts.ts +74 -0
  215. package/src/types/funding.ts +31 -0
  216. package/src/types/index.ts +108 -0
  217. package/src/types/liquidation.ts +23 -0
  218. package/src/types/margin.ts +34 -0
  219. package/src/types/oracle.ts +24 -0
  220. package/src/types/positions.ts +48 -0
  221. package/src/utils/calculations.ts +175 -0
  222. package/src/utils/errors.ts +147 -0
  223. package/src/utils/events.ts +98 -0
  224. package/src/utils/format.ts +84 -0
  225. package/src/utils/index.ts +10 -0
  226. package/src/utils/network.ts +212 -0
  227. package/src/utils/positionCalculations.ts +317 -0
  228. package/src/utils/validation.ts +76 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,qBAAqB;AACrB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,wBAAwB;AACxB,yCAA8D;AAArD,iGAAA,SAAS,OAAA;AAAE,uGAAA,eAAe,OAAA;AAEnC,cAAc;AACd,6CAA2B;AAE3B,eAAe;AACf,0CAAwB;AAExB,gBAAgB;AAChB,2CAAyB;AAEzB,mBAAmB;AACnB,iDAA+B;AAC/B,qDAAmC;AACnC,iDAA+B;AAC/B,+DAA6C;AAE7C,mBAAmB;AACnB,8CAA4B;AAE5B,uBAAuB;AACvB,8DAKmC;AAFjC,mHAAA,eAAe,OAAA;AAGjB,wDAAsC;AAEtC,2BAA2B;AAC3B,6BAiBc;AAXZ,kGAAA,UAAU,OAAA;AACV,mGAAA,WAAW,OAAA;AACX,kGAAA,UAAU,OAAA;AACV,mGAAA,WAAW,OAAA;AACX,mGAAA,WAAW,OAAA;AACX,0GAAA,kBAAkB,OAAA;AAClB,0GAAA,kBAAkB,OAAA;AAClB,4FAAA,IAAI,OAAA;AACJ,8FAAA,MAAM,OAAA;AAKR,sCAA+C;AAAtC,iGAAA,OAAO,OAAA;AAAE,iGAAA,OAAO,OAAA"}
@@ -0,0 +1,299 @@
1
+ /**
2
+ * Type definitions for AlphaFuturesMonolith contract
3
+ */
4
+ import { Address } from 'viem';
5
+ export interface MonolithPosition {
6
+ notionalValue: bigint;
7
+ margin: bigint;
8
+ entryPrice: bigint;
9
+ isLong: boolean;
10
+ lastUpdated: bigint;
11
+ fundingIndex: bigint;
12
+ leverage: bigint;
13
+ liquidationPrice: bigint;
14
+ }
15
+ export interface MonolithOrder {
16
+ trader: Address;
17
+ notionalValue: bigint;
18
+ price: bigint;
19
+ isBuy: boolean;
20
+ margin: bigint;
21
+ timestamp: bigint;
22
+ leverage: bigint;
23
+ }
24
+ export interface MonolithMarket {
25
+ isActive: boolean;
26
+ maxLeverage: bigint;
27
+ maintenanceMargin: bigint;
28
+ liquidationFee: bigint;
29
+ lastFundingUpdate: bigint;
30
+ fundingIndex: bigint;
31
+ fundingRate: bigint;
32
+ longOpenInterest: bigint;
33
+ shortOpenInterest: bigint;
34
+ }
35
+ export interface OrderBook {
36
+ bestBid: `0x${string}`;
37
+ bestAsk: `0x${string}`;
38
+ }
39
+ export interface DepthLevel {
40
+ price: bigint;
41
+ notionalValue: bigint;
42
+ orderCount: bigint;
43
+ }
44
+ export interface VWAPResult {
45
+ vwap: bigint;
46
+ slippage: bigint;
47
+ totalNotional: bigint;
48
+ priceImpact: bigint;
49
+ }
50
+ export interface SpreadInfo {
51
+ bidPrice: bigint;
52
+ askPrice: bigint;
53
+ spread: bigint;
54
+ spreadPercent: bigint;
55
+ }
56
+ export interface OrderDetails {
57
+ trader: Address;
58
+ isLong: boolean;
59
+ notionalValue: bigint;
60
+ price: bigint;
61
+ reduceOnly: boolean;
62
+ next: Bytes16;
63
+ prev: Bytes16;
64
+ }
65
+ /**
66
+ * Position details returned by getPositionDetails
67
+ * Matches contract struct IAlphaStorage.PositionDetails
68
+ */
69
+ export interface PositionDetails {
70
+ owner: Address;
71
+ market: Address;
72
+ isLong: boolean;
73
+ notionalValue: bigint;
74
+ margin: bigint;
75
+ entryPrice: bigint;
76
+ markPrice: bigint;
77
+ pricePnl: bigint;
78
+ fundingPayment: bigint;
79
+ interestPayment: bigint;
80
+ marginRatio: bigint;
81
+ liquidationPrice: bigint;
82
+ liquidatable: boolean;
83
+ }
84
+ /**
85
+ * Parameters for opening a market position
86
+ * UPDATED: Changed from asset-quantity model to collateral-based model
87
+ * - Previously: Specified token quantity (size) to trade
88
+ * - Now: Specify collateral amount (margin) to risk with leverage
89
+ */
90
+ export interface MarketPositionParams {
91
+ market: Address;
92
+ isLong: boolean;
93
+ margin: bigint;
94
+ leverage: bigint;
95
+ maxSlippage: bigint;
96
+ }
97
+ export interface LimitOrderParams {
98
+ market: Address;
99
+ isBuy: boolean;
100
+ margin: bigint;
101
+ leverage: bigint;
102
+ price: bigint;
103
+ reduceOnlyType: number;
104
+ }
105
+ export interface VaultState {
106
+ totalReserves: bigint;
107
+ availableReserves: bigint;
108
+ totalExposure: bigint;
109
+ unrealizedPnl: bigint;
110
+ }
111
+ export interface FundingState {
112
+ fundingRate: bigint;
113
+ fundingIndex: bigint;
114
+ lastUpdateTime: bigint;
115
+ nextFundingTime: bigint;
116
+ }
117
+ export interface ExecutionPlan {
118
+ orderbookSize: bigint;
119
+ vaultSize: bigint;
120
+ totalSize: bigint;
121
+ expectedSlippage: bigint;
122
+ effectivePrice: bigint;
123
+ feasible: boolean;
124
+ }
125
+ export interface ExecutionStrategyAnalysis {
126
+ orderbookLiquidity: bigint;
127
+ vaultCapacity: bigint;
128
+ orderbookSlippage: bigint;
129
+ vaultSlippage: bigint;
130
+ hybridSlippage: bigint;
131
+ recommendedSplit: bigint;
132
+ recommendedStrategy: number;
133
+ }
134
+ export interface MarketLiquidityAnalysis {
135
+ totalBidLiquidity: bigint;
136
+ totalAskLiquidity: bigint;
137
+ bidDepth: bigint;
138
+ askDepth: bigint;
139
+ spreadPercent: bigint;
140
+ marketScore: bigint;
141
+ }
142
+ export interface SlippageBreakdown {
143
+ baseSlippage: bigint;
144
+ sizeImpact: bigint;
145
+ marketDepthFactor: bigint;
146
+ exposureEffect: bigint;
147
+ volatilityAdjustment: bigint;
148
+ totalSlippage: bigint;
149
+ }
150
+ export interface MarginDepositedEvent {
151
+ trader: Address;
152
+ amount: bigint;
153
+ }
154
+ export interface PositionOpenedEvent {
155
+ positionId: `0x${string}`;
156
+ trader: Address;
157
+ market: Address;
158
+ isLong: boolean;
159
+ notionalValue: bigint;
160
+ margin: bigint;
161
+ }
162
+ export interface PositionClosedEvent {
163
+ positionId: `0x${string}`;
164
+ trader: Address;
165
+ pnl: bigint;
166
+ }
167
+ export interface OrderPlacedEvent {
168
+ orderId: `0x${string}`;
169
+ trader: Address;
170
+ market: Address;
171
+ isBuy: boolean;
172
+ notionalValue: bigint;
173
+ price: bigint;
174
+ }
175
+ export interface HybridOrderExecutedEvent {
176
+ trader: Address;
177
+ market: Address;
178
+ orderbookFilled: bigint;
179
+ vaultFilled: bigint;
180
+ avgPrice: bigint;
181
+ }
182
+ export type Bytes16 = `0x${string}`;
183
+ export type Bytes32 = `0x${string}`;
184
+ export interface MonolithConfig {
185
+ precision: bigint;
186
+ basisPoints: bigint;
187
+ maxLeverage: bigint;
188
+ defaultLeverage: bigint;
189
+ minPositionSize: bigint;
190
+ liquidationThreshold: bigint;
191
+ partialLiquidationThreshold: bigint;
192
+ liquidationFee: bigint;
193
+ fundingInterval: bigint;
194
+ maxFundingRate: bigint;
195
+ maxExposurePerAsset: bigint;
196
+ maxTotalUtilization: bigint;
197
+ criticalUtilizationBps: bigint;
198
+ maxLossRateBps: bigint;
199
+ maxLiquidationsPerBlock: bigint;
200
+ }
201
+ export interface MarketInfo {
202
+ isActive: boolean;
203
+ maxLeverage: bigint;
204
+ maintenanceMargin: bigint;
205
+ liquidationFee: bigint;
206
+ longOpenInterest: bigint;
207
+ shortOpenInterest: bigint;
208
+ fundingRate: bigint;
209
+ lastFundingUpdate: bigint;
210
+ }
211
+ export interface MarginInfo {
212
+ balance: bigint;
213
+ locked: bigint;
214
+ available: bigint;
215
+ }
216
+ export interface AccountSummary {
217
+ depositedBalance: bigint;
218
+ accountEquity: bigint;
219
+ unrealizedPnl: bigint;
220
+ lockedMargin: bigint;
221
+ availableMargin: bigint;
222
+ }
223
+ export interface PositionSummary {
224
+ totalPositions: bigint;
225
+ totalMargin: bigint;
226
+ totalUnrealizedPnl: bigint;
227
+ totalSize: bigint;
228
+ }
229
+ export interface VaultStats {
230
+ totalReserves: bigint;
231
+ availableReserves: bigint;
232
+ totalExposure: bigint;
233
+ unrealizedPnl: bigint;
234
+ }
235
+ export interface VaultExposure {
236
+ longExposure: bigint;
237
+ shortExposure: bigint;
238
+ netExposure: bigint;
239
+ utilizationRate: bigint;
240
+ }
241
+ export interface LiquidationStatus {
242
+ isLiquidatable: boolean;
243
+ marginRatio: bigint;
244
+ requiredMargin: bigint;
245
+ liquidationPrice: bigint;
246
+ }
247
+ export interface MarketStatistics {
248
+ totalOrders: bigint;
249
+ bidOrders: bigint;
250
+ askOrders: bigint;
251
+ averageOrderSize: bigint;
252
+ medianBidPrice: bigint;
253
+ medianAskPrice: bigint;
254
+ }
255
+ export interface ExecutionMetrics {
256
+ orderbookFilled: bigint;
257
+ vaultFilled: bigint;
258
+ avgPrice: bigint;
259
+ slippage: bigint;
260
+ }
261
+ export interface MarketLiquidationStats {
262
+ totalLiquidations: bigint;
263
+ totalLiquidationValue: bigint;
264
+ liquidationsLast24h: bigint;
265
+ }
266
+ export interface BadDebtInfo {
267
+ totalCovered: bigint;
268
+ eventCount: bigint;
269
+ }
270
+ export interface VaultFundingStats {
271
+ collected: bigint;
272
+ paid: bigint;
273
+ net: bigint;
274
+ }
275
+ export interface VaultFundingInfo {
276
+ fundingBalance: bigint;
277
+ vaultIndex: bigint;
278
+ }
279
+ export interface LiquidationCascadeRisk {
280
+ shouldTrigger: boolean;
281
+ severity: number;
282
+ }
283
+ export interface TopKeeperInfo {
284
+ keepers: Address[];
285
+ liquidationCounts: bigint[];
286
+ rewards: bigint[];
287
+ }
288
+ export interface CumulativeDepthResult {
289
+ prices: bigint[];
290
+ cumulativeSizes: bigint[];
291
+ totalDepth: bigint;
292
+ }
293
+ export interface MarketImpactEstimate {
294
+ averagePrice: bigint;
295
+ worstPrice: bigint;
296
+ priceImpact: bigint;
297
+ filledFromOrderbook: bigint;
298
+ }
299
+ //# sourceMappingURL=alpha.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"alpha.d.ts","sourceRoot":"","sources":["../../src/types/alpha.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Type definitions for AlphaFuturesMonolith contract
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=alpha.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"alpha.js","sourceRoot":"","sources":["../../src/types/alpha.ts"],"names":[],"mappings":";AAAA;;GAEG"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Client-related type definitions
3
+ */
4
+ import { PublicClient, WalletClient, Chain } from 'viem';
5
+ export interface AlphaFuturesConfig {
6
+ publicClient?: PublicClient;
7
+ walletClient?: WalletClient;
8
+ rpcUrl?: string;
9
+ privateKey?: string;
10
+ network?: 'mainnet' | 'testnet' | 'localhost';
11
+ customContracts?: ContractAddresses;
12
+ chain?: Chain;
13
+ }
14
+ export interface ContractAddresses {
15
+ alpha: string;
16
+ priceOracle: string;
17
+ collateralToken: string;
18
+ }
19
+ export declare enum Network {
20
+ MAINNET = "mainnet",
21
+ TESTNET = "testnet",
22
+ LOCALHOST = "localhost"
23
+ }
24
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC9C,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,oBAAY,OAAO;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB"}
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+ /**
3
+ * Client-related type definitions
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.Network = void 0;
7
+ var Network;
8
+ (function (Network) {
9
+ Network["MAINNET"] = "mainnet";
10
+ Network["TESTNET"] = "testnet";
11
+ Network["LOCALHOST"] = "localhost";
12
+ })(Network || (exports.Network = Network = {}));
13
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAoBH,IAAY,OAIX;AAJD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,8BAAmB,CAAA;IACnB,kCAAuB,CAAA;AACzB,CAAC,EAJW,OAAO,uBAAP,OAAO,QAIlB"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Contract interface type definitions
3
+ */
4
+ import { Hash, Address } from 'viem';
5
+ import { TransactionOptions } from './index';
6
+ export interface BaseContract {
7
+ address: Address;
8
+ }
9
+ export interface IMarginAccount extends BaseContract {
10
+ deposit(amount: bigint, options?: TransactionOptions): Promise<Hash>;
11
+ withdraw(amount: bigint, options?: TransactionOptions): Promise<Hash>;
12
+ getBalance(user: Address): Promise<bigint>;
13
+ getAvailableBalance(user: Address): Promise<bigint>;
14
+ getLockedMargin(user: Address): Promise<bigint>;
15
+ }
16
+ export interface IPositionManager extends BaseContract {
17
+ openMarketPosition(asset: Address, isLong: boolean, margin: bigint, // Collateral to risk, not asset size
18
+ leverage: bigint, // 1e18 format (e.g., 3e18 for 3x)
19
+ maxSlippage: bigint, // Max slippage in basis points (e.g., 100 = 1%)
20
+ options?: TransactionOptions): Promise<Hash>;
21
+ closePosition(positionId: bigint, notionalValue: bigint, options?: TransactionOptions): Promise<Hash>;
22
+ getPosition(positionId: bigint): Promise<any>;
23
+ getUserPositions(user: Address): Promise<bigint[]>;
24
+ getActivePositions(asset: Address): Promise<bigint[]>;
25
+ }
26
+ export interface IFundingRate extends BaseContract {
27
+ updateFundingRate(asset: Address, options?: TransactionOptions): Promise<Hash>;
28
+ getCurrentFundingRate(asset: Address): Promise<bigint>;
29
+ getFundingIndex(asset: Address): Promise<bigint>;
30
+ getNextFundingTime(asset: Address): Promise<bigint>;
31
+ }
32
+ export interface ILiquidationEngine extends BaseContract {
33
+ liquidatePosition(positionId: bigint, options?: TransactionOptions): Promise<Hash>;
34
+ isLiquidatable(positionId: bigint): Promise<boolean>;
35
+ getLiquidationPrice(positionId: bigint): Promise<bigint>;
36
+ }
37
+ export interface IProtocolVault extends BaseContract {
38
+ getTotalReserves(): Promise<bigint>;
39
+ getInsuranceFund(): Promise<bigint>;
40
+ getUnmatchedLongs(asset: Address): Promise<bigint>;
41
+ getUnmatchedShorts(asset: Address): Promise<bigint>;
42
+ }
43
+ export interface IPriceOracle extends BaseContract {
44
+ getPrice(asset: Address): Promise<bigint>;
45
+ updatePrice(asset: Address, price: bigint, options?: TransactionOptions): Promise<Hash>;
46
+ getLatestPriceData(asset: Address): Promise<[bigint, bigint]>;
47
+ }
48
+ //# sourceMappingURL=contracts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/types/contracts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Contract interface type definitions
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=contracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/types/contracts.ts"],"names":[],"mappings":";AAAA;;GAEG"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Funding rate related type definitions
3
+ */
4
+ import { Address } from 'viem';
5
+ export interface FundingRate {
6
+ rate: bigint;
7
+ timestamp: bigint;
8
+ longOpenInterest: bigint;
9
+ shortOpenInterest: bigint;
10
+ }
11
+ export interface FundingPayment {
12
+ positionId: bigint;
13
+ payment: bigint;
14
+ timestamp: bigint;
15
+ }
16
+ export interface FundingRateConfig {
17
+ baseRate: bigint;
18
+ maxRate: bigint;
19
+ fundingInterval: bigint;
20
+ skewScale: bigint;
21
+ }
22
+ export interface FundingIndex {
23
+ asset: Address;
24
+ index: bigint;
25
+ timestamp: bigint;
26
+ }
27
+ //# sourceMappingURL=funding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"funding.d.ts","sourceRoot":"","sources":["../../src/types/funding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Funding rate related type definitions
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=funding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"funding.js","sourceRoot":"","sources":["../../src/types/funding.ts"],"names":[],"mappings":";AAAA;;GAEG"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Type definitions for Alpha Futures SDK
3
+ */
4
+ import { Address } from 'viem';
5
+ export * from './client';
6
+ export * from './contracts';
7
+ export * from './positions';
8
+ export * from './margin';
9
+ export * from './funding';
10
+ export * from './liquidation';
11
+ export * from './oracle';
12
+ export interface TransactionOptions {
13
+ gas?: bigint;
14
+ gasPrice?: bigint;
15
+ maxFeePerGas?: bigint;
16
+ maxPriorityFeePerGas?: bigint;
17
+ nonce?: number;
18
+ value?: bigint;
19
+ waitForConfirmation?: boolean;
20
+ }
21
+ export interface CallOptions {
22
+ blockTag?: 'latest' | 'earliest' | 'pending' | 'safe' | 'finalized';
23
+ blockNumber?: bigint;
24
+ }
25
+ export interface EventFilter {
26
+ fromBlock?: bigint | 'latest' | 'earliest' | 'pending';
27
+ toBlock?: bigint | 'latest' | 'earliest' | 'pending';
28
+ address?: Address | Address[];
29
+ topics?: string[];
30
+ }
31
+ /**
32
+ * Subnet market configuration for Alpha Futures protocol
33
+ */
34
+ export interface SubnetMarket {
35
+ /** Subnet ID on the Bittensor network */
36
+ id: number;
37
+ /** Human-readable name of the subnet */
38
+ name: string;
39
+ /** Market contract address for this subnet */
40
+ marketAddress: `0x${string}`;
41
+ /** Whether oracle pricing is available */
42
+ hasOraclePrice: boolean;
43
+ /** Symbol used for trading */
44
+ symbol: string;
45
+ /** Full name for display */
46
+ displayName: string;
47
+ }
48
+ export interface NetworkConfig {
49
+ chainId: number;
50
+ name: string;
51
+ rpcUrl?: string;
52
+ contracts: {
53
+ alpha: Address;
54
+ priceOracle: Address;
55
+ collateralToken: Address;
56
+ };
57
+ markets?: SubnetMarket[];
58
+ collateralTokenInfo?: {
59
+ symbol: string;
60
+ decimals: number;
61
+ name: string;
62
+ };
63
+ blockExplorer?: string;
64
+ }
65
+ export interface ClientConfig {
66
+ rpcUrl?: string;
67
+ privateKey?: string;
68
+ network?: string;
69
+ networkConfig?: NetworkConfig;
70
+ }
71
+ export declare const SubnetMarkets: {
72
+ readonly BITMIND: Address;
73
+ readonly CHUTES: Address;
74
+ readonly AFFINE: Address;
75
+ readonly RIDGES: Address;
76
+ };
77
+ export declare const AlphaToken: {
78
+ readonly ALPHA_BTC: Address;
79
+ readonly ALPHA_ETH: Address;
80
+ readonly ALPHA_SOL: Address;
81
+ readonly BITMIND: `0x${string}`;
82
+ readonly CHUTES: `0x${string}`;
83
+ readonly AFFINE: `0x${string}`;
84
+ readonly RIDGES: `0x${string}`;
85
+ };
86
+ export interface AlphaTokenInfo {
87
+ symbol: string;
88
+ address: Address;
89
+ decimals: number;
90
+ name: string;
91
+ }
92
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AAGzB,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,aAAa,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;IACxB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAGD,eAAO,MAAM,aAAa;sBACiC,OAAO;qBACR,OAAO;qBACP,OAAO;qBACN,OAAO;CACxD,CAAC;AAGX,eAAO,MAAM,UAAU;wBACsC,OAAO;wBACP,OAAO;wBACP,OAAO;;;;;CAM1D,CAAC;AAGX,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}
@@ -0,0 +1,47 @@
1
+ "use strict";
2
+ /**
3
+ * Type definitions for Alpha Futures SDK
4
+ */
5
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ var desc = Object.getOwnPropertyDescriptor(m, k);
8
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
+ desc = { enumerable: true, get: function() { return m[k]; } };
10
+ }
11
+ Object.defineProperty(o, k2, desc);
12
+ }) : (function(o, m, k, k2) {
13
+ if (k2 === undefined) k2 = k;
14
+ o[k2] = m[k];
15
+ }));
16
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
17
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
18
+ };
19
+ Object.defineProperty(exports, "__esModule", { value: true });
20
+ exports.AlphaToken = exports.SubnetMarkets = void 0;
21
+ // Re-export all types
22
+ __exportStar(require("./client"), exports);
23
+ __exportStar(require("./contracts"), exports);
24
+ __exportStar(require("./positions"), exports);
25
+ __exportStar(require("./margin"), exports);
26
+ __exportStar(require("./funding"), exports);
27
+ __exportStar(require("./liquidation"), exports);
28
+ __exportStar(require("./oracle"), exports);
29
+ // Subnet market constants for trading (replaces legacy Alpha Token constants)
30
+ exports.SubnetMarkets = {
31
+ BITMIND: '0x0000000000000000000000000000000000000022',
32
+ CHUTES: '0x0000000000000000000000000000000000000040',
33
+ AFFINE: '0x0000000000000000000000000000000000000078',
34
+ RIDGES: '0x0000000000000000000000000000000000000003E',
35
+ };
36
+ // Legacy Alpha Token constants for backward compatibility
37
+ exports.AlphaToken = {
38
+ ALPHA_BTC: '0x0000000000000000000000000000000000000001',
39
+ ALPHA_ETH: '0x0000000000000000000000000000000000000003',
40
+ ALPHA_SOL: '0x0000000000000000000000000000000000000004',
41
+ // New subnet markets
42
+ BITMIND: exports.SubnetMarkets.BITMIND,
43
+ CHUTES: exports.SubnetMarkets.CHUTES,
44
+ AFFINE: exports.SubnetMarkets.AFFINE,
45
+ RIDGES: exports.SubnetMarkets.RIDGES,
46
+ };
47
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAIH,sBAAsB;AACtB,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,2CAAyB;AAoEzB,8EAA8E;AACjE,QAAA,aAAa,GAAG;IAC3B,OAAO,EAAE,4CAAuD;IAChE,MAAM,EAAE,4CAAuD;IAC/D,MAAM,EAAE,4CAAuD;IAC/D,MAAM,EAAE,6CAAwD;CACxD,CAAC;AAEX,0DAA0D;AAC7C,QAAA,UAAU,GAAG;IACxB,SAAS,EAAE,4CAAuD;IAClE,SAAS,EAAE,4CAAuD;IAClE,SAAS,EAAE,4CAAuD;IAClE,qBAAqB;IACrB,OAAO,EAAE,qBAAa,CAAC,OAAO;IAC9B,MAAM,EAAE,qBAAa,CAAC,MAAM;IAC5B,MAAM,EAAE,qBAAa,CAAC,MAAM;IAC5B,MAAM,EAAE,qBAAa,CAAC,MAAM;CACpB,CAAC"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Liquidation-related type definitions
3
+ */
4
+ import { Address } from 'viem';
5
+ export interface LiquidationParams {
6
+ positionId: bigint;
7
+ }
8
+ export interface LiquidationResult {
9
+ positionId: bigint;
10
+ liquidator: Address;
11
+ remainingMargin: bigint;
12
+ liquidationBonus: bigint;
13
+ timestamp: bigint;
14
+ }
15
+ export interface LiquidationConfig {
16
+ maintenanceMarginRatio: bigint;
17
+ liquidationBonus: bigint;
18
+ insuranceFundRatio: bigint;
19
+ }
20
+ //# sourceMappingURL=liquidation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../src/types/liquidation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Liquidation-related type definitions
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=liquidation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liquidation.js","sourceRoot":"","sources":["../../src/types/liquidation.ts"],"names":[],"mappings":";AAAA;;GAEG"}