@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.
Files changed (187) hide show
  1. package/README.md +863 -42
  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 +68 -27
  7. package/dist/constants.d.ts.map +1 -1
  8. package/dist/constants.js +153 -41
  9. package/dist/constants.js.map +1 -1
  10. package/dist/delegate.d.ts +97 -0
  11. package/dist/delegate.d.ts.map +1 -0
  12. package/dist/delegate.js +152 -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 +3033 -385
  19. package/dist/get.d.ts.map +1 -1
  20. package/dist/get.js +109 -72
  21. package/dist/get.js.map +1 -1
  22. package/dist/hash.d.ts +9 -0
  23. package/dist/hash.d.ts.map +1 -0
  24. package/dist/hash.js +16 -0
  25. package/dist/hash.js.map +1 -0
  26. package/dist/hlp-liquidation-client.d.ts +104 -0
  27. package/dist/hlp-liquidation-client.d.ts.map +1 -0
  28. package/dist/hlp-liquidation-client.js +146 -0
  29. package/dist/hlp-liquidation-client.js.map +1 -0
  30. package/dist/idl_delegate.d.ts +3 -0
  31. package/dist/idl_delegate.d.ts.map +1 -0
  32. package/dist/idl_delegate.js +3 -0
  33. package/dist/idl_delegate.js.map +1 -0
  34. package/dist/idl_delegate.json +6268 -0
  35. package/dist/idl_v2.json +16746 -6676
  36. package/dist/index.d.ts +23 -0
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +23 -0
  39. package/dist/index.js.map +1 -1
  40. package/dist/interest-accounting.d.ts +45 -0
  41. package/dist/interest-accounting.d.ts.map +1 -0
  42. package/dist/interest-accounting.js +59 -0
  43. package/dist/interest-accounting.js.map +1 -0
  44. package/dist/leverage-actions.d.ts +122 -0
  45. package/dist/leverage-actions.d.ts.map +1 -0
  46. package/dist/leverage-actions.js +228 -0
  47. package/dist/leverage-actions.js.map +1 -0
  48. package/dist/leverage-margins.d.ts +12 -0
  49. package/dist/leverage-margins.d.ts.map +1 -0
  50. package/dist/leverage-margins.js +45 -0
  51. package/dist/leverage-margins.js.map +1 -0
  52. package/dist/leverage-preview.d.ts +598 -0
  53. package/dist/leverage-preview.d.ts.map +1 -0
  54. package/dist/leverage-preview.js +89 -0
  55. package/dist/leverage-preview.js.map +1 -0
  56. package/dist/liquidation-client.d.ts +226 -0
  57. package/dist/liquidation-client.d.ts.map +1 -0
  58. package/dist/liquidation-client.js +237 -0
  59. package/dist/liquidation-client.js.map +1 -0
  60. package/dist/liquidation.d.ts +72 -0
  61. package/dist/liquidation.d.ts.map +1 -0
  62. package/dist/liquidation.js +104 -0
  63. package/dist/liquidation.js.map +1 -0
  64. package/dist/lp-naming.d.ts +43 -0
  65. package/dist/lp-naming.d.ts.map +1 -0
  66. package/dist/lp-naming.js +81 -0
  67. package/dist/lp-naming.js.map +1 -0
  68. package/dist/lp-vanity.d.ts +33 -0
  69. package/dist/lp-vanity.d.ts.map +1 -0
  70. package/dist/lp-vanity.js +94 -0
  71. package/dist/lp-vanity.js.map +1 -0
  72. package/dist/market-bootstrap.d.ts +109 -0
  73. package/dist/market-bootstrap.d.ts.map +1 -0
  74. package/dist/market-bootstrap.js +156 -0
  75. package/dist/market-bootstrap.js.map +1 -0
  76. package/dist/market-launch.d.ts +45 -0
  77. package/dist/market-launch.d.ts.map +1 -0
  78. package/dist/market-launch.js +76 -0
  79. package/dist/market-launch.js.map +1 -0
  80. package/dist/operator-client.d.ts +99 -0
  81. package/dist/operator-client.d.ts.map +1 -0
  82. package/dist/operator-client.js +153 -0
  83. package/dist/operator-client.js.map +1 -0
  84. package/dist/oracle.d.ts +46 -0
  85. package/dist/oracle.d.ts.map +1 -0
  86. package/dist/oracle.js +103 -0
  87. package/dist/oracle.js.map +1 -0
  88. package/dist/parameters.d.ts +231 -0
  89. package/dist/parameters.d.ts.map +1 -0
  90. package/dist/parameters.js +683 -0
  91. package/dist/parameters.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 +12 -0
  101. package/dist/risk-pricing.d.ts.map +1 -0
  102. package/dist/risk-pricing.js +23 -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 +265 -31
  117. package/dist/type-aliases.d.ts.map +1 -1
  118. package/dist/types_delegate.d.ts +6275 -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 +16654 -6584
  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 +619 -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 +1263 -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 +427 -0
  141. package/dist/write.d.ts.map +1 -1
  142. package/dist/write.js +970 -26
  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 +11 -4
  149. package/src/amounts.ts +13 -0
  150. package/src/constants.ts +220 -46
  151. package/src/delegate.ts +259 -0
  152. package/src/dusk.ts +28 -0
  153. package/src/get.ts +201 -86
  154. package/src/hash.ts +15 -0
  155. package/src/hlp-liquidation-client.ts +189 -0
  156. package/src/idl_delegate.json +6268 -0
  157. package/src/idl_delegate.ts +3 -0
  158. package/src/idl_v2.json +16746 -6676
  159. package/src/index.ts +31 -0
  160. package/src/interest-accounting.ts +73 -0
  161. package/src/leverage-actions.ts +216 -0
  162. package/src/leverage-margins.ts +48 -0
  163. package/src/leverage-preview.ts +86 -0
  164. package/src/liquidation-client.ts +295 -0
  165. package/src/liquidation.ts +119 -0
  166. package/src/lp-naming.ts +127 -0
  167. package/src/lp-vanity.ts +135 -0
  168. package/src/market-bootstrap.ts +271 -0
  169. package/src/market-launch.ts +103 -0
  170. package/src/operator-client.ts +169 -0
  171. package/src/oracle.ts +120 -0
  172. package/src/parameters.ts +1019 -0
  173. package/src/preview.ts +53 -1
  174. package/src/protection.ts +112 -0
  175. package/src/risk-pricing.ts +26 -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 +294 -32
  180. package/src/types_delegate.ts +6274 -0
  181. package/src/types_v2.ts +16745 -6675
  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 +1650 -28
  187. package/src/yield-client.ts +117 -0
