@omnipair/dusk-sdk 2.0.2 → 2.16.0-next.20261102

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 (187) hide show
  1. package/README.md +1011 -16
  2. package/dist/amounts.d.ts +9 -0
  3. package/dist/amounts.d.ts.map +1 -0
  4. package/dist/amounts.js +10 -0
  5. package/dist/amounts.js.map +1 -0
  6. package/dist/constants.d.ts +71 -14
  7. package/dist/constants.d.ts.map +1 -1
  8. package/dist/constants.js +155 -28
  9. package/dist/constants.js.map +1 -1
  10. package/dist/delegate.d.ts +94 -0
  11. package/dist/delegate.d.ts.map +1 -0
  12. package/dist/delegate.js +131 -0
  13. package/dist/delegate.js.map +1 -0
  14. package/dist/dusk.d.ts +14 -0
  15. package/dist/dusk.d.ts.map +1 -1
  16. package/dist/dusk.js +22 -0
  17. package/dist/dusk.js.map +1 -1
  18. package/dist/get.d.ts +3253 -378
  19. package/dist/get.d.ts.map +1 -1
  20. package/dist/get.js +130 -70
  21. package/dist/get.js.map +1 -1
  22. package/dist/governance-client.d.ts +169 -0
  23. package/dist/governance-client.d.ts.map +1 -0
  24. package/dist/governance-client.js +146 -0
  25. package/dist/governance-client.js.map +1 -0
  26. package/dist/governance.d.ts +313 -0
  27. package/dist/governance.d.ts.map +1 -0
  28. package/dist/governance.js +902 -0
  29. package/dist/governance.js.map +1 -0
  30. package/dist/hash.d.ts +9 -0
  31. package/dist/hash.d.ts.map +1 -0
  32. package/dist/hash.js +16 -0
  33. package/dist/hash.js.map +1 -0
  34. package/dist/hlp-liquidation-client.d.ts +106 -0
  35. package/dist/hlp-liquidation-client.d.ts.map +1 -0
  36. package/dist/hlp-liquidation-client.js +150 -0
  37. package/dist/hlp-liquidation-client.js.map +1 -0
  38. package/dist/idl_delegate.d.ts +3 -0
  39. package/dist/idl_delegate.d.ts.map +1 -0
  40. package/dist/idl_delegate.js +3 -0
  41. package/dist/idl_delegate.js.map +1 -0
  42. package/dist/idl_delegate.json +6119 -0
  43. package/dist/idl_v2.json +17175 -5862
  44. package/dist/index.d.ts +23 -0
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +23 -0
  47. package/dist/index.js.map +1 -1
  48. package/dist/interest-accounting.d.ts +49 -0
  49. package/dist/interest-accounting.d.ts.map +1 -0
  50. package/dist/interest-accounting.js +72 -0
  51. package/dist/interest-accounting.js.map +1 -0
  52. package/dist/leverage-actions.d.ts +122 -0
  53. package/dist/leverage-actions.d.ts.map +1 -0
  54. package/dist/leverage-actions.js +228 -0
  55. package/dist/leverage-actions.js.map +1 -0
  56. package/dist/leverage-margins.d.ts +12 -0
  57. package/dist/leverage-margins.d.ts.map +1 -0
  58. package/dist/leverage-margins.js +45 -0
  59. package/dist/leverage-margins.js.map +1 -0
  60. package/dist/leverage-preview.d.ts +587 -0
  61. package/dist/leverage-preview.d.ts.map +1 -0
  62. package/dist/leverage-preview.js +89 -0
  63. package/dist/leverage-preview.js.map +1 -0
  64. package/dist/liquidation-client.d.ts +230 -0
  65. package/dist/liquidation-client.d.ts.map +1 -0
  66. package/dist/liquidation-client.js +239 -0
  67. package/dist/liquidation-client.js.map +1 -0
  68. package/dist/liquidation.d.ts +78 -0
  69. package/dist/liquidation.d.ts.map +1 -0
  70. package/dist/liquidation.js +122 -0
  71. package/dist/liquidation.js.map +1 -0
  72. package/dist/lp-naming.d.ts +43 -0
  73. package/dist/lp-naming.d.ts.map +1 -0
  74. package/dist/lp-naming.js +81 -0
  75. package/dist/lp-naming.js.map +1 -0
  76. package/dist/lp-vanity.d.ts +33 -0
  77. package/dist/lp-vanity.d.ts.map +1 -0
  78. package/dist/lp-vanity.js +94 -0
  79. package/dist/lp-vanity.js.map +1 -0
  80. package/dist/market-bootstrap.d.ts +109 -0
  81. package/dist/market-bootstrap.d.ts.map +1 -0
  82. package/dist/market-bootstrap.js +158 -0
  83. package/dist/market-bootstrap.js.map +1 -0
  84. package/dist/market-launch.d.ts +45 -0
  85. package/dist/market-launch.d.ts.map +1 -0
  86. package/dist/market-launch.js +76 -0
  87. package/dist/market-launch.js.map +1 -0
  88. package/dist/oracle.d.ts +46 -0
  89. package/dist/oracle.d.ts.map +1 -0
  90. package/dist/oracle.js +103 -0
  91. package/dist/oracle.js.map +1 -0
  92. package/dist/preview.d.ts +39 -1
  93. package/dist/preview.d.ts.map +1 -1
  94. package/dist/preview.js +12 -0
  95. package/dist/preview.js.map +1 -1
  96. package/dist/protection.d.ts +48 -0
  97. package/dist/protection.d.ts.map +1 -0
  98. package/dist/protection.js +88 -0
  99. package/dist/protection.js.map +1 -0
  100. package/dist/risk-pricing.d.ts +14 -0
  101. package/dist/risk-pricing.d.ts.map +1 -0
  102. package/dist/risk-pricing.js +25 -0
  103. package/dist/risk-pricing.js.map +1 -0
  104. package/dist/simulation.d.ts +45 -0
  105. package/dist/simulation.d.ts.map +1 -0
  106. package/dist/simulation.js +106 -0
  107. package/dist/simulation.js.map +1 -0
  108. package/dist/tranche-client.d.ts +121 -0
  109. package/dist/tranche-client.d.ts.map +1 -0
  110. package/dist/tranche-client.js +185 -0
  111. package/dist/tranche-client.js.map +1 -0
  112. package/dist/transfer-fees.d.ts +46 -0
  113. package/dist/transfer-fees.d.ts.map +1 -0
  114. package/dist/transfer-fees.js +76 -0
  115. package/dist/transfer-fees.js.map +1 -0
  116. package/dist/type-aliases.d.ts +271 -31
  117. package/dist/type-aliases.d.ts.map +1 -1
  118. package/dist/types_delegate.d.ts +6126 -0
  119. package/dist/types_delegate.d.ts.map +1 -0
  120. package/dist/types_delegate.js +2 -0
  121. package/dist/types_delegate.js.map +1 -0
  122. package/dist/types_v2.d.ts +17235 -5922
  123. package/dist/types_v2.d.ts.map +1 -1
  124. package/dist/virtual-book/index.d.ts +4 -0
  125. package/dist/virtual-book/index.d.ts.map +1 -0
  126. package/dist/virtual-book/index.js +4 -0
  127. package/dist/virtual-book/index.js.map +1 -0
  128. package/dist/virtual-book/market.d.ts +608 -0
  129. package/dist/virtual-book/market.d.ts.map +1 -0
  130. package/dist/virtual-book/market.js +59 -0
  131. package/dist/virtual-book/market.js.map +1 -0
  132. package/dist/virtual-book/projection.d.ts +44 -0
  133. package/dist/virtual-book/projection.d.ts.map +1 -0
  134. package/dist/virtual-book/projection.js +229 -0
  135. package/dist/virtual-book/projection.js.map +1 -0
  136. package/dist/virtual-book/quotes.d.ts +1241 -0
  137. package/dist/virtual-book/quotes.d.ts.map +1 -0
  138. package/dist/virtual-book/quotes.js +233 -0
  139. package/dist/virtual-book/quotes.js.map +1 -0
  140. package/dist/write.d.ts +517 -1
  141. package/dist/write.d.ts.map +1 -1
  142. package/dist/write.js +1172 -23
  143. package/dist/write.js.map +1 -1
  144. package/dist/yield-client.d.ts +51 -0
  145. package/dist/yield-client.d.ts.map +1 -0
  146. package/dist/yield-client.js +98 -0
  147. package/dist/yield-client.js.map +1 -0
  148. package/package.json +9 -2
  149. package/src/amounts.ts +13 -0
  150. package/src/constants.ts +236 -26
  151. package/src/delegate.ts +238 -0
  152. package/src/dusk.ts +28 -0
  153. package/src/get.ts +247 -82
  154. package/src/governance-client.ts +234 -0
  155. package/src/governance.ts +1422 -0
  156. package/src/hash.ts +15 -0
  157. package/src/hlp-liquidation-client.ts +195 -0
  158. package/src/idl_delegate.json +6119 -0
  159. package/src/idl_delegate.ts +3 -0
  160. package/src/idl_v2.json +17175 -5862
  161. package/src/index.ts +31 -0
  162. package/src/interest-accounting.ts +85 -0
  163. package/src/leverage-actions.ts +216 -0
  164. package/src/leverage-margins.ts +48 -0
  165. package/src/leverage-preview.ts +86 -0
  166. package/src/liquidation-client.ts +297 -0
  167. package/src/liquidation.ts +137 -0
  168. package/src/lp-naming.ts +127 -0
  169. package/src/lp-vanity.ts +135 -0
  170. package/src/market-bootstrap.ts +273 -0
  171. package/src/market-launch.ts +103 -0
  172. package/src/oracle.ts +120 -0
  173. package/src/preview.ts +53 -1
  174. package/src/protection.ts +112 -0
  175. package/src/risk-pricing.ts +28 -0
  176. package/src/simulation.ts +169 -0
  177. package/src/tranche-client.ts +187 -0
  178. package/src/transfer-fees.ts +99 -0
  179. package/src/type-aliases.ts +280 -31
  180. package/src/types_delegate.ts +6125 -0
  181. package/src/types_v2.ts +17174 -5861
  182. package/src/virtual-book/index.ts +3 -0
  183. package/src/virtual-book/market.ts +76 -0
  184. package/src/virtual-book/projection.ts +265 -0
  185. package/src/virtual-book/quotes.ts +308 -0
  186. package/src/write.ts +2073 -34
  187. package/src/yield-client.ts +117 -0
