@omnipair/dusk-sdk 2.0.2 → 2.18.0-next.20261106
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.
- package/README.md +863 -42
- package/dist/amounts.d.ts +9 -0
- package/dist/amounts.d.ts.map +1 -0
- package/dist/amounts.js +10 -0
- package/dist/amounts.js.map +1 -0
- package/dist/constants.d.ts +68 -27
- package/dist/constants.d.ts.map +1 -1
- package/dist/constants.js +153 -41
- package/dist/constants.js.map +1 -1
- package/dist/delegate.d.ts +97 -0
- package/dist/delegate.d.ts.map +1 -0
- package/dist/delegate.js +152 -0
- package/dist/delegate.js.map +1 -0
- package/dist/dusk.d.ts +14 -0
- package/dist/dusk.d.ts.map +1 -1
- package/dist/dusk.js +22 -0
- package/dist/dusk.js.map +1 -1
- package/dist/get.d.ts +3033 -385
- package/dist/get.d.ts.map +1 -1
- package/dist/get.js +109 -72
- package/dist/get.js.map +1 -1
- package/dist/hash.d.ts +9 -0
- package/dist/hash.d.ts.map +1 -0
- package/dist/hash.js +16 -0
- package/dist/hash.js.map +1 -0
- package/dist/hlp-liquidation-client.d.ts +104 -0
- package/dist/hlp-liquidation-client.d.ts.map +1 -0
- package/dist/hlp-liquidation-client.js +146 -0
- package/dist/hlp-liquidation-client.js.map +1 -0
- package/dist/idl_delegate.d.ts +3 -0
- package/dist/idl_delegate.d.ts.map +1 -0
- package/dist/idl_delegate.js +3 -0
- package/dist/idl_delegate.js.map +1 -0
- package/dist/idl_delegate.json +6268 -0
- package/dist/idl_v2.json +16746 -6676
- package/dist/index.d.ts +23 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -1
- package/dist/interest-accounting.d.ts +45 -0
- package/dist/interest-accounting.d.ts.map +1 -0
- package/dist/interest-accounting.js +59 -0
- package/dist/interest-accounting.js.map +1 -0
- package/dist/leverage-actions.d.ts +122 -0
- package/dist/leverage-actions.d.ts.map +1 -0
- package/dist/leverage-actions.js +228 -0
- package/dist/leverage-actions.js.map +1 -0
- package/dist/leverage-margins.d.ts +12 -0
- package/dist/leverage-margins.d.ts.map +1 -0
- package/dist/leverage-margins.js +45 -0
- package/dist/leverage-margins.js.map +1 -0
- package/dist/leverage-preview.d.ts +598 -0
- package/dist/leverage-preview.d.ts.map +1 -0
- package/dist/leverage-preview.js +89 -0
- package/dist/leverage-preview.js.map +1 -0
- package/dist/liquidation-client.d.ts +226 -0
- package/dist/liquidation-client.d.ts.map +1 -0
- package/dist/liquidation-client.js +237 -0
- package/dist/liquidation-client.js.map +1 -0
- package/dist/liquidation.d.ts +72 -0
- package/dist/liquidation.d.ts.map +1 -0
- package/dist/liquidation.js +104 -0
- package/dist/liquidation.js.map +1 -0
- package/dist/lp-naming.d.ts +43 -0
- package/dist/lp-naming.d.ts.map +1 -0
- package/dist/lp-naming.js +81 -0
- package/dist/lp-naming.js.map +1 -0
- package/dist/lp-vanity.d.ts +33 -0
- package/dist/lp-vanity.d.ts.map +1 -0
- package/dist/lp-vanity.js +94 -0
- package/dist/lp-vanity.js.map +1 -0
- package/dist/market-bootstrap.d.ts +109 -0
- package/dist/market-bootstrap.d.ts.map +1 -0
- package/dist/market-bootstrap.js +156 -0
- package/dist/market-bootstrap.js.map +1 -0
- package/dist/market-launch.d.ts +45 -0
- package/dist/market-launch.d.ts.map +1 -0
- package/dist/market-launch.js +76 -0
- package/dist/market-launch.js.map +1 -0
- package/dist/operator-client.d.ts +99 -0
- package/dist/operator-client.d.ts.map +1 -0
- package/dist/operator-client.js +153 -0
- package/dist/operator-client.js.map +1 -0
- package/dist/oracle.d.ts +46 -0
- package/dist/oracle.d.ts.map +1 -0
- package/dist/oracle.js +103 -0
- package/dist/oracle.js.map +1 -0
- package/dist/parameters.d.ts +231 -0
- package/dist/parameters.d.ts.map +1 -0
- package/dist/parameters.js +683 -0
- package/dist/parameters.js.map +1 -0
- package/dist/preview.d.ts +39 -1
- package/dist/preview.d.ts.map +1 -1
- package/dist/preview.js +12 -0
- package/dist/preview.js.map +1 -1
- package/dist/protection.d.ts +48 -0
- package/dist/protection.d.ts.map +1 -0
- package/dist/protection.js +88 -0
- package/dist/protection.js.map +1 -0
- package/dist/risk-pricing.d.ts +12 -0
- package/dist/risk-pricing.d.ts.map +1 -0
- package/dist/risk-pricing.js +23 -0
- package/dist/risk-pricing.js.map +1 -0
- package/dist/simulation.d.ts +45 -0
- package/dist/simulation.d.ts.map +1 -0
- package/dist/simulation.js +106 -0
- package/dist/simulation.js.map +1 -0
- package/dist/tranche-client.d.ts +121 -0
- package/dist/tranche-client.d.ts.map +1 -0
- package/dist/tranche-client.js +185 -0
- package/dist/tranche-client.js.map +1 -0
- package/dist/transfer-fees.d.ts +46 -0
- package/dist/transfer-fees.d.ts.map +1 -0
- package/dist/transfer-fees.js +76 -0
- package/dist/transfer-fees.js.map +1 -0
- package/dist/type-aliases.d.ts +265 -31
- package/dist/type-aliases.d.ts.map +1 -1
- package/dist/types_delegate.d.ts +6275 -0
- package/dist/types_delegate.d.ts.map +1 -0
- package/dist/types_delegate.js +2 -0
- package/dist/types_delegate.js.map +1 -0
- package/dist/types_v2.d.ts +16654 -6584
- package/dist/types_v2.d.ts.map +1 -1
- package/dist/virtual-book/index.d.ts +4 -0
- package/dist/virtual-book/index.d.ts.map +1 -0
- package/dist/virtual-book/index.js +4 -0
- package/dist/virtual-book/index.js.map +1 -0
- package/dist/virtual-book/market.d.ts +619 -0
- package/dist/virtual-book/market.d.ts.map +1 -0
- package/dist/virtual-book/market.js +59 -0
- package/dist/virtual-book/market.js.map +1 -0
- package/dist/virtual-book/projection.d.ts +44 -0
- package/dist/virtual-book/projection.d.ts.map +1 -0
- package/dist/virtual-book/projection.js +229 -0
- package/dist/virtual-book/projection.js.map +1 -0
- package/dist/virtual-book/quotes.d.ts +1263 -0
- package/dist/virtual-book/quotes.d.ts.map +1 -0
- package/dist/virtual-book/quotes.js +233 -0
- package/dist/virtual-book/quotes.js.map +1 -0
- package/dist/write.d.ts +427 -0
- package/dist/write.d.ts.map +1 -1
- package/dist/write.js +970 -26
- package/dist/write.js.map +1 -1
- package/dist/yield-client.d.ts +51 -0
- package/dist/yield-client.d.ts.map +1 -0
- package/dist/yield-client.js +98 -0
- package/dist/yield-client.js.map +1 -0
- package/package.json +11 -4
- package/src/amounts.ts +13 -0
- package/src/constants.ts +220 -46
- package/src/delegate.ts +259 -0
- package/src/dusk.ts +28 -0
- package/src/get.ts +201 -86
- package/src/hash.ts +15 -0
- package/src/hlp-liquidation-client.ts +189 -0
- package/src/idl_delegate.json +6268 -0
- package/src/idl_delegate.ts +3 -0
- package/src/idl_v2.json +16746 -6676
- package/src/index.ts +31 -0
- package/src/interest-accounting.ts +73 -0
- package/src/leverage-actions.ts +216 -0
- package/src/leverage-margins.ts +48 -0
- package/src/leverage-preview.ts +86 -0
- package/src/liquidation-client.ts +295 -0
- package/src/liquidation.ts +119 -0
- package/src/lp-naming.ts +127 -0
- package/src/lp-vanity.ts +135 -0
- package/src/market-bootstrap.ts +271 -0
- package/src/market-launch.ts +103 -0
- package/src/operator-client.ts +169 -0
- package/src/oracle.ts +120 -0
- package/src/parameters.ts +1019 -0
- package/src/preview.ts +53 -1
- package/src/protection.ts +112 -0
- package/src/risk-pricing.ts +26 -0
- package/src/simulation.ts +169 -0
- package/src/tranche-client.ts +187 -0
- package/src/transfer-fees.ts +99 -0
- package/src/type-aliases.ts +294 -32
- package/src/types_delegate.ts +6274 -0
- package/src/types_v2.ts +16745 -6675
- package/src/virtual-book/index.ts +3 -0
- package/src/virtual-book/market.ts +76 -0
- package/src/virtual-book/projection.ts +265 -0
- package/src/virtual-book/quotes.ts +308 -0
- package/src/write.ts +1650 -28
- 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 "./parameters.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 "./operator-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
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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,sBAAsB,CAAC;AAErC,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 "./parameters.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 "./operator-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,sBAAsB,CAAC;AAErC,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,45 @@
|
|
|
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
|
+
/** Fund LP income using the historical unpaid fee book. Protocol and operator
|
|
15
|
+
* fees remain unpaid until borrower cash arrives. No current fee rate is used.
|
|
16
|
+
* Inputs must describe the same checkpointed market state. */
|
|
17
|
+
export declare function quoteInterestAdvanceAmounts(input: {
|
|
18
|
+
unpaidPublicInterest: bigint;
|
|
19
|
+
unpaidFeeInterest: bigint;
|
|
20
|
+
outstandingGrossAdvance: bigint;
|
|
21
|
+
outstandingRevenueEscrow: bigint;
|
|
22
|
+
reserveCash: bigint;
|
|
23
|
+
maxGross: bigint;
|
|
24
|
+
transferFee: TransferFeeNotice;
|
|
25
|
+
}): {
|
|
26
|
+
grossAdvance: bigint;
|
|
27
|
+
revenueEscrow: bigint;
|
|
28
|
+
lpVaultDebit: bigint;
|
|
29
|
+
lpVaultCredit: bigint;
|
|
30
|
+
transferFee: bigint;
|
|
31
|
+
};
|
|
32
|
+
/** Allocate measured custody credit against the frozen settlement budget.
|
|
33
|
+
* grossTransfer excludes LP yield already funded by an advance. pendingFeeGross
|
|
34
|
+
* includes both protocol and operator receivables. Recipient claims are settled
|
|
35
|
+
* by the on-chain fee book, including fractional cash from earlier payments. */
|
|
36
|
+
export declare function allocateRepaidInterest(input: {
|
|
37
|
+
grossTransfer: bigint;
|
|
38
|
+
pendingFeeGross: bigint;
|
|
39
|
+
measuredVaultCredit: bigint;
|
|
40
|
+
}): {
|
|
41
|
+
grossTransfer: bigint;
|
|
42
|
+
revenueCredit: bigint;
|
|
43
|
+
lpCredit: bigint;
|
|
44
|
+
};
|
|
45
|
+
//# 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;AAID;;8DAE8D;AAC9D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;CAChC;;;;;;EAaA;AAED;;;gFAGgF;AAChF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;;;;EAMA"}
|
|
@@ -0,0 +1,59 @@
|
|
|
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
|
+
/** Fund LP income using the historical unpaid fee book. Protocol and operator
|
|
29
|
+
* fees remain unpaid until borrower cash arrives. No current fee rate is used.
|
|
30
|
+
* Inputs must describe the same checkpointed market state. */
|
|
31
|
+
export function quoteInterestAdvanceAmounts(input) {
|
|
32
|
+
const { unpaidPublicInterest: unpaid, unpaidFeeInterest: fees, outstandingGrossAdvance: advanced, outstandingRevenueEscrow: escrow, reserveCash, maxGross } = input;
|
|
33
|
+
amount(unpaid, U128_MAX);
|
|
34
|
+
for (const value of [fees, advanced, escrow, reserveCash, maxGross])
|
|
35
|
+
amount(value);
|
|
36
|
+
if (advanced > unpaid || escrow > advanced || escrow > fees || fees > unpaid
|
|
37
|
+
|| fees - escrow > unpaid - advanced)
|
|
38
|
+
throw new RangeError("Inconsistent unpaid interest/advance");
|
|
39
|
+
const available = unpaid - advanced;
|
|
40
|
+
const grossAdvance = [available, reserveCash, maxGross].reduce((a, b) => a < b ? a : b);
|
|
41
|
+
const revenueEscrow = available === 0n ? 0n : grossAdvance * (fees - escrow) / available;
|
|
42
|
+
const lpVaultDebit = grossAdvance - revenueEscrow;
|
|
43
|
+
const lpVaultCredit = transferFeeCredit(lpVaultDebit, input.transferFee, "effective");
|
|
44
|
+
return { grossAdvance, revenueEscrow, lpVaultDebit, lpVaultCredit, transferFee: lpVaultDebit - lpVaultCredit };
|
|
45
|
+
}
|
|
46
|
+
/** Allocate measured custody credit against the frozen settlement budget.
|
|
47
|
+
* grossTransfer excludes LP yield already funded by an advance. pendingFeeGross
|
|
48
|
+
* includes both protocol and operator receivables. Recipient claims are settled
|
|
49
|
+
* by the on-chain fee book, including fractional cash from earlier payments. */
|
|
50
|
+
export function allocateRepaidInterest(input) {
|
|
51
|
+
const { grossTransfer, pendingFeeGross: fees, measuredVaultCredit: credit } = input;
|
|
52
|
+
for (const value of [grossTransfer, fees, credit])
|
|
53
|
+
amount(value);
|
|
54
|
+
if (credit > grossTransfer || fees > grossTransfer)
|
|
55
|
+
throw new RangeError("Custody credit or fees exceed settlement");
|
|
56
|
+
const revenueCredit = grossTransfer === 0n ? 0n : credit * fees / grossTransfer;
|
|
57
|
+
return { grossTransfer, revenueCredit, lpCredit: credit - revenueCredit };
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=interest-accounting.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interest-accounting.js","sourceRoot":"","sources":["../src/interest-accounting.ts"],"names":[],"mappings":"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"}
|
|
@@ -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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
const BPS = 10000n;
|
|
2
|
+
const NAD = 1000000000n;
|
|
3
|
+
const U64_MAX = (1n << 64n) - 1n;
|
|
4
|
+
const ceilDiv = (a, b) => (a + b - 1n) / b;
|
|
5
|
+
const min = (a, b) => a < b ? a : b;
|
|
6
|
+
/** Read the position's stored requirements without repricing from live crowding.
|
|
7
|
+
* These rates are not actual equity, a liquidation price, or an executable
|
|
8
|
+
* opening/increase quote. Simulate the intended transaction for new risk.
|
|
9
|
+
*/
|
|
10
|
+
export function getStoredLeverageMargins(position) {
|
|
11
|
+
const collateral = BigInt(position.collateralAmount.toString());
|
|
12
|
+
const terms = position.marginTerms;
|
|
13
|
+
const reference = BigInt(terms.referenceCollateral.toString());
|
|
14
|
+
const retained = BigInt(terms.admissionEquityCollateralNad.toString());
|
|
15
|
+
const [firstBps, secondBps] = terms.maintenanceBoundariesBps;
|
|
16
|
+
const [low, middle, high] = terms.maintenanceRatesBps;
|
|
17
|
+
const buffer = terms.entryBufferBps;
|
|
18
|
+
if (collateral <= 0n || collateral > U64_MAX || reference <= 0n || reference > U64_MAX ||
|
|
19
|
+
retained < 0n || retained >= (1n << 128n) ||
|
|
20
|
+
![firstBps, secondBps, low, middle, high, buffer].every(Number.isSafeInteger) ||
|
|
21
|
+
firstBps <= 0 || firstBps >= secondBps || secondBps > 65_535 ||
|
|
22
|
+
low <= 0 || low > middle || middle > high || buffer < 0 || high + buffer >= 10_000) {
|
|
23
|
+
throw new Error("Invalid stored leverage margin terms");
|
|
24
|
+
}
|
|
25
|
+
const amount = collateral * BPS;
|
|
26
|
+
const first = reference * BigInt(firstBps);
|
|
27
|
+
const second = reference * BigInt(secondBps);
|
|
28
|
+
const aboveFirst = amount > first ? amount - first : 0n;
|
|
29
|
+
const aboveSecond = amount > second ? amount - second : 0n;
|
|
30
|
+
const weighted = min(amount, first) * BigInt(low)
|
|
31
|
+
+ min(aboveFirst, second - first) * BigInt(middle)
|
|
32
|
+
+ aboveSecond * BigInt(high);
|
|
33
|
+
const maintenanceMarginBps = Number(ceilDiv(weighted, amount));
|
|
34
|
+
const retainedBps = ceilDiv(retained * BPS, collateral * NAD);
|
|
35
|
+
if (retainedBps >= BPS)
|
|
36
|
+
throw new Error("Stored admission requirement leaves no leverage capacity");
|
|
37
|
+
const initialMarginBps = Math.max(maintenanceMarginBps + buffer, Number(retainedBps));
|
|
38
|
+
return {
|
|
39
|
+
initialMarginBps,
|
|
40
|
+
maintenanceMarginBps,
|
|
41
|
+
referenceCollateral: reference,
|
|
42
|
+
admissionEquityCollateralNad: retained,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=leverage-margins.js.map
|