@lifi/perps-sdk-provider-ondo 0.0.0-preview-7ff840c

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 (280) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +38 -0
  3. package/dist/cjs/OndoProvider.d.ts +8 -0
  4. package/dist/cjs/OndoProvider.d.ts.map +1 -0
  5. package/dist/cjs/OndoProvider.js +338 -0
  6. package/dist/cjs/OndoProvider.js.map +1 -0
  7. package/dist/cjs/accountConfig.d.ts +3 -0
  8. package/dist/cjs/accountConfig.d.ts.map +1 -0
  9. package/dist/cjs/accountConfig.js +59 -0
  10. package/dist/cjs/accountConfig.js.map +1 -0
  11. package/dist/cjs/accountSummary.d.ts +3 -0
  12. package/dist/cjs/accountSummary.d.ts.map +1 -0
  13. package/dist/cjs/accountSummary.js +8 -0
  14. package/dist/cjs/accountSummary.js.map +1 -0
  15. package/dist/cjs/auth/OndoTokenStore.d.ts +13 -0
  16. package/dist/cjs/auth/OndoTokenStore.d.ts.map +1 -0
  17. package/dist/cjs/auth/OndoTokenStore.js +53 -0
  18. package/dist/cjs/auth/OndoTokenStore.js.map +1 -0
  19. package/dist/cjs/auth/completeSiweLogin.d.ts +13 -0
  20. package/dist/cjs/auth/completeSiweLogin.d.ts.map +1 -0
  21. package/dist/cjs/auth/completeSiweLogin.js +15 -0
  22. package/dist/cjs/auth/completeSiweLogin.js.map +1 -0
  23. package/dist/cjs/auth/index.d.ts +4 -0
  24. package/dist/cjs/auth/index.d.ts.map +1 -0
  25. package/dist/cjs/auth/index.js +11 -0
  26. package/dist/cjs/auth/index.js.map +1 -0
  27. package/dist/cjs/auth/signActions.d.ts +13 -0
  28. package/dist/cjs/auth/signActions.d.ts.map +1 -0
  29. package/dist/cjs/auth/signActions.js +86 -0
  30. package/dist/cjs/auth/signActions.js.map +1 -0
  31. package/dist/cjs/constants.d.ts +9 -0
  32. package/dist/cjs/constants.d.ts.map +1 -0
  33. package/dist/cjs/constants.js +12 -0
  34. package/dist/cjs/constants.js.map +1 -0
  35. package/dist/cjs/index.d.ts +9 -0
  36. package/dist/cjs/index.d.ts.map +1 -0
  37. package/dist/cjs/index.js +37 -0
  38. package/dist/cjs/index.js.map +1 -0
  39. package/dist/cjs/package.json +1 -0
  40. package/dist/cjs/types/auth.d.ts +16 -0
  41. package/dist/cjs/types/auth.d.ts.map +1 -0
  42. package/dist/cjs/types/auth.js +3 -0
  43. package/dist/cjs/types/auth.js.map +1 -0
  44. package/dist/cjs/types/index.d.ts +4 -0
  45. package/dist/cjs/types/index.d.ts.map +1 -0
  46. package/dist/cjs/types/index.js +3 -0
  47. package/dist/cjs/types/index.js.map +1 -0
  48. package/dist/cjs/types/wire.d.ts +154 -0
  49. package/dist/cjs/types/wire.d.ts.map +1 -0
  50. package/dist/cjs/types/wire.js +3 -0
  51. package/dist/cjs/types/wire.js.map +1 -0
  52. package/dist/cjs/types/ws.d.ts +92 -0
  53. package/dist/cjs/types/ws.d.ts.map +1 -0
  54. package/dist/cjs/types/ws.js +3 -0
  55. package/dist/cjs/types/ws.js.map +1 -0
  56. package/dist/cjs/utils/activityCursor.d.ts +9 -0
  57. package/dist/cjs/utils/activityCursor.d.ts.map +1 -0
  58. package/dist/cjs/utils/activityCursor.js +79 -0
  59. package/dist/cjs/utils/activityCursor.js.map +1 -0
  60. package/dist/cjs/utils/apiClient.d.ts +43 -0
  61. package/dist/cjs/utils/apiClient.d.ts.map +1 -0
  62. package/dist/cjs/utils/apiClient.js +134 -0
  63. package/dist/cjs/utils/apiClient.js.map +1 -0
  64. package/dist/cjs/utils/index.d.ts +11 -0
  65. package/dist/cjs/utils/index.d.ts.map +1 -0
  66. package/dist/cjs/utils/index.js +39 -0
  67. package/dist/cjs/utils/index.js.map +1 -0
  68. package/dist/cjs/utils/liquidation.d.ts +4 -0
  69. package/dist/cjs/utils/liquidation.d.ts.map +1 -0
  70. package/dist/cjs/utils/liquidation.js +16 -0
  71. package/dist/cjs/utils/liquidation.js.map +1 -0
  72. package/dist/cjs/utils/mapActivity.d.ts +5 -0
  73. package/dist/cjs/utils/mapActivity.d.ts.map +1 -0
  74. package/dist/cjs/utils/mapActivity.js +34 -0
  75. package/dist/cjs/utils/mapActivity.js.map +1 -0
  76. package/dist/cjs/utils/mapFill.d.ts +4 -0
  77. package/dist/cjs/utils/mapFill.d.ts.map +1 -0
  78. package/dist/cjs/utils/mapFill.js +36 -0
  79. package/dist/cjs/utils/mapFill.js.map +1 -0
  80. package/dist/cjs/utils/mapOrder.d.ts +16 -0
  81. package/dist/cjs/utils/mapOrder.d.ts.map +1 -0
  82. package/dist/cjs/utils/mapOrder.js +135 -0
  83. package/dist/cjs/utils/mapOrder.js.map +1 -0
  84. package/dist/cjs/utils/mapPosition.d.ts +5 -0
  85. package/dist/cjs/utils/mapPosition.d.ts.map +1 -0
  86. package/dist/cjs/utils/mapPosition.js +26 -0
  87. package/dist/cjs/utils/mapPosition.js.map +1 -0
  88. package/dist/cjs/utils/ohlcvInterval.d.ts +4 -0
  89. package/dist/cjs/utils/ohlcvInterval.d.ts.map +1 -0
  90. package/dist/cjs/utils/ohlcvInterval.js +49 -0
  91. package/dist/cjs/utils/ohlcvInterval.js.map +1 -0
  92. package/dist/cjs/utils/ondoAsset.d.ts +3 -0
  93. package/dist/cjs/utils/ondoAsset.d.ts.map +1 -0
  94. package/dist/cjs/utils/ondoAsset.js +12 -0
  95. package/dist/cjs/utils/ondoAsset.js.map +1 -0
  96. package/dist/cjs/utils/orderFormatting.d.ts +4 -0
  97. package/dist/cjs/utils/orderFormatting.d.ts.map +1 -0
  98. package/dist/cjs/utils/orderFormatting.js +40 -0
  99. package/dist/cjs/utils/orderFormatting.js.map +1 -0
  100. package/dist/cjs/websocket/OndoWsProvider.d.ts +56 -0
  101. package/dist/cjs/websocket/OndoWsProvider.d.ts.map +1 -0
  102. package/dist/cjs/websocket/OndoWsProvider.js +515 -0
  103. package/dist/cjs/websocket/OndoWsProvider.js.map +1 -0
  104. package/dist/esm/OndoProvider.d.ts +39 -0
  105. package/dist/esm/OndoProvider.d.ts.map +1 -0
  106. package/dist/esm/OndoProvider.js +366 -0
  107. package/dist/esm/OndoProvider.js.map +1 -0
  108. package/dist/esm/accountConfig.d.ts +13 -0
  109. package/dist/esm/accountConfig.d.ts.map +1 -0
  110. package/dist/esm/accountConfig.js +77 -0
  111. package/dist/esm/accountConfig.js.map +1 -0
  112. package/dist/esm/accountSummary.d.ts +12 -0
  113. package/dist/esm/accountSummary.d.ts.map +1 -0
  114. package/dist/esm/accountSummary.js +14 -0
  115. package/dist/esm/accountSummary.js.map +1 -0
  116. package/dist/esm/auth/OndoTokenStore.d.ts +20 -0
  117. package/dist/esm/auth/OndoTokenStore.d.ts.map +1 -0
  118. package/dist/esm/auth/OndoTokenStore.js +61 -0
  119. package/dist/esm/auth/OndoTokenStore.js.map +1 -0
  120. package/dist/esm/auth/completeSiweLogin.d.ts +28 -0
  121. package/dist/esm/auth/completeSiweLogin.d.ts.map +1 -0
  122. package/dist/esm/auth/completeSiweLogin.js +21 -0
  123. package/dist/esm/auth/completeSiweLogin.js.map +1 -0
  124. package/dist/esm/auth/index.d.ts +4 -0
  125. package/dist/esm/auth/index.d.ts.map +1 -0
  126. package/dist/esm/auth/index.js +5 -0
  127. package/dist/esm/auth/index.js.map +1 -0
  128. package/dist/esm/auth/signActions.d.ts +35 -0
  129. package/dist/esm/auth/signActions.d.ts.map +1 -0
  130. package/dist/esm/auth/signActions.js +103 -0
  131. package/dist/esm/auth/signActions.js.map +1 -0
  132. package/dist/esm/constants.d.ts +35 -0
  133. package/dist/esm/constants.d.ts.map +1 -0
  134. package/dist/esm/constants.js +35 -0
  135. package/dist/esm/constants.js.map +1 -0
  136. package/dist/esm/index.d.ts +19 -0
  137. package/dist/esm/index.d.ts.map +1 -0
  138. package/dist/esm/index.js +21 -0
  139. package/dist/esm/index.js.map +1 -0
  140. package/dist/esm/package.json +1 -0
  141. package/dist/esm/types/auth.d.ts +32 -0
  142. package/dist/esm/types/auth.d.ts.map +1 -0
  143. package/dist/esm/types/auth.js +2 -0
  144. package/dist/esm/types/auth.js.map +1 -0
  145. package/dist/esm/types/index.d.ts +4 -0
  146. package/dist/esm/types/index.d.ts.map +1 -0
  147. package/dist/esm/types/index.js +3 -0
  148. package/dist/esm/types/index.js.map +1 -0
  149. package/dist/esm/types/wire.d.ts +195 -0
  150. package/dist/esm/types/wire.d.ts.map +1 -0
  151. package/dist/esm/types/wire.js +7 -0
  152. package/dist/esm/types/wire.js.map +1 -0
  153. package/dist/esm/types/ws.d.ts +108 -0
  154. package/dist/esm/types/ws.d.ts.map +1 -0
  155. package/dist/esm/types/ws.js +7 -0
  156. package/dist/esm/types/ws.js.map +1 -0
  157. package/dist/esm/utils/activityCursor.d.ts +47 -0
  158. package/dist/esm/utils/activityCursor.d.ts.map +1 -0
  159. package/dist/esm/utils/activityCursor.js +93 -0
  160. package/dist/esm/utils/activityCursor.js.map +1 -0
  161. package/dist/esm/utils/apiClient.d.ts +90 -0
  162. package/dist/esm/utils/apiClient.d.ts.map +1 -0
  163. package/dist/esm/utils/apiClient.js +169 -0
  164. package/dist/esm/utils/apiClient.js.map +1 -0
  165. package/dist/esm/utils/index.d.ts +11 -0
  166. package/dist/esm/utils/index.d.ts.map +1 -0
  167. package/dist/esm/utils/index.js +12 -0
  168. package/dist/esm/utils/index.js.map +1 -0
  169. package/dist/esm/utils/liquidation.d.ts +20 -0
  170. package/dist/esm/utils/liquidation.d.ts.map +1 -0
  171. package/dist/esm/utils/liquidation.js +29 -0
  172. package/dist/esm/utils/liquidation.js.map +1 -0
  173. package/dist/esm/utils/mapActivity.d.ts +21 -0
  174. package/dist/esm/utils/mapActivity.d.ts.map +1 -0
  175. package/dist/esm/utils/mapActivity.js +45 -0
  176. package/dist/esm/utils/mapActivity.js.map +1 -0
  177. package/dist/esm/utils/mapFill.d.ts +12 -0
  178. package/dist/esm/utils/mapFill.d.ts.map +1 -0
  179. package/dist/esm/utils/mapFill.js +37 -0
  180. package/dist/esm/utils/mapFill.js.map +1 -0
  181. package/dist/esm/utils/mapOrder.d.ts +50 -0
  182. package/dist/esm/utils/mapOrder.d.ts.map +1 -0
  183. package/dist/esm/utils/mapOrder.js +155 -0
  184. package/dist/esm/utils/mapOrder.js.map +1 -0
  185. package/dist/esm/utils/mapPosition.d.ts +19 -0
  186. package/dist/esm/utils/mapPosition.d.ts.map +1 -0
  187. package/dist/esm/utils/mapPosition.js +32 -0
  188. package/dist/esm/utils/mapPosition.js.map +1 -0
  189. package/dist/esm/utils/ohlcvInterval.d.ts +11 -0
  190. package/dist/esm/utils/ohlcvInterval.d.ts.map +1 -0
  191. package/dist/esm/utils/ohlcvInterval.js +59 -0
  192. package/dist/esm/utils/ohlcvInterval.js.map +1 -0
  193. package/dist/esm/utils/ondoAsset.d.ts +4 -0
  194. package/dist/esm/utils/ondoAsset.d.ts.map +1 -0
  195. package/dist/esm/utils/ondoAsset.js +9 -0
  196. package/dist/esm/utils/ondoAsset.js.map +1 -0
  197. package/dist/esm/utils/orderFormatting.d.ts +33 -0
  198. package/dist/esm/utils/orderFormatting.d.ts.map +1 -0
  199. package/dist/esm/utils/orderFormatting.js +62 -0
  200. package/dist/esm/utils/orderFormatting.js.map +1 -0
  201. package/dist/esm/websocket/OndoWsProvider.d.ts +122 -0
  202. package/dist/esm/websocket/OndoWsProvider.d.ts.map +1 -0
  203. package/dist/esm/websocket/OndoWsProvider.js +591 -0
  204. package/dist/esm/websocket/OndoWsProvider.js.map +1 -0
  205. package/dist/types/OndoProvider.d.ts +39 -0
  206. package/dist/types/OndoProvider.d.ts.map +1 -0
  207. package/dist/types/accountConfig.d.ts +13 -0
  208. package/dist/types/accountConfig.d.ts.map +1 -0
  209. package/dist/types/accountSummary.d.ts +12 -0
  210. package/dist/types/accountSummary.d.ts.map +1 -0
  211. package/dist/types/auth/OndoTokenStore.d.ts +20 -0
  212. package/dist/types/auth/OndoTokenStore.d.ts.map +1 -0
  213. package/dist/types/auth/completeSiweLogin.d.ts +28 -0
  214. package/dist/types/auth/completeSiweLogin.d.ts.map +1 -0
  215. package/dist/types/auth/index.d.ts +4 -0
  216. package/dist/types/auth/index.d.ts.map +1 -0
  217. package/dist/types/auth/signActions.d.ts +35 -0
  218. package/dist/types/auth/signActions.d.ts.map +1 -0
  219. package/dist/types/constants.d.ts +35 -0
  220. package/dist/types/constants.d.ts.map +1 -0
  221. package/dist/types/index.d.ts +19 -0
  222. package/dist/types/index.d.ts.map +1 -0
  223. package/dist/types/types/auth.d.ts +32 -0
  224. package/dist/types/types/auth.d.ts.map +1 -0
  225. package/dist/types/types/index.d.ts +4 -0
  226. package/dist/types/types/index.d.ts.map +1 -0
  227. package/dist/types/types/wire.d.ts +195 -0
  228. package/dist/types/types/wire.d.ts.map +1 -0
  229. package/dist/types/types/ws.d.ts +108 -0
  230. package/dist/types/types/ws.d.ts.map +1 -0
  231. package/dist/types/utils/activityCursor.d.ts +47 -0
  232. package/dist/types/utils/activityCursor.d.ts.map +1 -0
  233. package/dist/types/utils/apiClient.d.ts +90 -0
  234. package/dist/types/utils/apiClient.d.ts.map +1 -0
  235. package/dist/types/utils/index.d.ts +11 -0
  236. package/dist/types/utils/index.d.ts.map +1 -0
  237. package/dist/types/utils/liquidation.d.ts +20 -0
  238. package/dist/types/utils/liquidation.d.ts.map +1 -0
  239. package/dist/types/utils/mapActivity.d.ts +21 -0
  240. package/dist/types/utils/mapActivity.d.ts.map +1 -0
  241. package/dist/types/utils/mapFill.d.ts +12 -0
  242. package/dist/types/utils/mapFill.d.ts.map +1 -0
  243. package/dist/types/utils/mapOrder.d.ts +50 -0
  244. package/dist/types/utils/mapOrder.d.ts.map +1 -0
  245. package/dist/types/utils/mapPosition.d.ts +19 -0
  246. package/dist/types/utils/mapPosition.d.ts.map +1 -0
  247. package/dist/types/utils/ohlcvInterval.d.ts +11 -0
  248. package/dist/types/utils/ohlcvInterval.d.ts.map +1 -0
  249. package/dist/types/utils/ondoAsset.d.ts +4 -0
  250. package/dist/types/utils/ondoAsset.d.ts.map +1 -0
  251. package/dist/types/utils/orderFormatting.d.ts +33 -0
  252. package/dist/types/utils/orderFormatting.d.ts.map +1 -0
  253. package/dist/types/websocket/OndoWsProvider.d.ts +122 -0
  254. package/dist/types/websocket/OndoWsProvider.d.ts.map +1 -0
  255. package/package.json +64 -0
  256. package/src/OndoProvider.ts +635 -0
  257. package/src/accountConfig.ts +105 -0
  258. package/src/accountSummary.ts +22 -0
  259. package/src/auth/OndoTokenStore.ts +83 -0
  260. package/src/auth/completeSiweLogin.ts +43 -0
  261. package/src/auth/index.ts +12 -0
  262. package/src/auth/signActions.ts +160 -0
  263. package/src/constants.ts +38 -0
  264. package/src/index.ts +36 -0
  265. package/src/types/auth.ts +32 -0
  266. package/src/types/index.ts +5 -0
  267. package/src/types/wire.ts +228 -0
  268. package/src/types/ws.ts +79 -0
  269. package/src/utils/activityCursor.ts +140 -0
  270. package/src/utils/apiClient.ts +257 -0
  271. package/src/utils/index.ts +35 -0
  272. package/src/utils/liquidation.ts +37 -0
  273. package/src/utils/mapActivity.ts +61 -0
  274. package/src/utils/mapFill.ts +47 -0
  275. package/src/utils/mapOrder.ts +201 -0
  276. package/src/utils/mapPosition.ts +44 -0
  277. package/src/utils/ohlcvInterval.ts +69 -0
  278. package/src/utils/ondoAsset.ts +10 -0
  279. package/src/utils/orderFormatting.ts +70 -0
  280. package/src/websocket/OndoWsProvider.ts +752 -0