package/dist/index.d.ts CHANGED
@@ -2,13 +2,36 @@ export { default as IDL } from "./idl_v2.js";
2
2
  export type { Dusk as DuskIdl } from "./types_v2.js";
3
3
  export * from "./type-aliases.js";
4
4
  export * from "./address.js";
5
+ export * from "./amounts.js";
5
6
  export * from "./constants.js";
6
7
  export { Dusk } from "./dusk.js";
7
8
  export type { DuskOptions } from "./dusk.js";
9
+ export * from "./delegate.js";
8
10
  export * from "./get.js";
11
+ export * from "./governance.js";
12
+ export * from "./hash.js";
9
13
  export * from "./indexer.js";
14
+ export * from "./lp-naming.js";
15
+ export * from "./leverage-margins.js";
16
+ export * from "./leverage-actions.js";
17
+ export * from "./leverage-preview.js";
18
+ export * from "./liquidation.js";
19
+ export * from "./liquidation-client.js";
20
+ export * from "./market-launch.js";
21
+ export * from "./lp-vanity.js";
22
+ export * from "./market-bootstrap.js";
10
23
  export * from "./preview.js";
11
24
  export * from "./program.js";
12
25
  export * from "./referral.js";
13
26
  export * from "./write.js";
27
+ export * from "./virtual-book/index.js";
28
+ export * from "./protection.js";
29
+ export * from "./governance-client.js";
30
+ export * from "./transfer-fees.js";
31
+ export * from "./interest-accounting.js";
32
+ export * from "./yield-client.js";
33
+ export * from "./hlp-liquidation-client.js";
34
+ export * from "./risk-pricing.js";
35
+ export * from "./tranche-client.js";
36
+ export * from "./oracle.js";
14
37
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC;AAGrD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC;AAGrD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAElC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,mBAAmB,CAAC;AAElC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC"}
package/dist/index.js CHANGED
@@ -4,12 +4,35 @@ export { default as IDL } from "./idl_v2.js";
4
4
  export * from "./type-aliases.js";
