@epicentral/sos-sdk 0.9.0-beta

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 (113) hide show
  1. package/.env.example +1 -0
  2. package/AGENTS.md +7 -0
  3. package/LICENSE +21 -0
  4. package/README.md +568 -0
  5. package/accounts/fetchers.ts +196 -0
  6. package/accounts/list.ts +184 -0
  7. package/accounts/pdas.ts +325 -0
  8. package/accounts/resolve-option.ts +104 -0
  9. package/client/lookup-table.ts +114 -0
  10. package/client/program.ts +13 -0
  11. package/client/types.ts +9 -0
  12. package/generated/accounts/collateralPool.ts +217 -0
  13. package/generated/accounts/config.ts +156 -0
  14. package/generated/accounts/escrowState.ts +183 -0
  15. package/generated/accounts/index.ts +20 -0
  16. package/generated/accounts/lenderPosition.ts +211 -0
  17. package/generated/accounts/makerCollateralShare.ts +229 -0
  18. package/generated/accounts/marketDataAccount.ts +176 -0
  19. package/generated/accounts/optionAccount.ts +247 -0
  20. package/generated/accounts/optionPool.ts +285 -0
  21. package/generated/accounts/poolLoan.ts +232 -0
  22. package/generated/accounts/positionAccount.ts +201 -0
  23. package/generated/accounts/vault.ts +366 -0
  24. package/generated/accounts/writerPosition.ts +327 -0
  25. package/generated/errors/index.ts +9 -0
  26. package/generated/errors/optionProgram.ts +476 -0
  27. package/generated/index.ts +13 -0
  28. package/generated/instructions/acceptAdmin.ts +230 -0
  29. package/generated/instructions/autoExerciseAllExpired.ts +685 -0
  30. package/generated/instructions/autoExerciseExpired.ts +754 -0
  31. package/generated/instructions/borrowFromPool.ts +619 -0
  32. package/generated/instructions/buyFromPool.ts +761 -0
  33. package/generated/instructions/closeLongToPool.ts +762 -0
  34. package/generated/instructions/closeOption.ts +235 -0
  35. package/generated/instructions/createEscrowV2.ts +518 -0
  36. package/generated/instructions/depositCollateral.ts +624 -0
  37. package/generated/instructions/depositToPosition.ts +429 -0
  38. package/generated/instructions/index.ts +47 -0
  39. package/generated/instructions/initCollateralPool.ts +513 -0
  40. package/generated/instructions/initConfig.ts +279 -0
  41. package/generated/instructions/initOptionPool.ts +587 -0
  42. package/generated/instructions/initializeMarketData.ts +359 -0
  43. package/generated/instructions/liquidateWriterPosition.ts +750 -0
  44. package/generated/instructions/liquidateWriterPositionRescue.ts +623 -0
  45. package/generated/instructions/omlpCreateVault.ts +553 -0
  46. package/generated/instructions/omlpUpdateFeeWallet.ts +473 -0
  47. package/generated/instructions/omlpUpdateInterestModel.ts +322 -0
  48. package/generated/instructions/omlpUpdateLiquidationThreshold.ts +304 -0
  49. package/generated/instructions/omlpUpdateMaintenanceBuffer.ts +304 -0
  50. package/generated/instructions/omlpUpdateMaxBorrowCap.ts +304 -0
  51. package/generated/instructions/omlpUpdateMaxLeverage.ts +304 -0
  52. package/generated/instructions/omlpUpdateProtocolFee.ts +304 -0
  53. package/generated/instructions/omlpUpdateSupplyLimit.ts +304 -0
  54. package/generated/instructions/optionExercise.ts +617 -0
  55. package/generated/instructions/optionMint.ts +1373 -0
  56. package/generated/instructions/optionValidate.ts +302 -0
  57. package/generated/instructions/repayPoolLoan.ts +558 -0
  58. package/generated/instructions/repayPoolLoanFromCollateral.ts +514 -0
  59. package/generated/instructions/repayPoolLoanFromWallet.ts +542 -0
  60. package/generated/instructions/settleMakerCollateral.ts +509 -0
  61. package/generated/instructions/syncWriterPosition.ts +206 -0
  62. package/generated/instructions/transferAdmin.ts +245 -0
  63. package/generated/instructions/unwindWriterUnsold.ts +764 -0
  64. package/generated/instructions/updateImpliedVolatility.ts +226 -0
  65. package/generated/instructions/updateMarketData.ts +315 -0
  66. package/generated/instructions/withdrawFromPosition.ts +405 -0
  67. package/generated/instructions/writeToPool.ts +619 -0
  68. package/generated/programs/index.ts +9 -0
  69. package/generated/programs/optionProgram.ts +1144 -0
  70. package/generated/shared/index.ts +164 -0
  71. package/generated/types/impliedVolatilityUpdated.ts +73 -0
  72. package/generated/types/index.ts +28 -0
  73. package/generated/types/liquidationExecuted.ts +73 -0
  74. package/generated/types/liquidationRescueEvent.ts +82 -0
  75. package/generated/types/marketDataInitialized.ts +61 -0
  76. package/generated/types/marketDataUpdated.ts +69 -0
  77. package/generated/types/optionClosed.ts +56 -0
  78. package/generated/types/optionExercised.ts +62 -0
  79. package/generated/types/optionExpired.ts +49 -0
  80. package/generated/types/optionMinted.ts +78 -0
  81. package/generated/types/optionType.ts +38 -0
  82. package/generated/types/optionValidated.ts +82 -0
  83. package/generated/types/poolLoanCreated.ts +74 -0
  84. package/generated/types/poolLoanRepaid.ts +74 -0
  85. package/generated/types/positionDeposited.ts +73 -0
  86. package/generated/types/positionWithdrawn.ts +81 -0
  87. package/generated/types/protocolFeeUpdated.ts +69 -0
  88. package/generated/types/vaultCreated.ts +60 -0
  89. package/generated/types/vaultFeeWalletUpdated.ts +67 -0
  90. package/generated/types/vaultInterestModelUpdated.ts +77 -0
  91. package/generated/types/vaultLiquidationThresholdUpdated.ts +69 -0
  92. package/index.ts +68 -0
  93. package/long/builders.ts +690 -0
  94. package/long/exercise.ts +123 -0
  95. package/long/preflight.ts +214 -0
  96. package/long/quotes.ts +48 -0
  97. package/long/remaining-accounts.ts +111 -0
  98. package/omlp/builders.ts +94 -0
  99. package/omlp/service.ts +136 -0
  100. package/oracle/switchboard.ts +315 -0
  101. package/package.json +34 -0
  102. package/shared/amounts.ts +53 -0
  103. package/shared/balances.ts +57 -0
  104. package/shared/errors.ts +12 -0
  105. package/shared/remaining-accounts.ts +41 -0
  106. package/shared/trade-config.ts +27 -0
  107. package/shared/transactions.ts +121 -0
  108. package/short/builders.ts +874 -0
  109. package/short/close-option.ts +34 -0
  110. package/short/pool.ts +189 -0
  111. package/short/preflight.ts +619 -0
  112. package/tsconfig.json +13 -0
  113. package/wsol/instructions.ts +247 -0
