@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,685 @@
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
+ getAddressEncoder,
14
+ getBytesDecoder,
15
+ getBytesEncoder,
16
+ getProgramDerivedAddress,
17
+ getStructDecoder,
18
+ getStructEncoder,
19
+ getU8Decoder,
20
+ getU8Encoder,
21
+ transformEncoder,
22
+ type AccountMeta,
23
+ type AccountSignerMeta,
24
+ type Address,
25
+ type FixedSizeCodec,
26
+ type FixedSizeDecoder,
27
+ type FixedSizeEncoder,
28
+ type Instruction,
29
+ type InstructionWithAccounts,
30
+ type InstructionWithData,
31
+ type ReadonlyAccount,
32
+ type ReadonlyUint8Array,
33
+ type TransactionSigner,
34
+ type WritableAccount,
35
+ type WritableSignerAccount,
36
+ } from "@solana/kit";
37
+ import { OPTION_PROGRAM_PROGRAM_ADDRESS } from "../programs";
38
+ import {
39
+ expectAddress,
40
+ getAccountMetaFactory,
41
+ type ResolvedAccount,
42
+ } from "../shared";
43
+
44
+ export const AUTO_EXERCISE_ALL_EXPIRED_DISCRIMINATOR = new Uint8Array([
45
+ 114, 241, 93, 137, 214, 147, 43, 57,
46
+ ]);
47
+
48
+ export function getAutoExerciseAllExpiredDiscriminatorBytes() {
49
+ return fixEncoderSize(getBytesEncoder(), 8).encode(
50
+ AUTO_EXERCISE_ALL_EXPIRED_DISCRIMINATOR,
51
+ );
52
+ }
53
+
54
+ export type AutoExerciseAllExpiredInstruction<
55
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
56
+ TAccountCollateralPool extends string | AccountMeta<string> = string,
57
+ TAccountOptionPool extends string | AccountMeta<string> = string,
58
+ TAccountOptionAccount extends string | AccountMeta<string> = string,
59
+ TAccountUnderlyingMint extends string | AccountMeta<string> = string,
60
+ TAccountCollateralVault extends string | AccountMeta<string> = string,
61
+ TAccountOmlpVault extends string | AccountMeta<string> = string,
62
+ TAccountOmlpVaultState extends string | AccountMeta<string> = string,
63
+ TAccountOptionMint extends string | AccountMeta<string> = string,
64
+ TAccountSwitchboardQueue extends string | AccountMeta<string> = string,
65
+ TAccountSlotHashesSysvar extends string | AccountMeta<string> =
66
+ "SysvarS1otHashes111111111111111111111111111",
67
+ TAccountInstructionsSysvar extends string | AccountMeta<string> =
68
+ "Sysvar1nstructions1111111111111111111111111",
69
+ TAccountMarketData extends string | AccountMeta<string> = string,
70
+ TAccountKeeper extends string | AccountMeta<string> = string,
71
+ TAccountTokenProgram extends string | AccountMeta<string> =
72
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
73
+ TAccountSystemProgram extends string | AccountMeta<string> =
74
+ "11111111111111111111111111111111",
75
+ TRemainingAccounts extends readonly AccountMeta<string>[] = [],
76
+ > = Instruction<TProgram> &
77
+ InstructionWithData<ReadonlyUint8Array> &
78
+ InstructionWithAccounts<
79
+ [
80
+ TAccountCollateralPool extends string
81
+ ? WritableAccount<TAccountCollateralPool>
82
+ : TAccountCollateralPool,
83
+ TAccountOptionPool extends string
84
+ ? WritableAccount<TAccountOptionPool>
85
+ : TAccountOptionPool,
86
+ TAccountOptionAccount extends string
87
+ ? WritableAccount<TAccountOptionAccount>
88
+ : TAccountOptionAccount,
89
+ TAccountUnderlyingMint extends string
90
+ ? ReadonlyAccount<TAccountUnderlyingMint>
91
+ : TAccountUnderlyingMint,
92
+ TAccountCollateralVault extends string
93
+ ? WritableAccount<TAccountCollateralVault>
94
+ : TAccountCollateralVault,
95
+ TAccountOmlpVault extends string
96
+ ? WritableAccount<TAccountOmlpVault>
97
+ : TAccountOmlpVault,
98
+ TAccountOmlpVaultState extends string
99
+ ? WritableAccount<TAccountOmlpVaultState>
100
+ : TAccountOmlpVaultState,
101
+ TAccountOptionMint extends string
102
+ ? WritableAccount<TAccountOptionMint>
103
+ : TAccountOptionMint,
104
+ TAccountSwitchboardQueue extends string
105
+ ? ReadonlyAccount<TAccountSwitchboardQueue>
106
+ : TAccountSwitchboardQueue,
107
+ TAccountSlotHashesSysvar extends string
108
+ ? ReadonlyAccount<TAccountSlotHashesSysvar>
109
+ : TAccountSlotHashesSysvar,
110
+ TAccountInstructionsSysvar extends string
111
+ ? ReadonlyAccount<TAccountInstructionsSysvar>
112
+ : TAccountInstructionsSysvar,
113
+ TAccountMarketData extends string
114
+ ? ReadonlyAccount<TAccountMarketData>
115
+ : TAccountMarketData,
116
+ TAccountKeeper extends string
117
+ ? WritableSignerAccount<TAccountKeeper> &
118
+ AccountSignerMeta<TAccountKeeper>
119
+ : TAccountKeeper,
120
+ TAccountTokenProgram extends string
121
+ ? ReadonlyAccount<TAccountTokenProgram>
122
+ : TAccountTokenProgram,
123
+ TAccountSystemProgram extends string
124
+ ? ReadonlyAccount<TAccountSystemProgram>
125
+ : TAccountSystemProgram,
126
+ ...TRemainingAccounts,
127
+ ]
128
+ >;
129
+
130
+ export type AutoExerciseAllExpiredInstructionData = {
131
+ discriminator: ReadonlyUint8Array;
132
+ maxPositions: number;
133
+ };
134
+
135
+ export type AutoExerciseAllExpiredInstructionDataArgs = {
136
+ maxPositions: number;
137
+ };
138
+
139
+ export function getAutoExerciseAllExpiredInstructionDataEncoder(): FixedSizeEncoder<AutoExerciseAllExpiredInstructionDataArgs> {
140
+ return transformEncoder(
141
+ getStructEncoder([
142
+ ["discriminator", fixEncoderSize(getBytesEncoder(), 8)],
143
+ ["maxPositions", getU8Encoder()],
144
+ ]),
145
+ (value) => ({
146
+ ...value,
147
+ discriminator: AUTO_EXERCISE_ALL_EXPIRED_DISCRIMINATOR,
148
+ }),
149
+ );
150
+ }
151
+
152
+ export function getAutoExerciseAllExpiredInstructionDataDecoder(): FixedSizeDecoder<AutoExerciseAllExpiredInstructionData> {
153
+ return getStructDecoder([
154
+ ["discriminator", fixDecoderSize(getBytesDecoder(), 8)],
155
+ ["maxPositions", getU8Decoder()],
156
+ ]);
157
+ }
158
+
159
+ export function getAutoExerciseAllExpiredInstructionDataCodec(): FixedSizeCodec<
160
+ AutoExerciseAllExpiredInstructionDataArgs,
161
+ AutoExerciseAllExpiredInstructionData
162
+ > {
163
+ return combineCodec(
164
+ getAutoExerciseAllExpiredInstructionDataEncoder(),
165
+ getAutoExerciseAllExpiredInstructionDataDecoder(),
166
+ );
167
+ }
168
+
169
+ export type AutoExerciseAllExpiredAsyncInput<
170
+ TAccountCollateralPool extends string = string,
171
+ TAccountOptionPool extends string = string,
172
+ TAccountOptionAccount extends string = string,
173
+ TAccountUnderlyingMint extends string = string,
174
+ TAccountCollateralVault extends string = string,
175
+ TAccountOmlpVault extends string = string,
176
+ TAccountOmlpVaultState extends string = string,
177
+ TAccountOptionMint extends string = string,
178
+ TAccountSwitchboardQueue extends string = string,
179
+ TAccountSlotHashesSysvar extends string = string,
180
+ TAccountInstructionsSysvar extends string = string,
181
+ TAccountMarketData extends string = string,
182
+ TAccountKeeper extends string = string,
183
+ TAccountTokenProgram extends string = string,
184
+ TAccountSystemProgram extends string = string,
185
+ > = {
186
+ collateralPool?: Address<TAccountCollateralPool>;
187
+ optionPool: Address<TAccountOptionPool>;
188
+ optionAccount: Address<TAccountOptionAccount>;
189
+ /**
190
+ * Underlying token mint — required to derive the matching OMLP vault
191
+ * state PDA and to keep vault aggregates consistent across batches.
192
+ */
193
+ underlyingMint: Address<TAccountUnderlyingMint>;
194
+ /** Pool's collateral vault (source of payout) */
195
+ collateralVault: Address<TAccountCollateralVault>;
196
+ /** OMLP Vault token account to receive repayments */
197
+ omlpVault: Address<TAccountOmlpVault>;
198
+ /**
199
+ * OMLP Vault state PDA (mut: `total_loans`, `total_liquidity`,
200
+ * `acc_interest_per_share_fp`). One vault state is used for the whole
201
+ * batch — batch auto-exercise only repays lenders in the underlying
202
+ * mint of the option.
203
+ */
204
+ omlpVaultState?: Address<TAccountOmlpVaultState>;
205
+ /** Option mint (for burning) */
206
+ optionMint: Address<TAccountOptionMint>;
207
+ switchboardQueue: Address<TAccountSwitchboardQueue>;
208
+ slotHashesSysvar?: Address<TAccountSlotHashesSysvar>;
209
+ instructionsSysvar?: Address<TAccountInstructionsSysvar>;
210
+ /** Market data for this underlying asset (contains switchboard_feed_id) */
211
+ marketData: Address<TAccountMarketData>;
212
+ /** Keeper who pays for gas - anyone can call this after expiration */
213
+ keeper: TransactionSigner<TAccountKeeper>;
214
+ tokenProgram?: Address<TAccountTokenProgram>;
215
+ systemProgram?: Address<TAccountSystemProgram>;
216
+ maxPositions: AutoExerciseAllExpiredInstructionDataArgs["maxPositions"];
217
+ };
218
+
219
+ export async function getAutoExerciseAllExpiredInstructionAsync<
220
+ TAccountCollateralPool extends string,
221
+ TAccountOptionPool extends string,
222
+ TAccountOptionAccount extends string,
223
+ TAccountUnderlyingMint extends string,
224
+ TAccountCollateralVault extends string,
225
+ TAccountOmlpVault extends string,
226
+ TAccountOmlpVaultState extends string,
227
+ TAccountOptionMint extends string,
228
+ TAccountSwitchboardQueue extends string,
229
+ TAccountSlotHashesSysvar extends string,
230
+ TAccountInstructionsSysvar extends string,
231
+ TAccountMarketData extends string,
232
+ TAccountKeeper extends string,
233
+ TAccountTokenProgram extends string,
234
+ TAccountSystemProgram extends string,
235
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
236
+ >(
237
+ input: AutoExerciseAllExpiredAsyncInput<
238
+ TAccountCollateralPool,
239
+ TAccountOptionPool,
240
+ TAccountOptionAccount,
241
+ TAccountUnderlyingMint,
242
+ TAccountCollateralVault,
243
+ TAccountOmlpVault,
244
+ TAccountOmlpVaultState,
245
+ TAccountOptionMint,
246
+ TAccountSwitchboardQueue,
247
+ TAccountSlotHashesSysvar,
248
+ TAccountInstructionsSysvar,
249
+ TAccountMarketData,
250
+ TAccountKeeper,
251
+ TAccountTokenProgram,
252
+ TAccountSystemProgram
253
+ >,
254
+ config?: { programAddress?: TProgramAddress },
255
+ ): Promise<
256
+ AutoExerciseAllExpiredInstruction<
257
+ TProgramAddress,
258
+ TAccountCollateralPool,
259
+ TAccountOptionPool,
260
+ TAccountOptionAccount,
261
+ TAccountUnderlyingMint,
262
+ TAccountCollateralVault,
263
+ TAccountOmlpVault,
264
+ TAccountOmlpVaultState,
265
+ TAccountOptionMint,
266
+ TAccountSwitchboardQueue,
267
+ TAccountSlotHashesSysvar,
268
+ TAccountInstructionsSysvar,
269
+ TAccountMarketData,
270
+ TAccountKeeper,
271
+ TAccountTokenProgram,
272
+ TAccountSystemProgram
273
+ >
274
+ > {
275
+ // Program address.
276
+ const programAddress =
277
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
278
+
279
+ // Original accounts.
280
+ const originalAccounts = {
281
+ collateralPool: { value: input.collateralPool ?? null, isWritable: true },
282
+ optionPool: { value: input.optionPool ?? null, isWritable: true },
283
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
284
+ underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },
285
+ collateralVault: { value: input.collateralVault ?? null, isWritable: true },
286
+ omlpVault: { value: input.omlpVault ?? null, isWritable: true },
287
+ omlpVaultState: { value: input.omlpVaultState ?? null, isWritable: true },
288
+ optionMint: { value: input.optionMint ?? null, isWritable: true },
289
+ switchboardQueue: {
290
+ value: input.switchboardQueue ?? null,
291
+ isWritable: false,
292
+ },
293
+ slotHashesSysvar: {
294
+ value: input.slotHashesSysvar ?? null,
295
+ isWritable: false,
296
+ },
297
+ instructionsSysvar: {
298
+ value: input.instructionsSysvar ?? null,
299
+ isWritable: false,
300
+ },
301
+ marketData: { value: input.marketData ?? null, isWritable: false },
302
+ keeper: { value: input.keeper ?? null, isWritable: true },
303
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
304
+ systemProgram: { value: input.systemProgram ?? null, isWritable: false },
305
+ };
306
+ const accounts = originalAccounts as Record<
307
+ keyof typeof originalAccounts,
308
+ ResolvedAccount
309
+ >;
310
+
311
+ // Original args.
312
+ const args = { ...input };
313
+
314
+ // Resolve default values.
315
+ if (!accounts.collateralPool.value) {
316
+ accounts.collateralPool.value = await getProgramDerivedAddress({
317
+ programAddress,
318
+ seeds: [
319
+ getBytesEncoder().encode(
320
+ new Uint8Array([
321
+ 99, 111, 108, 108, 97, 116, 101, 114, 97, 108, 95, 112, 111, 111,
322
+ 108,
323
+ ]),
324
+ ),
325
+ getAddressEncoder().encode(expectAddress(accounts.optionAccount.value)),
326
+ ],
327
+ });
328
+ }
329
+ if (!accounts.omlpVaultState.value) {
330
+ accounts.omlpVaultState.value = await getProgramDerivedAddress({
331
+ programAddress,
332
+ seeds: [
333
+ getBytesEncoder().encode(new Uint8Array([118, 97, 117, 108, 116])),
334
+ getAddressEncoder().encode(
335
+ expectAddress(accounts.underlyingMint.value),
336
+ ),
337
+ ],
338
+ });
339
+ }
340
+ if (!accounts.slotHashesSysvar.value) {
341
+ accounts.slotHashesSysvar.value =
342
+ "SysvarS1otHashes111111111111111111111111111" as Address<"SysvarS1otHashes111111111111111111111111111">;
343
+ }
344
+ if (!accounts.instructionsSysvar.value) {
345
+ accounts.instructionsSysvar.value =
346
+ "Sysvar1nstructions1111111111111111111111111" as Address<"Sysvar1nstructions1111111111111111111111111">;
347
+ }
348
+ if (!accounts.tokenProgram.value) {
349
+ accounts.tokenProgram.value =
350
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
351
+ }
352
+ if (!accounts.systemProgram.value) {
353
+ accounts.systemProgram.value =
354
+ "11111111111111111111111111111111" as Address<"11111111111111111111111111111111">;
355
+ }
356
+
357
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
358
+ return Object.freeze({
359
+ accounts: [
360
+ getAccountMeta(accounts.collateralPool),
361
+ getAccountMeta(accounts.optionPool),
362
+ getAccountMeta(accounts.optionAccount),
363
+ getAccountMeta(accounts.underlyingMint),
364
+ getAccountMeta(accounts.collateralVault),
365
+ getAccountMeta(accounts.omlpVault),
366
+ getAccountMeta(accounts.omlpVaultState),
367
+ getAccountMeta(accounts.optionMint),
368
+ getAccountMeta(accounts.switchboardQueue),
369
+ getAccountMeta(accounts.slotHashesSysvar),
370
+ getAccountMeta(accounts.instructionsSysvar),
371
+ getAccountMeta(accounts.marketData),
372
+ getAccountMeta(accounts.keeper),
373
+ getAccountMeta(accounts.tokenProgram),
374
+ getAccountMeta(accounts.systemProgram),
375
+ ],
376
+ data: getAutoExerciseAllExpiredInstructionDataEncoder().encode(
377
+ args as AutoExerciseAllExpiredInstructionDataArgs,
378
+ ),
379
+ programAddress,
380
+ } as AutoExerciseAllExpiredInstruction<
381
+ TProgramAddress,
382
+ TAccountCollateralPool,
383
+ TAccountOptionPool,
384
+ TAccountOptionAccount,
385
+ TAccountUnderlyingMint,
386
+ TAccountCollateralVault,
387
+ TAccountOmlpVault,
388
+ TAccountOmlpVaultState,
389
+ TAccountOptionMint,
390
+ TAccountSwitchboardQueue,
391
+ TAccountSlotHashesSysvar,
392
+ TAccountInstructionsSysvar,
393
+ TAccountMarketData,
394
+ TAccountKeeper,
395
+ TAccountTokenProgram,
396
+ TAccountSystemProgram
397
+ >);
398
+ }
399
+
400
+ export type AutoExerciseAllExpiredInput<
401
+ TAccountCollateralPool extends string = string,
402
+ TAccountOptionPool extends string = string,
403
+ TAccountOptionAccount extends string = string,
404
+ TAccountUnderlyingMint extends string = string,
405
+ TAccountCollateralVault extends string = string,
406
+ TAccountOmlpVault extends string = string,
407
+ TAccountOmlpVaultState extends string = string,
408
+ TAccountOptionMint extends string = string,
409
+ TAccountSwitchboardQueue extends string = string,
410
+ TAccountSlotHashesSysvar extends string = string,
411
+ TAccountInstructionsSysvar extends string = string,
412
+ TAccountMarketData extends string = string,
413
+ TAccountKeeper extends string = string,
414
+ TAccountTokenProgram extends string = string,
415
+ TAccountSystemProgram extends string = string,
416
+ > = {
417
+ collateralPool: Address<TAccountCollateralPool>;
418
+ optionPool: Address<TAccountOptionPool>;
419
+ optionAccount: Address<TAccountOptionAccount>;
420
+ /**
421
+ * Underlying token mint — required to derive the matching OMLP vault
422
+ * state PDA and to keep vault aggregates consistent across batches.
423
+ */
424
+ underlyingMint: Address<TAccountUnderlyingMint>;
425
+ /** Pool's collateral vault (source of payout) */
426
+ collateralVault: Address<TAccountCollateralVault>;
427
+ /** OMLP Vault token account to receive repayments */
428
+ omlpVault: Address<TAccountOmlpVault>;
429
+ /**
430
+ * OMLP Vault state PDA (mut: `total_loans`, `total_liquidity`,
431
+ * `acc_interest_per_share_fp`). One vault state is used for the whole
432
+ * batch — batch auto-exercise only repays lenders in the underlying
433
+ * mint of the option.
434
+ */
435
+ omlpVaultState: Address<TAccountOmlpVaultState>;
436
+ /** Option mint (for burning) */
437
+ optionMint: Address<TAccountOptionMint>;
438
+ switchboardQueue: Address<TAccountSwitchboardQueue>;
439
+ slotHashesSysvar?: Address<TAccountSlotHashesSysvar>;
440
+ instructionsSysvar?: Address<TAccountInstructionsSysvar>;
441
+ /** Market data for this underlying asset (contains switchboard_feed_id) */
442
+ marketData: Address<TAccountMarketData>;
443
+ /** Keeper who pays for gas - anyone can call this after expiration */
444
+ keeper: TransactionSigner<TAccountKeeper>;
445
+ tokenProgram?: Address<TAccountTokenProgram>;
446
+ systemProgram?: Address<TAccountSystemProgram>;
447
+ maxPositions: AutoExerciseAllExpiredInstructionDataArgs["maxPositions"];
448
+ };
449
+
450
+ export function getAutoExerciseAllExpiredInstruction<
451
+ TAccountCollateralPool extends string,
452
+ TAccountOptionPool extends string,
453
+ TAccountOptionAccount extends string,
454
+ TAccountUnderlyingMint extends string,
455
+ TAccountCollateralVault extends string,
456
+ TAccountOmlpVault extends string,
457
+ TAccountOmlpVaultState extends string,
458
+ TAccountOptionMint extends string,
459
+ TAccountSwitchboardQueue extends string,
460
+ TAccountSlotHashesSysvar extends string,
461
+ TAccountInstructionsSysvar extends string,
462
+ TAccountMarketData extends string,
463
+ TAccountKeeper extends string,
464
+ TAccountTokenProgram extends string,
465
+ TAccountSystemProgram extends string,
466
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
467
+ >(
468
+ input: AutoExerciseAllExpiredInput<
469
+ TAccountCollateralPool,
470
+ TAccountOptionPool,
471
+ TAccountOptionAccount,
472
+ TAccountUnderlyingMint,
473
+ TAccountCollateralVault,
474
+ TAccountOmlpVault,
475
+ TAccountOmlpVaultState,
476
+ TAccountOptionMint,
477
+ TAccountSwitchboardQueue,
478
+ TAccountSlotHashesSysvar,
479
+ TAccountInstructionsSysvar,
480
+ TAccountMarketData,
481
+ TAccountKeeper,
482
+ TAccountTokenProgram,
483
+ TAccountSystemProgram
484
+ >,
485
+ config?: { programAddress?: TProgramAddress },
486
+ ): AutoExerciseAllExpiredInstruction<
487
+ TProgramAddress,
488
+ TAccountCollateralPool,
489
+ TAccountOptionPool,
490
+ TAccountOptionAccount,
491
+ TAccountUnderlyingMint,
492
+ TAccountCollateralVault,
493
+ TAccountOmlpVault,
494
+ TAccountOmlpVaultState,
495
+ TAccountOptionMint,
496
+ TAccountSwitchboardQueue,
497
+ TAccountSlotHashesSysvar,
498
+ TAccountInstructionsSysvar,
499
+ TAccountMarketData,
500
+ TAccountKeeper,
501
+ TAccountTokenProgram,
502
+ TAccountSystemProgram
503
+ > {
504
+ // Program address.
505
+ const programAddress =
506
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
507
+
508
+ // Original accounts.
509
+ const originalAccounts = {
510
+ collateralPool: { value: input.collateralPool ?? null, isWritable: true },
511
+ optionPool: { value: input.optionPool ?? null, isWritable: true },
512
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
513
+ underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },
514
+ collateralVault: { value: input.collateralVault ?? null, isWritable: true },
515
+ omlpVault: { value: input.omlpVault ?? null, isWritable: true },
516
+ omlpVaultState: { value: input.omlpVaultState ?? null, isWritable: true },
517
+ optionMint: { value: input.optionMint ?? null, isWritable: true },
518
+ switchboardQueue: {
519
+ value: input.switchboardQueue ?? null,
520
+ isWritable: false,
521
+ },
522
+ slotHashesSysvar: {
523
+ value: input.slotHashesSysvar ?? null,
524
+ isWritable: false,
525
+ },
526
+ instructionsSysvar: {
527
+ value: input.instructionsSysvar ?? null,
528
+ isWritable: false,
529
+ },
530
+ marketData: { value: input.marketData ?? null, isWritable: false },
531
+ keeper: { value: input.keeper ?? null, isWritable: true },
532
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
533
+ systemProgram: { value: input.systemProgram ?? null, isWritable: false },
534
+ };
535
+ const accounts = originalAccounts as Record<
536
+ keyof typeof originalAccounts,
537
+ ResolvedAccount
538
+ >;
539
+
540
+ // Original args.
541
+ const args = { ...input };
542
+
543
+ // Resolve default values.
544
+ if (!accounts.slotHashesSysvar.value) {
545
+ accounts.slotHashesSysvar.value =
546
+ "SysvarS1otHashes111111111111111111111111111" as Address<"SysvarS1otHashes111111111111111111111111111">;
547
+ }
548
+ if (!accounts.instructionsSysvar.value) {
549
+ accounts.instructionsSysvar.value =
550
+ "Sysvar1nstructions1111111111111111111111111" as Address<"Sysvar1nstructions1111111111111111111111111">;
551
+ }
552
+ if (!accounts.tokenProgram.value) {
553
+ accounts.tokenProgram.value =
554
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
555
+ }
556
+ if (!accounts.systemProgram.value) {
557
+ accounts.systemProgram.value =
558
+ "11111111111111111111111111111111" as Address<"11111111111111111111111111111111">;
559
+ }
560
+
561
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
562
+ return Object.freeze({
563
+ accounts: [
564
+ getAccountMeta(accounts.collateralPool),
565
+ getAccountMeta(accounts.optionPool),
566
+ getAccountMeta(accounts.optionAccount),
567
+ getAccountMeta(accounts.underlyingMint),
568
+ getAccountMeta(accounts.collateralVault),
569
+ getAccountMeta(accounts.omlpVault),
570
+ getAccountMeta(accounts.omlpVaultState),
571
+ getAccountMeta(accounts.optionMint),
572
+ getAccountMeta(accounts.switchboardQueue),
573
+ getAccountMeta(accounts.slotHashesSysvar),
574
+ getAccountMeta(accounts.instructionsSysvar),
575
+ getAccountMeta(accounts.marketData),
576
+ getAccountMeta(accounts.keeper),
577
+ getAccountMeta(accounts.tokenProgram),
578
+ getAccountMeta(accounts.systemProgram),
579
+ ],
580
+ data: getAutoExerciseAllExpiredInstructionDataEncoder().encode(
581
+ args as AutoExerciseAllExpiredInstructionDataArgs,
582
+ ),
583
+ programAddress,
584
+ } as AutoExerciseAllExpiredInstruction<
585
+ TProgramAddress,
586
+ TAccountCollateralPool,
587
+ TAccountOptionPool,
588
+ TAccountOptionAccount,
589
+ TAccountUnderlyingMint,
590
+ TAccountCollateralVault,
591
+ TAccountOmlpVault,
592
+ TAccountOmlpVaultState,
593
+ TAccountOptionMint,
594
+ TAccountSwitchboardQueue,
595
+ TAccountSlotHashesSysvar,
596
+ TAccountInstructionsSysvar,
597
+ TAccountMarketData,
598
+ TAccountKeeper,
599
+ TAccountTokenProgram,
600
+ TAccountSystemProgram
601
+ >);
602
+ }
603
+
604
+ export type ParsedAutoExerciseAllExpiredInstruction<
605
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
606
+ TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
607
+ > = {
608
+ programAddress: Address<TProgram>;
609
+ accounts: {
610
+ collateralPool: TAccountMetas[0];
611
+ optionPool: TAccountMetas[1];
612
+ optionAccount: TAccountMetas[2];
613
+ /**
614
+ * Underlying token mint — required to derive the matching OMLP vault
615
+ * state PDA and to keep vault aggregates consistent across batches.
616
+ */
617
+ underlyingMint: TAccountMetas[3];
618
+ /** Pool's collateral vault (source of payout) */
619
+ collateralVault: TAccountMetas[4];
620
+ /** OMLP Vault token account to receive repayments */
621
+ omlpVault: TAccountMetas[5];
622
+ /**
623
+ * OMLP Vault state PDA (mut: `total_loans`, `total_liquidity`,
624
+ * `acc_interest_per_share_fp`). One vault state is used for the whole
625
+ * batch — batch auto-exercise only repays lenders in the underlying
626
+ * mint of the option.
627
+ */
628
+ omlpVaultState: TAccountMetas[6];
629
+ /** Option mint (for burning) */
630
+ optionMint: TAccountMetas[7];
631
+ switchboardQueue: TAccountMetas[8];
632
+ slotHashesSysvar: TAccountMetas[9];
633
+ instructionsSysvar: TAccountMetas[10];
634
+ /** Market data for this underlying asset (contains switchboard_feed_id) */
635
+ marketData: TAccountMetas[11];
636
+ /** Keeper who pays for gas - anyone can call this after expiration */
637
+ keeper: TAccountMetas[12];
638
+ tokenProgram: TAccountMetas[13];
639
+ systemProgram: TAccountMetas[14];
640
+ };
641
+ data: AutoExerciseAllExpiredInstructionData;
642
+ };
643
+
644
+ export function parseAutoExerciseAllExpiredInstruction<
645
+ TProgram extends string,
646
+ TAccountMetas extends readonly AccountMeta[],
647
+ >(
648
+ instruction: Instruction<TProgram> &
649
+ InstructionWithAccounts<TAccountMetas> &
650
+ InstructionWithData<ReadonlyUint8Array>,
651
+ ): ParsedAutoExerciseAllExpiredInstruction<TProgram, TAccountMetas> {
652
+ if (instruction.accounts.length < 15) {
653
+ // TODO: Coded error.
654
+ throw new Error("Not enough accounts");
655
+ }
656
+ let accountIndex = 0;
657
+ const getNextAccount = () => {
658
+ const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
659
+ accountIndex += 1;
660
+ return accountMeta;
661
+ };
662
+ return {
663
+ programAddress: instruction.programAddress,
664
+ accounts: {
665
+ collateralPool: getNextAccount(),
666
+ optionPool: getNextAccount(),
667
+ optionAccount: getNextAccount(),
668
+ underlyingMint: getNextAccount(),
669
+ collateralVault: getNextAccount(),
670
+ omlpVault: getNextAccount(),
671
+ omlpVaultState: getNextAccount(),
672
+ optionMint: getNextAccount(),
673
+ switchboardQueue: getNextAccount(),
674
+ slotHashesSysvar: getNextAccount(),
675
+ instructionsSysvar: getNextAccount(),
676
+ marketData: getNextAccount(),
677
+ keeper: getNextAccount(),
678
+ tokenProgram: getNextAccount(),
679
+ systemProgram: getNextAccount(),
680
+ },
681
+ data: getAutoExerciseAllExpiredInstructionDataDecoder().decode(
682
+ instruction.data,
683
+ ),
684
+ };
685
+ }