5
5
  // Re-export constants and utilities
6
6
  export * from "./address.js";
7
+ export * from "./amounts.js";
7
8
  export * from "./constants.js";
8
9
  export { Dusk } from "./dusk.js";
10
+ export * from "./delegate.js";
9
11
  export * from "./get.js";
12
+ export * from "./governance.js";
13
+ export * from "./hash.js";
10
14
  export * from "./indexer.js";
15
+ export * from "./lp-naming.js";
16
+ export * from "./leverage-margins.js";
17
+ export * from "./leverage-actions.js";
18
+ export * from "./leverage-preview.js";
19
+ export * from "./liquidation.js";
20
+ export * from "./liquidation-client.js";
21
+ export * from "./market-launch.js";
22
+ export * from "./lp-vanity.js";
23
+ export * from "./market-bootstrap.js";
11
24
  export * from "./preview.js";
12
25
  export * from "./program.js";
13
26
  export * from "./referral.js";
14
27
  export * from "./write.js";
28
+ export * from "./virtual-book/index.js";
29
+ export * from "./protection.js";
30
+ export * from "./governance-client.js";
31
+ export * from "./transfer-fees.js";
32
+ export * from "./interest-accounting.js";
33
+ export * from "./yield-client.js";
34
+ export * from "./hlp-liquidation-client.js";
35
+ export * from "./risk-pricing.js";
36
+ export * from "./tranche-client.js";
37
+ export * from "./oracle.js";
15
38
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAG7C,kBAAkB;AAClB,cAAc,mBAAmB,CAAC;AAElC,oCAAoC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAG7C,kBAAkB;AAClB,cAAc,mBAAmB,CAAC;AAElC,oCAAoC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAElC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,mBAAmB,CAAC;AAElC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC"}
@@ -0,0 +1,49 @@
1
+ import { type TransferFeeNotice } from "./transfer-fees.js";
2
+ import type { BorrowPosition, Market } from "./type-aliases.js";
3
+ /** Position-local public principal and indexed debt, in raw token atoms.
4
+ * Read the position and market from the same slot. The market's fixed
5
+ * principal is an aggregate and must not be used to split this loan's payoff
6
+ * or insured loss. A one-atom share-floor phase can leave recorded principal
7
+ * briefly above displayed position debt, so accrued interest is floored at 0.
8
+ */
9
+ export declare function borrowDebtBreakdown(position: Pick<BorrowPosition, "fixedBaseShares" | "fixedQuoteShares" | "fixedBasePrincipal" | "fixedQuotePrincipal">, market: Pick<Market, "debt">, asset: "base" | "quote"): {
10
+ debt: bigint;
11
+ principal: bigint;
12
+ accruedInterest: bigint;
13
+ };
14
+ /** Accounting amounts only: this does not establish hLP settlement feasibility
15
+ * or authorize a harvest. Inputs must come from the same accrued market state.
16
+ * Only the effective transfer fee is charged on the custody transfer.
17
+ */
18
+ export declare function quoteInterestAdvanceAmounts(input: {
19
+ unpaidPublicInterest: bigint;
20
+ outstandingGrossAdvance: bigint;
21
+ reserveCash: bigint;
22
+ maxGross: bigint;
23
+ protocolBps: number;
24
+ transferFee: TransferFeeNotice;
25
+ }): {
26
+ grossAdvance: bigint;
27
+ protocolEscrow: bigint;
28
+ lpVaultDebit: bigint;
29
+ lpVaultCredit: bigint;
30
+ transferFee: bigint;
31
+ };
32
+ /** Allocate the measured custody credit after repayment. Already-funded LP
33
+ * interest is omitted from freshGrossInterest, so it cannot be paid twice.
34
+ * The current protocol rate applies only to the fresh part; the escrowed part
35
+ * is protocol revenue after its proportional share of the transfer fee.
36
+ */
37
+ export declare function allocateRepaidInterest(input: {
38
+ freshGrossInterest: bigint;
39
+ frozenProtocolGross: bigint;
40
+ measuredVaultCredit: bigint;
41
+ currentProtocolBps: number;
42
+ }): {
43
+ grossTransfer: bigint;
44
+ frozenProtocolCredit: bigint;
45
+ freshProtocolCredit: bigint;
46
+ protocolCredit: bigint;
47
+ lpCredit: bigint;
48
+ };
49
+ //# sourceMappingURL=interest-accounting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interest-accounting.d.ts","sourceRoot":"","sources":["../src/interest-accounting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC,EACrH,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,GAAG,OAAO;;;;EAYxB;AASD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;CAChC;;;;;;EAYA;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;;;;;;EAYA"}
@@ -0,0 +1,72 @@
1
+ import { transferFeeCredit } from "./transfer-fees.js";
2
+ const U64_MAX = (1n << 64n) - 1n;
3
+ const U128_MAX = (1n << 128n) - 1n;
4
+ const NAD = 1000000000n;
5
+ /** Position-local public principal and indexed debt, in raw token atoms.
6
+ * Read the position and market from the same slot. The market's fixed
7
+ * principal is an aggregate and must not be used to split this loan's payoff
8
+ * or insured loss. A one-atom share-floor phase can leave recorded principal
9
+ * briefly above displayed position debt, so accrued interest is floored at 0.
10
+ */
11
+ export function borrowDebtBreakdown(position, market, asset) {
12
+ const shares = BigInt((asset === "base" ? position.fixedBaseShares : position.fixedQuoteShares).toString());
13
+ const principal = BigInt((asset === "base" ? position.fixedBasePrincipal : position.fixedQuotePrincipal).toString());
14
+ const index = BigInt((asset === "base" ? market.debt.baseBorrowIndexNad : market.debt.quoteBorrowIndexNad).toString());
15
+ amount(shares, U128_MAX);
16
+ amount(principal);
17
+ amount(index, U128_MAX);
18
+ if (index < NAD)
19
+ throw new RangeError("Invalid borrow index");
20
+ const debt = shares * index / NAD;
21
+ amount(debt, U128_MAX);
22
+ return { debt, principal, accruedInterest: debt > principal ? debt - principal : 0n };
23
+ }
24
+ function amount(value, max = U64_MAX) {
25
+ if (value < 0n || value > max)
26
+ throw new RangeError("Interest amount is out of range");
27
+ }
28
+ function rate(bps) {
29
+ if (!Number.isSafeInteger(bps) || bps < 0 || bps > 10_000)
30
+ throw new RangeError("Invalid protocol interest rate");
31
+ return BigInt(bps);
32
+ }
33
+ /** Accounting amounts only: this does not establish hLP settlement feasibility
34
+ * or authorize a harvest. Inputs must come from the same accrued market state.
35
+ * Only the effective transfer fee is charged on the custody transfer.
36
+ */
37
+ export function quoteInterestAdvanceAmounts(input) {
38
+ const { unpaidPublicInterest: unpaid, outstandingGrossAdvance: advanced, reserveCash, maxGross } = input;
39
+ amount(unpaid, U128_MAX);
40
+ for (const value of [advanced, reserveCash, maxGross])
41
+ amount(value);
42
+ if (advanced > unpaid)
43
+ throw new RangeError("Advance exceeds unpaid interest");
44
+ const bps = rate(input.protocolBps);
45
+ const available = unpaid - advanced;
46
+ const grossAdvance = [available, reserveCash, maxGross].reduce((a, b) => a < b ? a : b);
47
+ const protocolEscrow = grossAdvance * bps / 10000n;
48
+ const lpVaultDebit = grossAdvance - protocolEscrow;
49
+ const lpVaultCredit = transferFeeCredit(lpVaultDebit, input.transferFee, "effective");
50
+ return { grossAdvance, protocolEscrow, lpVaultDebit, lpVaultCredit, transferFee: lpVaultDebit - lpVaultCredit };
51
+ }
52
+ /** Allocate the measured custody credit after repayment. Already-funded LP
53
+ * interest is omitted from freshGrossInterest, so it cannot be paid twice.
54
+ * The current protocol rate applies only to the fresh part; the escrowed part
55
+ * is protocol revenue after its proportional share of the transfer fee.
56
+ */
57
+ export function allocateRepaidInterest(input) {
58
+ const { freshGrossInterest: fresh, frozenProtocolGross: frozen, measuredVaultCredit: credit } = input;
59
+ for (const value of [fresh, frozen, credit])
60
+ amount(value);
61
+ const bps = rate(input.currentProtocolBps);
62
+ const grossTransfer = fresh + frozen;
63
+ amount(grossTransfer);
64
+ if (credit > grossTransfer)
65
+ throw new RangeError("Custody credit exceeds the transfer");
66
+ const frozenProtocolCredit = grossTransfer === 0n ? 0n : credit * frozen / grossTransfer;
67
+ const freshCredit = credit - frozenProtocolCredit;
68
+ const freshProtocolCredit = freshCredit * bps / 10000n;
69
+ const protocolCredit = frozenProtocolCredit + freshProtocolCredit;
70
+ return { grossTransfer, frozenProtocolCredit, freshProtocolCredit, protocolCredit, lpCredit: credit - protocolCredit };
71
+ }
72
+ //# sourceMappingURL=interest-accounting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interest-accounting.js","sourceRoot":"","sources":["../src/interest-accounting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,oBAAoB,CAAC;AAG/E,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,QAAQ,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;AACnC,MAAM,GAAG,GAAG,WAAc,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAqH,EACrH,MAA4B,EAC5B,KAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5G,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrH,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzB,MAAM,CAAC,SAAS,CAAC,CAAC;IAClB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;IAClC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC;AACD,SAAS,MAAM,CAAC,KAAa,EAAE,GAAG,GAAG,OAAO;IAC1C,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;AACzF,CAAC;AACD,SAAS,IAAI,CAAC,GAAW;IACvB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IAClH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAO3C;IACC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACzG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACrE,IAAI,QAAQ,GAAG,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,YAAY,GAAG,GAAG,GAAG,MAAO,CAAC;IACpD,MAAM,YAAY,GAAG,YAAY,GAAG,cAAc,CAAC;IACnD,MAAM,aAAa,GAAG,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACtF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,aAAa,EAAE,CAAC;AAClH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAKtC;IACC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACtG,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtB,IAAI,MAAM,GAAG,aAAa;QAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IACxF,MAAM,oBAAoB,GAAG,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACzF,MAAM,WAAW,GAAG,MAAM,GAAG,oBAAoB,CAAC;IAClD,MAAM,mBAAmB,GAAG,WAAW,GAAG,GAAG,GAAG,MAAO,CAAC;IACxD,MAAM,cAAc,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;IAClE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;AACzH,CAAC"}
@@ -0,0 +1,122 @@
1
+ export interface LeverageActionState {
2
+ collateralAmount: bigint;
3
+ /** Indexed debt, including accrued interest, in borrowed-token atoms. */
4
+ debtAmount: bigint;
5
+ /** Mark or EMA value of held collateral in borrowed-token atoms. State the
6
+ * chosen price basis in the UI. This is NOT a realizable close payout. */
7
+ collateralValue: bigint;
8
+ }
9
+ export declare function leverageActionMetrics(state: LeverageActionState): {
10
+ equity: bigint;
11
+ leverageBps: bigint | null;
12
+ debtFree: boolean;
13
+ unitOfAccount: "debt-token";
14
+ collateralAmount: bigint;
15
+ /** Indexed debt, including accrued interest, in borrowed-token atoms. */
16
+ debtAmount: bigint;
17
+ /** Mark or EMA value of held collateral in borrowed-token atoms. State the
18
+ * chosen price basis in the UI. This is NOT a realizable close payout. */
19
+ collateralValue: bigint;
20
+ };
21
+ /** Matches the program's aggregate-floor-aware debt-share burn. Do not infer
22
+ * a full repayment from a rounded UI debt amount: it can need one more atom. */
23
+ export declare function leverageRepaymentQuote(input: {
24
+ positionShares: bigint;
25
+ aggregateShares: bigint;
26
+ borrowIndexNad: bigint;
27
+ maxCredit: bigint;
28
+ }): {
29
+ sharesBurned: bigint;
30
+ cashRepaid: bigint;
31
+ debtReduced: bigint;
32
+ debtRemaining: bigint;
33
+ fullRepayCredit: bigint;
34
+ };
35
+ /** Exact slice selection used by owner and delegated partial closes. */
36
+ export declare function leverageCloseSlice(input: {
37
+ collateralAmount: bigint;
38
+ debtShares: bigint;
39
+ aggregateShares: bigint;
40
+ borrowIndexNad: bigint;
41
+ closeBps: number;
42
+ }): {
43
+ closeBps: number;
44
+ collateralDebit: bigint;
45
+ sharesToBurn: bigint;
46
+ debtRepayment: bigint;
47
+ remainingCollateral: bigint;
48
+ remainingDebtShares: bigint;
49
+ };
50
+ /** Link a held-token size input to percentage without closing more than asked.
51
+ * The returned actual debit may be smaller because on-chain percentages use bps. */
52
+ export declare function leverageClosePercentage(collateralAmount: bigint, requestedDebit: bigint): {
53
+ closeBps: number;
54
+ collateralDebit: bigint;
55
+ };
56
+ export type LeveragePurchaseQuote = (netDebtInput: bigint) => Promise<bigint>;
57
+ /** Link target leverage OR additional held-token size to borrowing. The default
58
+ * target is CURRENT WHOLE-position leverage, never leverage of just the added
59
+ * slice. marginCredit is net wallet funding after its transfer fee.
60
+ *
61
+ * quoteCollateralCredit must be monotone and use one fixed curve snapshot,
62
+ * swap fees and the collateral transfer fee. Borrowed input is internal: do
63
+ * not apply a wallet input transfer fee to it. Cache/local quotes are preferred
64
+ * over a separate RPC per search iteration. This is a sizing estimate at the
65
+ * supplied price basis, not an admission check. Simulate the final instruction
66
+ * with previewLeverageAction for actual post-execution IM/MM, debt and payout.
67
+ */
68
+ export declare function planLeverageIncrease(input: {
69
+ state: LeverageActionState;
70
+ marginCredit?: bigint;
71
+ maxBorrowAmount: bigint;
72
+ targetLeverageBps?: bigint;
73
+ additionalCollateral?: bigint;
74
+ quoteCollateralCredit: LeveragePurchaseQuote;
75
+ }): Promise<{
76
+ targetLeverageBps: bigint;
77
+ atBorrowingBound: boolean;
78
+ requiresSimulation: true;
79
+ debtAmount: bigint;
80
+ marginCredit: bigint;
81
+ collateralCredit: bigint;
82
+ after: ReturnType<typeof leverageActionMetrics>;
83
+ }>;
84
+ /** Find the smallest sale which fully repays debt while retaining collateral.
85
+ * Same-snapshot, monotone quotes must report internal debt-token output after
86
+ * swap fees, before a possible transfer of unused output to the wallet.
87
+ */
88
+ export declare function planLeverageRepayAll(input: {
89
+ collateralAmount: bigint;
90
+ maxCollateralDebit: bigint;
91
+ fullRepayCredit: bigint;
92
+ quoteDebtOutput: (collateralDebit: bigint) => Promise<bigint>;
93
+ }): Promise<{
94
+ collateralAmount: bigint;
95
+ minRepayOut: bigint;
96
+ maxSurplusOut: bigint;
97
+ requiresSimulation: true;
98
+ }>;
99
+ /** Link a lower whole-position leverage target to the smallest collateral sale.
100
+ * Uses the same sizing-only price basis and fixed-snapshot quote contract as
101
+ * planLeverageIncrease. Exact share repayment determines the refund bound.
102
+ * The supplied maximum must bracket a target-reaching sale; price impact can
103
+ * make a larger endpoint miss even when a smaller sale would work. In that
104
+ * case, narrow the bracket using local quotes rather than inferring insolvency.
105
+ */
106
+ export declare function planLeverageDecrease(input: {
107
+ state: LeverageActionState;
108
+ targetLeverageBps: bigint;
109
+ maxCollateralDebit: bigint;
110
+ positionShares: bigint;
111
+ aggregateShares: bigint;
112
+ borrowIndexNad: bigint;
113
+ quoteDebtOutput: (collateralDebit: bigint) => Promise<bigint>;
114
+ }): Promise<{
115
+ targetLeverageBps: bigint;
116
+ requiresSimulation: true;
117
+ collateralAmount: bigint;
118
+ minRepayOut: bigint;
119
+ maxSurplusOut: bigint;
120
+ after: ReturnType<typeof leverageActionMetrics>;
121
+ }>;
122
+ //# sourceMappingURL=leverage-actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leverage-actions.d.ts","sourceRoot":"","sources":["../src/leverage-actions.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB;;;;;sBAR5C,MAAM;IACxB,yEAAyE;gBAC7D,MAAM;IAClB;8EAC0E;qBACzD,MAAM;EAYxB;AAED;gFACgF;AAChF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CAC5F;;;;;;EAmBA;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CACjH;;;;;;;EAeA;AAED;oFACoF;AACpF,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;;;EAOvF;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE,mBAAmB,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,qBAAqB,CAAC;CACzG;;;;gBAWgC,MAAM;kBAAgB,MAAM;sBAAoB,MAAM;WAC5E,UAAU,CAAC,OAAO,qBAAqB,CAAC;GAgClD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAC9E,eAAe,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;;;;;GAYA;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE,mBAAmB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAClF,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IACxE,eAAe,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;;;sBAMsC,MAAM;iBAAe,MAAM;mBAAiB,MAAM;WAC9E,UAAU,CAAC,OAAO,qBAAqB,CAAC;GAsBlD"}
@@ -0,0 +1,228 @@
1
+ /** Position actions use the borrowed token as their unit of account on BOTH
2
+ * sides. A reverse position is long the held token against the borrowed token;
3
+ * this leverage is not a dollar-denominated perpetual's short delta.
4
+ */
5
+ const BPS = 10000n;
6
+ const NAD = 1000000000n;
7
+ const U64_MAX = (1n << 64n) - 1n;
8
+ const U128_MAX = (1n << 128n) - 1n;
9
+ const ceilDiv = (a, b) => (a + b - 1n) / b;
10
+ function unsigned(value, name, max = U64_MAX) {
11
+ if (typeof value !== "bigint" || value < 0n || value > max)
12
+ throw new RangeError(`${name} must be an unsigned integer no greater than ${max}`);
13
+ return value;
14
+ }
15
+ export function leverageActionMetrics(state) {
16
+ for (const [name, value] of Object.entries(state))
17
+ unsigned(value, name);
18
+ const equity = state.collateralValue - state.debtAmount;
19
+ return {
20
+ ...state, equity,
21
+ leverageBps: equity > 0n ? ceilDiv(state.collateralValue * BPS, equity) : null,
22
+ debtFree: state.debtAmount === 0n,
23
+ unitOfAccount: "debt-token",
24
+ };
25
+ }
26
+ /** Matches the program's aggregate-floor-aware debt-share burn. Do not infer
27
+ * a full repayment from a rounded UI debt amount: it can need one more atom. */
28
+ export function leverageRepaymentQuote(input) {
29
+ const { positionShares: shares, aggregateShares: aggregate, borrowIndexNad: index, maxCredit } = input;
30
+ unsigned(shares, "positionShares", U128_MAX);
31
+ unsigned(aggregate, "aggregateShares", U128_MAX);
32
+ unsigned(index, "borrowIndexNad", U128_MAX);
33
+ unsigned(maxCredit, "maxCredit");
34
+ if (aggregate < shares || index < NAD)
35
+ throw new RangeError("Invalid aggregate shares or borrow index");
36
+ const debtAt = (s) => s * index / NAD;
37
+ const debtBefore = debtAt(shares);
38
+ const fullRepayCredit = debtAt(aggregate) - debtAt(aggregate - shares);
39
+ unsigned(debtBefore, "debtAmount");
40
+ unsigned(fullRepayCredit, "fullRepayCredit");
41
+ if (shares === 0n || maxCredit === 0n)
42
+ return {
43
+ sharesBurned: 0n, cashRepaid: 0n, debtReduced: 0n, debtRemaining: debtBefore, fullRepayCredit,
44
+ };
45
+ let burned = maxCredit * NAD / index;
46
+ if (burned > shares)
47
+ burned = shares;
48
+ if (burned < shares && debtAt(aggregate) - debtAt(aggregate - burned - 1n) <= maxCredit)
49
+ burned++;
50
+ const cashRepaid = debtAt(aggregate) - debtAt(aggregate - burned);
51
+ if (burned === 0n || cashRepaid === 0n)
52
+ throw new RangeError("Repayment is below debt-share granularity");
53
+ const debtRemaining = debtAt(shares - burned);
54
+ return { sharesBurned: burned, cashRepaid, debtReduced: debtBefore - debtRemaining, debtRemaining, fullRepayCredit };
55
+ }
56
+ /** Exact slice selection used by owner and delegated partial closes. */
57
+ export function leverageCloseSlice(input) {
58
+ const { collateralAmount, debtShares, aggregateShares, borrowIndexNad, closeBps } = input;
59
+ unsigned(collateralAmount, "collateralAmount");
60
+ unsigned(debtShares, "debtShares", U128_MAX);
61
+ if (!Number.isSafeInteger(closeBps) || closeBps < 1 || closeBps > 10_000 || collateralAmount === 0n)
62
+ throw new RangeError("A close requires collateral and 1..10000 closeBps");
63
+ const collateralDebit = collateralAmount * BigInt(closeBps) / BPS;
64
+ if (collateralDebit === 0n)
65
+ throw new RangeError("Close amount rounds to zero");
66
+ const sharesToBurn = ceilDiv(debtShares * collateralDebit, collateralAmount);
67
+ if (closeBps < 10_000 && debtShares > 0n && sharesToBurn >= debtShares)
68
+ throw new RangeError("Partial close would clear all debt shares; choose full close or decrease size");
69
+ const { fullRepayCredit: debtRepayment } = leverageRepaymentQuote({
70
+ positionShares: sharesToBurn, aggregateShares, borrowIndexNad, maxCredit: U64_MAX,
71
+ });
72
+ return { closeBps, collateralDebit, sharesToBurn, debtRepayment,
73
+ remainingCollateral: collateralAmount - collateralDebit, remainingDebtShares: debtShares - sharesToBurn };
74
+ }
75
+ /** Link a held-token size input to percentage without closing more than asked.
76
+ * The returned actual debit may be smaller because on-chain percentages use bps. */
77
+ export function leverageClosePercentage(collateralAmount, requestedDebit) {
78
+ unsigned(collateralAmount, "collateralAmount");
79
+ unsigned(requestedDebit, "requestedDebit");
80
+ if (collateralAmount === 0n || requestedDebit === 0n || requestedDebit > collateralAmount)
81
+ throw new RangeError("Requested close must be within the position");
82
+ const closeBps = Number(requestedDebit * BPS / collateralAmount);
83
+ if (closeBps === 0)
84
+ throw new RangeError("Requested size is below one basis point of the position");
85
+ return { closeBps, collateralDebit: collateralAmount * BigInt(closeBps) / BPS };
86
+ }
87
+ /** Link target leverage OR additional held-token size to borrowing. The default
88
+ * target is CURRENT WHOLE-position leverage, never leverage of just the added
89
+ * slice. marginCredit is net wallet funding after its transfer fee.
90
+ *
91
+ * quoteCollateralCredit must be monotone and use one fixed curve snapshot,
92
+ * swap fees and the collateral transfer fee. Borrowed input is internal: do
93
+ * not apply a wallet input transfer fee to it. Cache/local quotes are preferred
94
+ * over a separate RPC per search iteration. This is a sizing estimate at the
95
+ * supplied price basis, not an admission check. Simulate the final instruction
96
+ * with previewLeverageAction for actual post-execution IM/MM, debt and payout.
97
+ */
98
+ export async function planLeverageIncrease(input) {
99
+ const before = leverageActionMetrics(input.state);
100
+ if (before.equity <= 0n || before.collateralAmount === 0n)
101
+ throw new RangeError("Position must have positive equity and collateral");
102
+ const marginCredit = unsigned(input.marginCredit ?? 0n, "marginCredit");
103
+ let hi = unsigned(input.maxBorrowAmount, "maxBorrowAmount");
104
+ if (marginCredit + hi > U64_MAX)
105
+ throw new RangeError("Combined input exceeds u64");
106
+ if (input.additionalCollateral !== undefined && input.targetLeverageBps !== undefined)
107
+ throw new Error("Select a target leverage OR an additional collateral size");
108
+ const target = input.targetLeverageBps ?? before.leverageBps;
109
+ unsigned(target, "targetLeverageBps");
110
+ if (target < BPS)
111
+ throw new RangeError("Asset-relative leverage must be at least 1x");
112
+ const cache = new Map();
113
+ async function candidate(debtAmount) {
114
+ const cached = cache.get(debtAmount);
115
+ if (cached)
116
+ return cached;
117
+ const total = marginCredit + debtAmount;
118
+ const collateralCredit = total === 0n ? 0n : unsigned(await input.quoteCollateralCredit(total), "collateralCredit");
119
+ const collateralAmount = unsigned(before.collateralAmount + collateralCredit, "resultingCollateral");
120
+ const collateralValue = unsigned(collateralAmount * before.collateralValue / before.collateralAmount, "resultingValue");
121
+ const result = { debtAmount, marginCredit, collateralCredit,
122
+ after: leverageActionMetrics({ collateralAmount, collateralValue, debtAmount: unsigned(before.debtAmount + debtAmount, "resultingDebt") }) };
123
+ cache.set(debtAmount, result);
124
+ return result;
125
+ }
126
+ let lo = 0n;
127
+ if (input.additionalCollateral !== undefined) {
128
+ const wanted = unsigned(input.additionalCollateral, "additionalCollateral");
129
+ if (wanted === 0n || (await candidate(lo)).collateralCredit > wanted)
130
+ throw new RangeError("Size is smaller than the wallet-funded purchase");
131
+ if ((await candidate(hi)).collateralCredit < wanted)
132
+ throw new RangeError("Size exceeds the borrowing bound");
133
+ while (lo < hi) {
134
+ const mid = (lo + hi) / 2n;
135
+ if ((await candidate(mid)).collateralCredit >= wanted)
136
+ hi = mid;
137
+ else
138
+ lo = mid + 1n;
139
+ }
140
+ }
141
+ else {
142
+ const fits = (c) => c.after.equity > 0n && c.after.collateralValue * BPS <= target * c.after.equity;
143
+ if (!fits(await candidate(0n)))
144
+ throw new RangeError("Target requires more margin or a separate decrease-size action");
145
+ while (lo < hi) {
146
+ const mid = (lo + hi + 1n) / 2n;
147
+ if (fits(await candidate(mid)))
148
+ lo = mid;
149
+ else
150
+ hi = mid - 1n;
151
+ }
152
+ }
153
+ return { ...await candidate(lo), targetLeverageBps: target,
154
+ atBorrowingBound: lo === input.maxBorrowAmount, requiresSimulation: true };
155
+ }
156
+ /** Find the smallest sale which fully repays debt while retaining collateral.
157
+ * Same-snapshot, monotone quotes must report internal debt-token output after
158
+ * swap fees, before a possible transfer of unused output to the wallet.
159
+ */
160
+ export async function planLeverageRepayAll(input) {
161
+ const { collateralAmount, maxCollateralDebit, fullRepayCredit } = input;
162
+ for (const [name, value] of Object.entries({ collateralAmount, maxCollateralDebit, fullRepayCredit }))
163
+ unsigned(value, name);
164
+ if (fullRepayCredit === 0n || maxCollateralDebit === 0n || maxCollateralDebit >= collateralAmount)
165
+ throw new RangeError("Repay-all requires debt and must leave some collateral");
166
+ let lo = 1n, hi = maxCollateralDebit;
167
+ const quote = async (amount) => unsigned(await input.quoteDebtOutput(amount), "debtOutput");
168
+ if (await quote(hi) < fullRepayCredit)
169
+ throw new RangeError("Collateral limit cannot fully repay debt");
170
+ while (lo < hi) {
171
+ const mid = (lo + hi) / 2n;
172
+ if (await quote(mid) >= fullRepayCredit)
173
+ hi = mid;
174
+ else
175
+ lo = mid + 1n;
176
+ }
177
+ const output = await quote(lo);
178
+ return { collateralAmount: lo, minRepayOut: fullRepayCredit,
179
+ maxSurplusOut: output - fullRepayCredit, requiresSimulation: true };
180
+ }
181
+ /** Link a lower whole-position leverage target to the smallest collateral sale.
182
+ * Uses the same sizing-only price basis and fixed-snapshot quote contract as
183
+ * planLeverageIncrease. Exact share repayment determines the refund bound.
184
+ * The supplied maximum must bracket a target-reaching sale; price impact can
185
+ * make a larger endpoint miss even when a smaller sale would work. In that
186
+ * case, narrow the bracket using local quotes rather than inferring insolvency.
187
+ */
188
+ export async function planLeverageDecrease(input) {
189
+ const before = leverageActionMetrics(input.state);
190
+ const target = unsigned(input.targetLeverageBps, "targetLeverageBps");
191
+ let lo = 0n, hi = unsigned(input.maxCollateralDebit, "maxCollateralDebit");
192
+ if (before.leverageBps === null || before.debtFree || target < BPS || target >= before.leverageBps || hi >= before.collateralAmount)
193
+ throw new RangeError("Choose a lower leverage of at least 1x and leave some collateral");
194
+ const cache = new Map();
195
+ async function candidate(debit) {
196
+ const cached = cache.get(debit);
197
+ if (cached)
198
+ return cached;
199
+ const output = debit === 0n ? 0n : unsigned(await input.quoteDebtOutput(debit), "debtOutput");
200
+ let repayment;
201
+ try {
202
+ repayment = leverageRepaymentQuote({ ...input, maxCredit: output });
203
+ }
204
+ catch (error) {
205
+ if (!(error instanceof RangeError) || !error.message.includes("granularity"))
206
+ throw error;
207
+ repayment = { cashRepaid: 0n, debtRemaining: before.debtAmount, debtReduced: 0n };
208
+ }
209
+ const collateralAmount = before.collateralAmount - debit;
210
+ const result = { collateralAmount: debit, minRepayOut: repayment.cashRepaid, maxSurplusOut: output - repayment.cashRepaid,
211
+ after: leverageActionMetrics({ collateralAmount, debtAmount: repayment.debtRemaining,
212
+ collateralValue: collateralAmount * before.collateralValue / before.collateralAmount }) };
213
+ cache.set(debit, result);
214
+ return result;
215
+ }
216
+ const reaches = (c) => c.minRepayOut > 0n && c.after.equity > 0n && c.after.collateralValue * BPS <= target * c.after.equity;
217
+ if (!reaches(await candidate(hi)))
218
+ throw new RangeError("Target leverage is not bracketed at this sale limit; try a smaller limit or inspect local quotes");
219
+ while (lo < hi) {
220
+ const mid = (lo + hi) / 2n;
221
+ if (reaches(await candidate(mid)))
222
+ hi = mid;
223
+ else
224
+ lo = mid + 1n;
225
+ }
226
+ return { ...await candidate(lo), targetLeverageBps: target, requiresSimulation: true };
227
+ }
228
+ //# sourceMappingURL=leverage-actions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leverage-actions.js","sourceRoot":"","sources":["../src/leverage-actions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { LeveragePosition } from "./type-aliases.js";
2
+ /** Read the position's stored requirements without repricing from live crowding.
3
+ * These rates are not actual equity, a liquidation price, or an executable
4
+ * opening/increase quote. Simulate the intended transaction for new risk.
5
+ */
6
+ export declare function getStoredLeverageMargins(position: Pick<LeveragePosition, "collateralAmount" | "marginTerms">): {
7
+ initialMarginBps: number;
8
+ maintenanceMarginBps: number;
9
+ referenceCollateral: bigint;
10
+ admissionEquityCollateralNad: bigint;
11
+ };
12
+ //# sourceMappingURL=leverage-margins.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leverage-margins.d.ts","sourceRoot":"","sources":["../src/leverage-margins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,aAAa,CAAC;;;;;EAkCrE"}