@@ -0,0 +1,302 @@
1
+ /**
2
+ * This code was AUTOGENERATED using the Codama library.
3
+ * Please DO NOT EDIT THIS FILE, instead use visitors
4
+ * to add features, then rerun Codama to update it.
5
+ *
6
+ * @see https://github.com/codama-idl/codama
7
+ */
8
+
9
+ import {
10
+ combineCodec,
11
+ fixDecoderSize,
12
+ fixEncoderSize,
13
+ getBytesDecoder,
14
+ getBytesEncoder,
15
+ getF64Decoder,
16
+ getF64Encoder,
17
+ getI64Decoder,
18
+ getI64Encoder,
19
+ getStructDecoder,
20
+ getStructEncoder,
21
+ getU64Decoder,
22
+ getU64Encoder,
23
+ transformEncoder,
24
+ type AccountMeta,
25
+ type AccountSignerMeta,
26
+ type Address,
27
+ type FixedSizeCodec,
28
+ type FixedSizeDecoder,
29
+ type FixedSizeEncoder,
30
+ type Instruction,
31
+ type InstructionWithAccounts,
32
+ type InstructionWithData,
33
+ type ReadonlyAccount,
34
+ type ReadonlySignerAccount,
35
+ type ReadonlyUint8Array,
36
+ type TransactionSigner,
37
+ type WritableAccount,
38
+ } from "@solana/kit";
39
+ import { OPTION_PROGRAM_PROGRAM_ADDRESS } from "../programs";
40
+ import { getAccountMetaFactory, type ResolvedAccount } from "../shared";
41
+ import {
42
+ getOptionTypeDecoder,
43
+ getOptionTypeEncoder,
44
+ type OptionType,
45
+ type OptionTypeArgs,
46
+ } from "../types";
47
+
48
+ export const OPTION_VALIDATE_DISCRIMINATOR = new Uint8Array([
49
+ 67, 10, 20, 254, 66, 53, 251, 6,
50
+ ]);
51
+
52
+ export function getOptionValidateDiscriminatorBytes() {
53
+ return fixEncoderSize(getBytesEncoder(), 8).encode(
54
+ OPTION_VALIDATE_DISCRIMINATOR,
55
+ );
56
+ }
57
+
58
+ export type OptionValidateInstruction<
59
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
60
+ TAccountOptionAccount extends string | AccountMeta<string> = string,
61
+ TAccountMarketData extends string | AccountMeta<string> = string,
62
+ TAccountSwitchboardQueue extends string | AccountMeta<string> = string,
63
+ TAccountSlotHashesSysvar extends string | AccountMeta<string> =
64
+ "SysvarS1otHashes111111111111111111111111111",
65
+ TAccountInstructionsSysvar extends string | AccountMeta<string> =
66
+ "Sysvar1nstructions1111111111111111111111111",
67
+ TAccountAuthority extends string | AccountMeta<string> = string,
68
+ TRemainingAccounts extends readonly AccountMeta<string>[] = [],
69
+ > = Instruction<TProgram> &
70
+ InstructionWithData<ReadonlyUint8Array> &
71
+ InstructionWithAccounts<
72
+ [
73
+ TAccountOptionAccount extends string
74
+ ? WritableAccount<TAccountOptionAccount>
75
+ : TAccountOptionAccount,
76
+ TAccountMarketData extends string
77
+ ? ReadonlyAccount<TAccountMarketData>
78
+ : TAccountMarketData,
79
+ TAccountSwitchboardQueue extends string
80
+ ? ReadonlyAccount<TAccountSwitchboardQueue>
81
+ : TAccountSwitchboardQueue,
82
+ TAccountSlotHashesSysvar extends string
83
+ ? ReadonlyAccount<TAccountSlotHashesSysvar>
84
+ : TAccountSlotHashesSysvar,
85
+ TAccountInstructionsSysvar extends string
86
+ ? ReadonlyAccount<TAccountInstructionsSysvar>
87
+ : TAccountInstructionsSysvar,
88
+ TAccountAuthority extends string
89
+ ? ReadonlySignerAccount<TAccountAuthority> &
90
+ AccountSignerMeta<TAccountAuthority>
91
+ : TAccountAuthority,
92
+ ...TRemainingAccounts,
93
+ ]
94
+ >;
95
+
96
+ export type OptionValidateInstructionData = {
97
+ discriminator: ReadonlyUint8Array;
98
+ optionType: OptionType;
99
+ strikePrice: number;
100
+ timeToExpiration: bigint;
101
+ quantity: bigint;
102
+ };
103
+
104
+ export type OptionValidateInstructionDataArgs = {
105
+ optionType: OptionTypeArgs;
106
+ strikePrice: number;
107
+ timeToExpiration: number | bigint;
108
+ quantity: number | bigint;
109
+ };
110
+
111
+ export function getOptionValidateInstructionDataEncoder(): FixedSizeEncoder<OptionValidateInstructionDataArgs> {
112
+ return transformEncoder(
113
+ getStructEncoder([
114
+ ["discriminator", fixEncoderSize(getBytesEncoder(), 8)],
115
+ ["optionType", getOptionTypeEncoder()],
116
+ ["strikePrice", getF64Encoder()],
117
+ ["timeToExpiration", getI64Encoder()],
118
+ ["quantity", getU64Encoder()],
119
+ ]),
120
+ (value) => ({ ...value, discriminator: OPTION_VALIDATE_DISCRIMINATOR }),
121
+ );
122
+ }
123
+
124
+ export function getOptionValidateInstructionDataDecoder(): FixedSizeDecoder<OptionValidateInstructionData> {
125
+ return getStructDecoder([
126
+ ["discriminator", fixDecoderSize(getBytesDecoder(), 8)],
127
+ ["optionType", getOptionTypeDecoder()],
128
+ ["strikePrice", getF64Decoder()],
129
+ ["timeToExpiration", getI64Decoder()],
130
+ ["quantity", getU64Decoder()],
131
+ ]);
132
+ }
133
+
134
+ export function getOptionValidateInstructionDataCodec(): FixedSizeCodec<
135
+ OptionValidateInstructionDataArgs,
136
+ OptionValidateInstructionData
137
+ > {
138
+ return combineCodec(
139
+ getOptionValidateInstructionDataEncoder(),
140
+ getOptionValidateInstructionDataDecoder(),
141
+ );
142
+ }
143
+
144
+ export type OptionValidateInput<
145
+ TAccountOptionAccount extends string = string,
146
+ TAccountMarketData extends string = string,
147
+ TAccountSwitchboardQueue extends string = string,
148
+ TAccountSlotHashesSysvar extends string = string,
149
+ TAccountInstructionsSysvar extends string = string,
150
+ TAccountAuthority extends string = string,
151
+ > = {
152
+ optionAccount: Address<TAccountOptionAccount>;
153
+ marketData: Address<TAccountMarketData>;
154
+ switchboardQueue: Address<TAccountSwitchboardQueue>;
155
+ slotHashesSysvar?: Address<TAccountSlotHashesSysvar>;
156
+ instructionsSysvar?: Address<TAccountInstructionsSysvar>;
157
+ authority: TransactionSigner<TAccountAuthority>;
158
+ optionType: OptionValidateInstructionDataArgs["optionType"];
159
+ strikePrice: OptionValidateInstructionDataArgs["strikePrice"];
160
+ timeToExpiration: OptionValidateInstructionDataArgs["timeToExpiration"];
161
+ quantity: OptionValidateInstructionDataArgs["quantity"];
162
+ };
163
+
164
+ export function getOptionValidateInstruction<
165
+ TAccountOptionAccount extends string,
166
+ TAccountMarketData extends string,
167
+ TAccountSwitchboardQueue extends string,
168
+ TAccountSlotHashesSysvar extends string,
169
+ TAccountInstructionsSysvar extends string,
170
+ TAccountAuthority extends string,
171
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
172
+ >(
173
+ input: OptionValidateInput<
174
+ TAccountOptionAccount,
175
+ TAccountMarketData,
176
+ TAccountSwitchboardQueue,
177
+ TAccountSlotHashesSysvar,
178
+ TAccountInstructionsSysvar,
179
+ TAccountAuthority
180
+ >,
181
+ config?: { programAddress?: TProgramAddress },
182
+ ): OptionValidateInstruction<
183
+ TProgramAddress,
184
+ TAccountOptionAccount,
185
+ TAccountMarketData,
186
+ TAccountSwitchboardQueue,
187
+ TAccountSlotHashesSysvar,
188
+ TAccountInstructionsSysvar,
189
+ TAccountAuthority
190
+ > {
191
+ // Program address.
192
+ const programAddress =
193
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
194
+
195
+ // Original accounts.
196
+ const originalAccounts = {
197
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
198
+ marketData: { value: input.marketData ?? null, isWritable: false },
199
+ switchboardQueue: {
200
+ value: input.switchboardQueue ?? null,
201
+ isWritable: false,
202
+ },
203
+ slotHashesSysvar: {
204
+ value: input.slotHashesSysvar ?? null,
205
+ isWritable: false,
206
+ },
207
+ instructionsSysvar: {
208
+ value: input.instructionsSysvar ?? null,
209
+ isWritable: false,
210
+ },
211
+ authority: { value: input.authority ?? null, isWritable: false },
212
+ };
213
+ const accounts = originalAccounts as Record<
214
+ keyof typeof originalAccounts,
215
+ ResolvedAccount
216
+ >;
217
+
218
+ // Original args.
219
+ const args = { ...input };
220
+
221
+ // Resolve default values.
222
+ if (!accounts.slotHashesSysvar.value) {
223
+ accounts.slotHashesSysvar.value =
224
+ "SysvarS1otHashes111111111111111111111111111" as Address<"SysvarS1otHashes111111111111111111111111111">;
225
+ }
226
+ if (!accounts.instructionsSysvar.value) {
227
+ accounts.instructionsSysvar.value =
228
+ "Sysvar1nstructions1111111111111111111111111" as Address<"Sysvar1nstructions1111111111111111111111111">;
229
+ }
230
+
231
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
232
+ return Object.freeze({
233
+ accounts: [
234
+ getAccountMeta(accounts.optionAccount),
235
+ getAccountMeta(accounts.marketData),
236
+ getAccountMeta(accounts.switchboardQueue),
237
+ getAccountMeta(accounts.slotHashesSysvar),
238
+ getAccountMeta(accounts.instructionsSysvar),
239
+ getAccountMeta(accounts.authority),
240
+ ],
241
+ data: getOptionValidateInstructionDataEncoder().encode(
242
+ args as OptionValidateInstructionDataArgs,
243
+ ),
244
+ programAddress,
245
+ } as OptionValidateInstruction<
246
+ TProgramAddress,
247
+ TAccountOptionAccount,
248
+ TAccountMarketData,
249
+ TAccountSwitchboardQueue,
250
+ TAccountSlotHashesSysvar,
251
+ TAccountInstructionsSysvar,
252
+ TAccountAuthority
253
+ >);
254
+ }
255
+
256
+ export type ParsedOptionValidateInstruction<
257
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
258
+ TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
259
+ > = {
260
+ programAddress: Address<TProgram>;
261
+ accounts: {
262
+ optionAccount: TAccountMetas[0];
263
+ marketData: TAccountMetas[1];
264
+ switchboardQueue: TAccountMetas[2];
265
+ slotHashesSysvar: TAccountMetas[3];
266
+ instructionsSysvar: TAccountMetas[4];
267
+ authority: TAccountMetas[5];
268
+ };
269
+ data: OptionValidateInstructionData;
270
+ };
271
+
272
+ export function parseOptionValidateInstruction<
273
+ TProgram extends string,
274
+ TAccountMetas extends readonly AccountMeta[],
275
+ >(
276
+ instruction: Instruction<TProgram> &
277
+ InstructionWithAccounts<TAccountMetas> &
278
+ InstructionWithData<ReadonlyUint8Array>,
279
+ ): ParsedOptionValidateInstruction<TProgram, TAccountMetas> {
280
+ if (instruction.accounts.length < 6) {
281
+ // TODO: Coded error.
282
+ throw new Error("Not enough accounts");
283
+ }
284
+ let accountIndex = 0;
285
+ const getNextAccount = () => {
286
+ const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
287
+ accountIndex += 1;
288
+ return accountMeta;
289
+ };
290
+ return {
291
+ programAddress: instruction.programAddress,
292
+ accounts: {
293
+ optionAccount: getNextAccount(),
294
+ marketData: getNextAccount(),
295
+ switchboardQueue: getNextAccount(),
296
+ slotHashesSysvar: getNextAccount(),
297
+ instructionsSysvar: getNextAccount(),
298
+ authority: getNextAccount(),
299
+ },
300
+ data: getOptionValidateInstructionDataDecoder().decode(instruction.data),
301
+ };
302
+ }