package/src/oracle.ts ADDED
@@ -0,0 +1,120 @@
1
+ import { ComputeBudgetProgram, PublicKey, type AccountMeta } from "@solana/web3.js";
2
+ import type { BN } from "@coral-xyz/anchor";
3
+ import { address, type AddressLike } from "./address.js";
4
+ import { integerBN, type IntegerLike } from "./parameters.js";
5
+
6
+ export const NORMALIZED_ORACLE_V1 = 1;
7
+ export const PYTH_RATIO_V2 = 2;
8
+ export const PYTH_DIRECT_V3 = 3;
9
+ export const NORMALIZED_RATIO_V4 = 4;
10
+
11
+ /** Whether the pinned source composes two independently validated asset feeds. */
12
+ export function oracleUsesTwoFeeds(format: number): boolean {
13
+ return format === PYTH_RATIO_V2 || format === NORMALIZED_RATIO_V4;
14
+ }
15
+ export const PYTH_RECEIVER_PROGRAM = new PublicKey("rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ");
16
+
17
+ export interface OraclePolicyInput {
18
+ format: number;
19
+ provider: AddressLike;
20
+ baseAccount: AddressLike;
21
+ quoteAccount: AddressLike;
22
+ baseFeedId: readonly number[] | Uint8Array;
23
+ quoteFeedId: readonly number[] | Uint8Array;
24
+ lambdaBps: number;
25
+ adjustmentCapNad: IntegerLike;
26
+ maxAgeSeconds: number;
27
+ maxAgeSlots: IntegerLike;
28
+ maxConfidenceBps: number;
29
+ maxPublishSkewSeconds: number;
30
+ }
31
+ export interface OraclePolicy extends Omit<OraclePolicyInput,
32
+ "provider" | "baseAccount" | "quoteAccount" | "baseFeedId" | "quoteFeedId" | "adjustmentCapNad" | "maxAgeSlots"> {
33
+ provider: PublicKey;
34
+ baseAccount: PublicKey;
35
+ quoteAccount: PublicKey;
36
+ baseFeedId: number[];
37
+ quoteFeedId: number[];
38
+ adjustmentCapNad: BN;
39
+ maxAgeSlots: BN;
40
+ }
41
+
42
+ /** Validate the policy's mathematical bounds and source identity for any market. */
43
+ export function oraclePolicy(input: OraclePolicyInput): OraclePolicy {
44
+ const integer = (n: number, max: number, label: string) => {
45
+ if (!Number.isInteger(n) || n < 0 || n > max) throw new Error(`invalid ${label}`);
46
+ return n;
47
+ };
48
+ const id = (v: readonly number[] | Uint8Array) => {
49
+ if (v.length !== 32 || Array.from(v).some(n => !Number.isInteger(n) || n < 0 || n > 255))
50
+ throw new Error("oracle feed id must contain 32 bytes");
51
+ return Array.from(v);
52
+ };
53
+ const policy: OraclePolicy = {
54
+ format: integer(input.format, 255, "oracle format"), provider: address(input.provider),
55
+ baseAccount: address(input.baseAccount), quoteAccount: address(input.quoteAccount),
56
+ baseFeedId: id(input.baseFeedId), quoteFeedId: id(input.quoteFeedId),
57
+ lambdaBps: integer(input.lambdaBps, 9999, "lambdaBps"),
58
+ adjustmentCapNad: integerBN(input.adjustmentCapNad, "adjustmentCapNad"),
59
+ maxAgeSeconds: integer(input.maxAgeSeconds, 0xffff_ffff, "maxAgeSeconds"),
60
+ maxAgeSlots: integerBN(input.maxAgeSlots, "maxAgeSlots"),
61
+ maxConfidenceBps: integer(input.maxConfidenceBps, 9999, "maxConfidenceBps"),
62
+ maxPublishSkewSeconds: integer(input.maxPublishSkewSeconds, 0xffff_ffff, "maxPublishSkewSeconds"),
63
+ };
64
+ const zero = PublicKey.default;
65
+ const emptyId = (v: number[]) => v.every(n => n === 0);
66
+ if (policy.format === 0 && policy.lambdaBps === 0 && policy.provider.equals(zero)
67
+ && policy.baseAccount.equals(zero) && policy.quoteAccount.equals(zero)
68
+ && emptyId(policy.baseFeedId) && emptyId(policy.quoteFeedId) && policy.adjustmentCapNad.isZero()
69
+ && policy.maxAgeSeconds === 0 && policy.maxAgeSlots.isZero() && policy.maxConfidenceBps === 0
70
+ && policy.maxPublishSkewSeconds === 0) return policy;
71
+ if (BigInt(policy.adjustmentCapNad.toString()) <= 1_000_000_000n || policy.maxAgeSeconds === 0
72
+ || policy.maxAgeSlots.isZero() || policy.provider.equals(zero) || policy.baseAccount.equals(zero)
73
+ || emptyId(policy.baseFeedId)) throw new Error("invalid oracle policy");
74
+ if (![NORMALIZED_ORACLE_V1, PYTH_RATIO_V2, PYTH_DIRECT_V3, NORMALIZED_RATIO_V4].includes(policy.format))
75
+ throw new Error("unsupported oracle format");
76
+ if ((policy.format === PYTH_RATIO_V2 || policy.format === PYTH_DIRECT_V3)
77
+ && !policy.provider.equals(PYTH_RECEIVER_PROGRAM)) throw new Error("Pyth requires the verified receiver program");
78
+ if (oracleUsesTwoFeeds(policy.format)) {
79
+ if (policy.quoteAccount.equals(zero) || policy.baseAccount.equals(policy.quoteAccount)
80
+ || emptyId(policy.quoteFeedId) || policy.baseFeedId.every((v, i) => v === policy.quoteFeedId[i]))
81
+ throw new Error("ratio requires two distinct feeds with a common denomination");
82
+ } else if (!policy.quoteAccount.equals(zero) || !emptyId(policy.quoteFeedId) || policy.maxPublishSkewSeconds !== 0)
83
+ throw new Error("direct report must identify one pair account");
84
+ return policy;
85
+ }
86
+
87
+ /** Zero weight has no feed-account dependency, even with a retained source policy. */
88
+ export function oracleReadAccounts(policy?: OraclePolicyInput): AccountMeta[] {
89
+ if (!policy || policy.lambdaBps === 0) return [];
90
+ const checked = oraclePolicy(policy);
91
+ return [checked.baseAccount, ...(oracleUsesTwoFeeds(checked.format) ? [checked.quoteAccount] : [])]
92
+ .map(pubkey => ({ pubkey, isSigner: false, isWritable: false }));
93
+ }
94
+
95
+ /** Add once before composing positive-weight instructions. Raw instruction
96
+ * builders cannot attach a transaction budget. Index-bound flash plans must
97
+ * include these before their indices are bound; simulate the complete route.
98
+ */
99
+ export function oracleComputeBudgetInstructions(policy?: Pick<OraclePolicyInput, "lambdaBps">) {
100
+ return policy && policy.lambdaBps > 0 ? [
101
+ ComputeBudgetProgram.requestHeapFrame({ bytes: 256 * 1024 }),
102
+ ComputeBudgetProgram.setComputeUnitLimit({ units: 1_400_000 }),
103
+ ] : [];
104
+ }
105
+
106
+ /** Exact Borsh OraclePolicy payload, also used in proposal digests. */
107
+ export function encodeOraclePolicy(input: OraclePolicyInput): Uint8Array {
108
+ const p = oraclePolicy(input);
109
+ const data = Buffer.alloc(189);
110
+ let offset = 0;
111
+ const bytes = (v: Uint8Array | number[]) => { data.set(v, offset); offset += v.length; };
112
+ const u16 = (v: number) => { data.writeUInt16LE(v, offset); offset += 2; };
113
+ const u32 = (v: number) => { data.writeUInt32LE(v, offset); offset += 4; };
114
+ const u64 = (v: BN) => { data.writeBigUInt64LE(BigInt(v.toString()), offset); offset += 8; };
115
+ data[offset++] = p.format;
116
+ bytes(p.provider.toBytes()); bytes(p.baseAccount.toBytes()); bytes(p.quoteAccount.toBytes());
117
+ bytes(p.baseFeedId); bytes(p.quoteFeedId); u16(p.lambdaBps); u64(p.adjustmentCapNad);
118
+ u32(p.maxAgeSeconds); u64(p.maxAgeSlots); u16(p.maxConfidenceBps); u32(p.maxPublishSkewSeconds);
119
+ return data;
120
+ }