@@ -0,0 +1,635 @@
1
+ import {
2
+ getMarketRegistry,
3
+ localStorageAdapter,
4
+ PerpsError,
5
+ type PerpsProviderPlugin,
6
+ type PerpsSDKClient,
7
+ type ProviderAccountExistsParams,
8
+ type ProviderGetAccountParams,
9
+ type ProviderGetActivityParams,
10
+ type ProviderGetFillsParams,
11
+ type ProviderGetOrderParams,
12
+ type ProviderGetOrdersParams,
13
+ type ProviderGetPositionsParams,
14
+ type ProviderGetQuoteParams,
15
+ resolveQuote,
16
+ resolveRetryPolicy,
17
+ type SDKRequestOptions,
18
+ type SignActionsContext,
19
+ type StorageAdapter,
20
+ toMarketDisplay,
21
+ } from '@lifi/perps-sdk'
22
+ import type {
23
+ AccountConfig,
24
+ AccountConfigSetting,
25
+ AccountResponse,
26
+ AccountSummary,
27
+ ActionResult,
28
+ ActionStep,
29
+ ActivitiesResponse,
30
+ ActivityItem,
31
+ FillsResponse,
32
+ MarketDisplay,
33
+ OndoAccountConfig,
34
+ Order,
35
+ OrdersResponse,
36
+ Position,
37
+ PositionsResponse,
38
+ ProviderAction,
39
+ Quote,
40
+ RestCallSignedActionStep,
41
+ SignedActionStep,
42
+ SigningMethod,
43
+ } from '@lifi/perps-types'
44
+ import { ActivityType, PerpsErrorCode } from '@lifi/perps-types'
45
+ import type { Address } from 'viem'
46
+ import { projectOndoConfigSettings } from './accountConfig.js'
47
+ import { getAccountSummary } from './accountSummary.js'
48
+ import { OndoTokenStore } from './auth/OndoTokenStore.js'
49
+ import {
50
+ executeOndoRestCallActions,
51
+ ondoSignActions,
52
+ } from './auth/signActions.js'
53
+ import {
54
+ DEFAULT_ONDO_API_URL,
55
+ ONDO_BASE_FEE_TIER,
56
+ ONDO_PROVIDER_KEY,
57
+ } from './constants.js'
58
+ import type { OndoAuthToken } from './types/auth.js'
59
+ import type {
60
+ OndoAccountReferral,
61
+ OndoBalanceSummary,
62
+ OndoFill,
63
+ OndoFundingFeeTransfer,
64
+ OndoLiquidationEvent,
65
+ OndoOrder,
66
+ OndoPosition,
67
+ } from './types/wire.js'
68
+ import {
69
+ decodeActivityCursor,
70
+ encodeActivityCursor,
71
+ type OndoActivityCursor,
72
+ } from './utils/activityCursor.js'
73
+ import {
74
+ type ApiParams,
75
+ ONDO_RETRY_DEFAULTS,
76
+ OndoApiClient,
77
+ type OndoPage,
78
+ OndoSessionExpiredError,
79
+ } from './utils/apiClient.js'
80
+ import {
81
+ classifyAndMapOrders,
82
+ estimateLiquidationPrice,
83
+ formatOrderPrice,
84
+ formatOrderSize,
85
+ mapFill,
86
+ mapFundingActivity,
87
+ mapLiquidationActivity,
88
+ mapOpenPositions,
89
+ mapOrderDetail,
90
+ ondoAsset,
91
+ } from './utils/index.js'
92
+
93
+ /**
94
+ * Construction options for the Ondo {@link PerpsProviderPlugin}.
95
+ *
96
+ * @public
97
+ */
98
+ export interface OndoProviderOptions {
99
+ /** Ondo REST base URL. Defaults to production; pass the sandbox URL to override. */
100
+ apiUrl?: string
101
+ /** Session-token persistence backend. Defaults to browser `localStorage`. */
102
+ storage?: StorageAdapter
103
+ }
104
+
105
+ /**
106
+ * Ondo provider plugin factory. Returns an object implementing
107
+ * {@link PerpsProviderPlugin}, mirroring `lighterProvider()`.
108
+ *
109
+ * Per-user reads call Ondo's REST API directly — every one requires the
110
+ * session JWT obtained through the SIWE login and stored in the token store.
111
+ * Without a stored token the reads degrade gracefully (empty pages,
112
+ * `loggedIn: false` config) instead of failing; `getOrder` throws because an
113
+ * empty result would be indistinguishable from "order not found".
114
+ *
115
+ * @example
116
+ * ```ts
117
+ * const client = createPerpsClient({
118
+ * integrator: 'my-app',
119
+ * providers: [ondoProvider()],
120
+ * })
121
+ * ```
122
+ * @public
123
+ */
124
+ export const ondoProvider = (
125
+ options: OndoProviderOptions = {}
126
+ ): PerpsProviderPlugin => {
127
+ // Late-bind slot: the factory runs before the client exists, so `bind`
128
+ // assigns this once during createPerpsClient and the read methods read it.
129
+ let boundClient: PerpsSDKClient | undefined
130
+
131
+ const requireClient = (): PerpsSDKClient => {
132
+ if (boundClient === undefined) {
133
+ throw new PerpsError(
134
+ PerpsErrorCode.SDKError,
135
+ 'ondoProvider used before binding. Register it via ' +
136
+ 'createPerpsClient({ providers: [ondoProvider()] }).'
137
+ )
138
+ }
139
+ return boundClient
140
+ }
141
+
142
+ const apiUrl = options.apiUrl ?? DEFAULT_ONDO_API_URL
143
+ const tokenStore = new OndoTokenStore(
144
+ options.storage ?? localStorageAdapter,
145
+ apiUrl
146
+ )
147
+
148
+ const apiClient = (opts?: SDKRequestOptions): OndoApiClient => {
149
+ const client = requireClient()
150
+ return new OndoApiClient(apiUrl, {
151
+ signal: opts?.signal,
152
+ policy: resolveRetryPolicy(
153
+ ONDO_RETRY_DEFAULTS,
154
+ client.config.retry,
155
+ ONDO_PROVIDER_KEY
156
+ ),
157
+ fetchImpl: client.config.fetch,
158
+ })
159
+ }
160
+
161
+ const marketRegistry = () =>
162
+ getMarketRegistry(requireClient(), ONDO_PROVIDER_KEY)
163
+
164
+ const requireMarketDisplay = (marketId: string): MarketDisplay =>
165
+ toMarketDisplay(marketRegistry().require(marketId))
166
+
167
+ const emptyConfig: OndoAccountConfig = {
168
+ provider: ONDO_PROVIDER_KEY,
169
+ loggedIn: false,
170
+ referralSet: false,
171
+ }
172
+
173
+ const loggedOutAccount = (address: Address): AccountResponse => ({
174
+ provider: ONDO_PROVIDER_KEY,
175
+ address,
176
+ balances: [],
177
+ collateralBalances: [],
178
+ positions: [],
179
+ marginUsed: '0',
180
+ unrealizedPnl: '0',
181
+ feeTier: ONDO_BASE_FEE_TIER,
182
+ config: emptyConfig,
183
+ })
184
+
185
+ // Runs an authenticated read against a live session. An absent local token
186
+ // and a server-revoked one (surfaced mid-call as `OndoSessionExpiredError`)
187
+ // both evict any stale token and fall back to `loggedOut`, so a rotated
188
+ // session never soft-locks the UI behind a token that looks valid locally.
189
+ const withSession = async <T>(
190
+ address: Address,
191
+ loggedOut: () => T,
192
+ fn: (token: OndoAuthToken) => Promise<T>
193
+ ): Promise<T> => {
194
+ const token = await tokenStore.get(address)
195
+ if (token === null) {
196
+ return loggedOut()
197
+ }
198
+ try {
199
+ return await fn(token)
200
+ } catch (err) {
201
+ if (err instanceof OndoSessionExpiredError) {
202
+ await tokenStore.remove(address)
203
+ return loggedOut()
204
+ }
205
+ throw err
206
+ }
207
+ }
208
+
209
+ return {
210
+ type: ONDO_PROVIDER_KEY,
211
+
212
+ bind(client: PerpsSDKClient): void {
213
+ boundClient = client
214
+ },
215
+
216
+ async getAccount(
217
+ params: ProviderGetAccountParams,
218
+ opts?: SDKRequestOptions
219
+ ): Promise<AccountResponse> {
220
+ return withSession(
221
+ params.address,
222
+ () => loggedOutAccount(params.address),
223
+ async (token) => {
224
+ const client = apiClient(opts)
225
+ const [balance, rawPositions, referral] = await Promise.all([
226
+ client.get<OndoBalanceSummary>('/v1/perps/balance', {
227
+ authToken: token.token,
228
+ }),
229
+ client.get<OndoPosition[]>('/v1/perps/positions', {
230
+ authToken: token.token,
231
+ }),
232
+ client.get<OndoAccountReferral | null>('/v1/account/referral', {
233
+ authToken: token.token,
234
+ }),
235
+ marketRegistry().sync(),
236
+ ])
237
+
238
+ const positions: Position[] = mapOpenPositions(
239
+ rawPositions,
240
+ requireMarketDisplay
241
+ )
242
+
243
+ // Single USD collateral row: `walletBalance` is gross (locked margin
244
+ // included, unrealized PnL excluded — the positions carry it).
245
+ return {
246
+ provider: ONDO_PROVIDER_KEY,
247
+ address: params.address,
248
+ balances: [],
249
+ collateralBalances: [
250
+ {
251
+ categoryId: ONDO_PROVIDER_KEY,
252
+ asset: ondoAsset('USD', 'USD'),
253
+ units: balance.walletBalance,
254
+ valueUsd: balance.walletBalance,
255
+ },
256
+ ],
257
+ positions,
258
+ marginUsed: balance.usedMargin,
259
+ unrealizedPnl: balance.unrealizedPnl,
260
+ feeTier: ONDO_BASE_FEE_TIER,
261
+ config: {
262
+ provider: ONDO_PROVIDER_KEY,
263
+ loggedIn: true,
264
+ authTokenExpiry: token.expirationSecs,
265
+ referralSet: referral !== null && referral !== undefined,
266
+ },
267
+ }
268
+ }
269
+ )
270
+ },
271
+
272
+ async accountExists(
273
+ params: ProviderAccountExistsParams,
274
+ opts?: SDKRequestOptions
275
+ ): Promise<boolean> {
276
+ return withSession(
277
+ params.address,
278
+ () => false,
279
+ async (token) => {
280
+ await apiClient(opts).get('/v1/account', { authToken: token.token })
281
+ return true
282
+ }
283
+ )
284
+ },
285
+
286
+ async getPositions(
287
+ params: ProviderGetPositionsParams,
288
+ opts?: SDKRequestOptions
289
+ ): Promise<PositionsResponse> {
290
+ return withSession<PositionsResponse>(
291
+ params.address,
292
+ () => ({
293
+ provider: ONDO_PROVIDER_KEY,
294
+ positions: [],
295
+ pagination: { limit: params.limit ?? 0, hasMore: false },
296
+ }),
297
+ async (token) => {
298
+ const client = apiClient(opts)
299
+ const [rawPositions] = await Promise.all([
300
+ client.get<OndoPosition[]>('/v1/perps/positions', {
301
+ authToken: token.token,
302
+ }),
303
+ marketRegistry().sync(),
304
+ ])
305
+
306
+ let positions: Position[] = mapOpenPositions(
307
+ rawPositions,
308
+ requireMarketDisplay
309
+ )
310
+ if (params.marketId !== undefined) {
311
+ positions = positions.filter((p) => p.market.id === params.marketId)
312
+ }
313
+
314
+ return {
315
+ provider: ONDO_PROVIDER_KEY,
316
+ positions,
317
+ pagination: {
318
+ limit: params.limit ?? positions.length,
319
+ hasMore: false,
320
+ },
321
+ }
322
+ }
323
+ )
324
+ },
325
+
326
+ async getOrders(
327
+ params: ProviderGetOrdersParams,
328
+ opts?: SDKRequestOptions
329
+ ): Promise<OrdersResponse> {
330
+ return withSession<OrdersResponse>(
331
+ params.address,
332
+ () => ({
333
+ provider: ONDO_PROVIDER_KEY,
334
+ openOrders: [],
335
+ triggerOrders: [],
336
+ pagination: { limit: params.limit ?? 0, hasMore: false },
337
+ }),
338
+ async (token) => {
339
+ const client = apiClient(opts)
340
+ const queryParams: ApiParams = {}
341
+ if (params.marketId !== undefined) {
342
+ queryParams.market = params.marketId
343
+ }
344
+ if (params.limit !== undefined) {
345
+ queryParams.limit = params.limit
346
+ }
347
+ if (params.cursor !== undefined) {
348
+ queryParams.cursor = params.cursor
349
+ }
350
+ const [page] = await Promise.all([
351
+ client.getPage<OndoOrder>('/v1/perps/orders', {
352
+ params: queryParams,
353
+ authToken: token.token,
354
+ }),
355
+ marketRegistry().sync(),
356
+ ])
357
+
358
+ const registry = marketRegistry()
359
+ const { openOrders, triggerOrders } = classifyAndMapOrders(
360
+ page.result,
361
+ (marketId) => {
362
+ const market = registry.get(marketId)
363
+ return market === undefined ? undefined : toMarketDisplay(market)
364
+ }
365
+ )
366
+
367
+ const nextCursor = page.pageInfo?.nextCursor
368
+ return {
369
+ provider: ONDO_PROVIDER_KEY,
370
+ openOrders,
371
+ triggerOrders,
372
+ pagination: {
373
+ limit: params.limit ?? openOrders.length + triggerOrders.length,
374
+ hasMore: nextCursor !== undefined,
375
+ ...(nextCursor === undefined ? {} : { cursor: nextCursor }),
376
+ },
377
+ }
378
+ }
379
+ )
380
+ },
381
+
382
+ async getOrder(
383
+ params: ProviderGetOrderParams,
384
+ opts?: SDKRequestOptions
385
+ ): Promise<Order> {
386
+ return withSession(
387
+ params.address,
388
+ (): Order => {
389
+ throw new PerpsError(
390
+ PerpsErrorCode.SDKError,
391
+ 'Ondo order lookup requires a session token. Run the SIWE login first.'
392
+ )
393
+ },
394
+ async (token) => {
395
+ const client = apiClient(opts)
396
+ const [order] = await Promise.all([
397
+ client.get<OndoOrder>(
398
+ `/v1/perps/orders/${encodeURIComponent(params.id)}`,
399
+ { authToken: token.token }
400
+ ),
401
+ marketRegistry().sync(),
402
+ ])
403
+ return mapOrderDetail(order, requireMarketDisplay(order.market))
404
+ }
405
+ )
406
+ },
407
+
408
+ async getFills(
409
+ params: ProviderGetFillsParams,
410
+ opts?: SDKRequestOptions
411
+ ): Promise<FillsResponse> {
412
+ return withSession<FillsResponse>(
413
+ params.address,
414
+ () => ({
415
+ provider: ONDO_PROVIDER_KEY,
416
+ items: [],
417
+ pagination: { limit: params.limit ?? 0, hasMore: false },
418
+ }),
419
+ async (token) => {
420
+ const client = apiClient(opts)
421
+ const queryParams: ApiParams = {}
422
+ if (params.limit !== undefined) {
423
+ queryParams.limit = params.limit
424
+ }
425
+ if (params.cursor !== undefined) {
426
+ queryParams.cursor = params.cursor
427
+ }
428
+ const [page] = await Promise.all([
429
+ client.getPage<OndoFill>('/v1/perps/fills', {
430
+ params: queryParams,
431
+ authToken: token.token,
432
+ }),
433
+ marketRegistry().sync(),
434
+ ])
435
+
436
+ const items = page.result.map((fill) =>
437
+ mapFill(fill, requireMarketDisplay(fill.market))
438
+ )
439
+
440
+ const nextCursor = page.pageInfo?.nextCursor
441
+ return {
442
+ provider: ONDO_PROVIDER_KEY,
443
+ items,
444
+ pagination: {
445
+ limit: params.limit ?? items.length,
446
+ hasMore: nextCursor !== undefined,
447
+ ...(nextCursor === undefined ? {} : { cursor: nextCursor }),
448
+ },
449
+ }
450
+ }
451
+ )
452
+ },
453
+
454
+ async getActivity(
455
+ params: ProviderGetActivityParams,
456
+ opts?: SDKRequestOptions
457
+ ): Promise<ActivitiesResponse> {
458
+ return withSession<ActivitiesResponse>(
459
+ params.address,
460
+ () => ({
461
+ provider: ONDO_PROVIDER_KEY,
462
+ items: [],
463
+ pagination: { limit: params.limit ?? 0, hasMore: false },
464
+ }),
465
+ async (token) => {
466
+ const inputCursor = decodeActivityCursor(params.cursor)
467
+ const client = apiClient(opts)
468
+
469
+ const wantsType = (t: ActivityType): boolean =>
470
+ params.type === undefined || params.type.includes(t)
471
+ const shouldFetch = (
472
+ t: ActivityType,
473
+ key: 'fundings' | 'liquidations'
474
+ ): boolean => {
475
+ if (!wantsType(t)) {
476
+ return false
477
+ }
478
+ if (inputCursor === undefined) {
479
+ return true
480
+ }
481
+ const v = inputCursor[key]
482
+ return typeof v === 'string' && v.length > 0
483
+ }
484
+ const cursorParams = (
485
+ key: 'fundings' | 'liquidations'
486
+ ): ApiParams => {
487
+ const v = inputCursor?.[key]
488
+ return typeof v === 'string' && v.length > 0 ? { cursor: v } : {}
489
+ }
490
+ const emptyPage = <T>(): OndoPage<T> => ({
491
+ result: [],
492
+ pageInfo: undefined,
493
+ })
494
+
495
+ const [fundings, liquidations] = await Promise.all([
496
+ shouldFetch(ActivityType.FUNDING, 'fundings')
497
+ ? client.getPage<OndoFundingFeeTransfer>(
498
+ '/v1/perps/funding_fees',
499
+ {
500
+ params: cursorParams('fundings'),
501
+ authToken: token.token,
502
+ }
503
+ )
504
+ : Promise.resolve(emptyPage<OndoFundingFeeTransfer>()),
505
+ shouldFetch(ActivityType.LIQUIDATION, 'liquidations')
506
+ ? client.getPage<OndoLiquidationEvent>(
507
+ '/v1/perps/liquidation_history',
508
+ {
509
+ params: cursorParams('liquidations'),
510
+ authToken: token.token,
511
+ }
512
+ )
513
+ : Promise.resolve(emptyPage<OndoLiquidationEvent>()),
514
+ marketRegistry().sync(),
515
+ ])
516
+
517
+ const items: ActivityItem[] = [
518
+ ...fundings.result.map((f) =>
519
+ mapFundingActivity(f, requireMarketDisplay(f.market))
520
+ ),
521
+ ...liquidations.result.map((l) =>
522
+ mapLiquidationActivity(l, requireMarketDisplay)
523
+ ),
524
+ ]
525
+
526
+ const merged = [...(inputCursor?.overflow ?? []), ...items]
527
+
528
+ const filtered = merged.filter((it) => {
529
+ const ts = new Date(it.timestamp).getTime()
530
+ if (params.startTime !== undefined && ts < params.startTime) {
531
+ return false
532
+ }
533
+ if (params.endTime !== undefined && ts > params.endTime) {
534
+ return false
535
+ }
536
+ return true
537
+ })
538
+
539
+ filtered.sort(
540
+ (a, b) =>
541
+ new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
542
+ )
543
+
544
+ const limit = params.limit ?? filtered.length
545
+ const emitted = filtered.slice(0, limit)
546
+ const overflow = filtered.slice(limit)
547
+
548
+ const nextCursorEnvelope: OndoActivityCursor = {
549
+ fundings: fundings.pageInfo?.nextCursor,
550
+ liquidations: liquidations.pageInfo?.nextCursor,
551
+ overflow,
552
+ }
553
+ const responseCursor = encodeActivityCursor(nextCursorEnvelope)
554
+ const hasMore = responseCursor !== undefined
555
+
556
+ return {
557
+ provider: ONDO_PROVIDER_KEY,
558
+ items: emitted,
559
+ pagination: {
560
+ limit,
561
+ hasMore,
562
+ ...(responseCursor === undefined
563
+ ? {}
564
+ : { cursor: responseCursor }),
565
+ },
566
+ }
567
+ }
568
+ )
569
+ },
570
+
571
+ getQuote(
572
+ params: ProviderGetQuoteParams,
573
+ opts?: SDKRequestOptions
574
+ ): Promise<Quote> {
575
+ return resolveQuote(
576
+ requireClient(),
577
+ ONDO_PROVIDER_KEY,
578
+ params,
579
+ ONDO_BASE_FEE_TIER,
580
+ opts
581
+ )
582
+ },
583
+
584
+ getAccountSummary(
585
+ account: AccountResponse,
586
+ positions: Position[]
587
+ ): AccountSummary {
588
+ return getAccountSummary(account, positions)
589
+ },
590
+
591
+ formatOrderPrice,
592
+
593
+ formatOrderSize,
594
+
595
+ estimateLiquidationPrice,
596
+
597
+ projectConfig(
598
+ config: AccountConfig,
599
+ setup: ProviderAction[],
600
+ configOptions: ProviderAction[]
601
+ ): AccountConfigSetting[] {
602
+ return projectOndoConfigSettings(config, setup, configOptions)
603
+ },
604
+
605
+ signActions(
606
+ method: SigningMethod,
607
+ steps: ActionStep[],
608
+ address: Address,
609
+ ctx?: SignActionsContext
610
+ ): Promise<SignedActionStep[]> {
611
+ return ondoSignActions(
612
+ { client: apiClient(), tokenStore },
613
+ method,
614
+ steps,
615
+ address,
616
+ ctx
617
+ )
618
+ },
619
+
620
+ executeRestCallActions(
621
+ steps: RestCallSignedActionStep[],
622
+ _address: Address,
623
+ opts?: SDKRequestOptions
624
+ ): Promise<ActionResult[]> {
625
+ return executeOndoRestCallActions(apiClient(opts), steps)
626
+ },
627
+ }
628
+ }
629
+
630
+ /**
631
+ * Alias matching `@lifi/sdk`'s capitalised factory naming (`EVM()`, `Lighter`).
632
+ *
633
+ * @public
634
+ */
635
+ export const Ondo = ondoProvider