@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,617 @@
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
+ transformEncoder,
20
+ type AccountMeta,
21
+ type AccountSignerMeta,
22
+ type Address,
23
+ type FixedSizeCodec,
24
+ type FixedSizeDecoder,
25
+ type FixedSizeEncoder,
26
+ type Instruction,
27
+ type InstructionWithAccounts,
28
+ type InstructionWithData,
29
+ type ReadonlyAccount,
30
+ type ReadonlyUint8Array,
31
+ type TransactionSigner,
32
+ type WritableAccount,
33
+ type WritableSignerAccount,
34
+ } from "@solana/kit";
35
+ import { OPTION_PROGRAM_PROGRAM_ADDRESS } from "../programs";
36
+ import {
37
+ expectAddress,
38
+ getAccountMetaFactory,
39
+ type ResolvedAccount,
40
+ } from "../shared";
41
+
42
+ export const OPTION_EXERCISE_DISCRIMINATOR = new Uint8Array([
43
+ 43, 86, 237, 78, 235, 74, 131, 206,
44
+ ]);
45
+
46
+ export function getOptionExerciseDiscriminatorBytes() {
47
+ return fixEncoderSize(getBytesEncoder(), 8).encode(
48
+ OPTION_EXERCISE_DISCRIMINATOR,
49
+ );
50
+ }
51
+
52
+ export type OptionExerciseInstruction<
53
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
54
+ TAccountOptionAccount extends string | AccountMeta<string> = string,
55
+ TAccountPositionAccount extends string | AccountMeta<string> = string,
56
+ TAccountMarketData extends string | AccountMeta<string> = string,
57
+ TAccountUnderlyingMint extends string | AccountMeta<string> = string,
58
+ TAccountSwitchboardQueue extends string | AccountMeta<string> = string,
59
+ TAccountSlotHashesSysvar extends string | AccountMeta<string> =
60
+ "SysvarS1otHashes111111111111111111111111111",
61
+ TAccountInstructionsSysvar extends string | AccountMeta<string> =
62
+ "Sysvar1nstructions1111111111111111111111111",
63
+ TAccountBuyerPaymentAccount extends string | AccountMeta<string> = string,
64
+ TAccountMakerCollateralAccount extends string | AccountMeta<string> = string,
65
+ TAccountEscrowState extends string | AccountMeta<string> = string,
66
+ TAccountEscrowTokenAccount extends string | AccountMeta<string> = string,
67
+ TAccountEscrowAuthority extends string | AccountMeta<string> = string,
68
+ TAccountBuyer extends string | AccountMeta<string> = string,
69
+ TAccountTokenProgram extends string | AccountMeta<string> =
70
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
71
+ TRemainingAccounts extends readonly AccountMeta<string>[] = [],
72
+ > = Instruction<TProgram> &
73
+ InstructionWithData<ReadonlyUint8Array> &
74
+ InstructionWithAccounts<
75
+ [
76
+ TAccountOptionAccount extends string
77
+ ? WritableAccount<TAccountOptionAccount>
78
+ : TAccountOptionAccount,
79
+ TAccountPositionAccount extends string
80
+ ? WritableAccount<TAccountPositionAccount>
81
+ : TAccountPositionAccount,
82
+ TAccountMarketData extends string
83
+ ? ReadonlyAccount<TAccountMarketData>
84
+ : TAccountMarketData,
85
+ TAccountUnderlyingMint extends string
86
+ ? ReadonlyAccount<TAccountUnderlyingMint>
87
+ : TAccountUnderlyingMint,
88
+ TAccountSwitchboardQueue extends string
89
+ ? ReadonlyAccount<TAccountSwitchboardQueue>
90
+ : TAccountSwitchboardQueue,
91
+ TAccountSlotHashesSysvar extends string
92
+ ? ReadonlyAccount<TAccountSlotHashesSysvar>
93
+ : TAccountSlotHashesSysvar,
94
+ TAccountInstructionsSysvar extends string
95
+ ? ReadonlyAccount<TAccountInstructionsSysvar>
96
+ : TAccountInstructionsSysvar,
97
+ TAccountBuyerPaymentAccount extends string
98
+ ? WritableAccount<TAccountBuyerPaymentAccount>
99
+ : TAccountBuyerPaymentAccount,
100
+ TAccountMakerCollateralAccount extends string
101
+ ? WritableAccount<TAccountMakerCollateralAccount>
102
+ : TAccountMakerCollateralAccount,
103
+ TAccountEscrowState extends string
104
+ ? ReadonlyAccount<TAccountEscrowState>
105
+ : TAccountEscrowState,
106
+ TAccountEscrowTokenAccount extends string
107
+ ? WritableAccount<TAccountEscrowTokenAccount>
108
+ : TAccountEscrowTokenAccount,
109
+ TAccountEscrowAuthority extends string
110
+ ? ReadonlyAccount<TAccountEscrowAuthority>
111
+ : TAccountEscrowAuthority,
112
+ TAccountBuyer extends string
113
+ ? WritableSignerAccount<TAccountBuyer> &
114
+ AccountSignerMeta<TAccountBuyer>
115
+ : TAccountBuyer,
116
+ TAccountTokenProgram extends string
117
+ ? ReadonlyAccount<TAccountTokenProgram>
118
+ : TAccountTokenProgram,
119
+ ...TRemainingAccounts,
120
+ ]
121
+ >;
122
+
123
+ export type OptionExerciseInstructionData = {
124
+ discriminator: ReadonlyUint8Array;
125
+ };
126
+
127
+ export type OptionExerciseInstructionDataArgs = {};
128
+
129
+ export function getOptionExerciseInstructionDataEncoder(): FixedSizeEncoder<OptionExerciseInstructionDataArgs> {
130
+ return transformEncoder(
131
+ getStructEncoder([["discriminator", fixEncoderSize(getBytesEncoder(), 8)]]),
132
+ (value) => ({ ...value, discriminator: OPTION_EXERCISE_DISCRIMINATOR }),
133
+ );
134
+ }
135
+
136
+ export function getOptionExerciseInstructionDataDecoder(): FixedSizeDecoder<OptionExerciseInstructionData> {
137
+ return getStructDecoder([
138
+ ["discriminator", fixDecoderSize(getBytesDecoder(), 8)],
139
+ ]);
140
+ }
141
+
142
+ export function getOptionExerciseInstructionDataCodec(): FixedSizeCodec<
143
+ OptionExerciseInstructionDataArgs,
144
+ OptionExerciseInstructionData
145
+ > {
146
+ return combineCodec(
147
+ getOptionExerciseInstructionDataEncoder(),
148
+ getOptionExerciseInstructionDataDecoder(),
149
+ );
150
+ }
151
+
152
+ export type OptionExerciseAsyncInput<
153
+ TAccountOptionAccount extends string = string,
154
+ TAccountPositionAccount extends string = string,
155
+ TAccountMarketData extends string = string,
156
+ TAccountUnderlyingMint extends string = string,
157
+ TAccountSwitchboardQueue extends string = string,
158
+ TAccountSlotHashesSysvar extends string = string,
159
+ TAccountInstructionsSysvar extends string = string,
160
+ TAccountBuyerPaymentAccount extends string = string,
161
+ TAccountMakerCollateralAccount extends string = string,
162
+ TAccountEscrowState extends string = string,
163
+ TAccountEscrowTokenAccount extends string = string,
164
+ TAccountEscrowAuthority extends string = string,
165
+ TAccountBuyer extends string = string,
166
+ TAccountTokenProgram extends string = string,
167
+ > = {
168
+ optionAccount: Address<TAccountOptionAccount>;
169
+ positionAccount: Address<TAccountPositionAccount>;
170
+ /** Market data for risk-free rate (used in Black-Scholes premium calculation) */
171
+ marketData: Address<TAccountMarketData>;
172
+ /** Underlying token mint (for dynamic decimal handling - supports any SPL token) */
173
+ underlyingMint: Address<TAccountUnderlyingMint>;
174
+ switchboardQueue: Address<TAccountSwitchboardQueue>;
175
+ slotHashesSysvar?: Address<TAccountSlotHashesSysvar>;
176
+ instructionsSysvar?: Address<TAccountInstructionsSysvar>;
177
+ buyerPaymentAccount: Address<TAccountBuyerPaymentAccount>;
178
+ makerCollateralAccount: Address<TAccountMakerCollateralAccount>;
179
+ /**
180
+ * Escrow state PDA - validates maker/mint binding
181
+ * Validates escrow_state.maker matches option_account.authority (the option's maker)
182
+ */
183
+ escrowState: Address<TAccountEscrowState>;
184
+ /** Escrow token account holding collateral */
185
+ escrowTokenAccount: Address<TAccountEscrowTokenAccount>;
186
+ escrowAuthority?: Address<TAccountEscrowAuthority>;
187
+ buyer: TransactionSigner<TAccountBuyer>;
188
+ tokenProgram?: Address<TAccountTokenProgram>;
189
+ };
190
+
191
+ export async function getOptionExerciseInstructionAsync<
192
+ TAccountOptionAccount extends string,
193
+ TAccountPositionAccount extends string,
194
+ TAccountMarketData extends string,
195
+ TAccountUnderlyingMint extends string,
196
+ TAccountSwitchboardQueue extends string,
197
+ TAccountSlotHashesSysvar extends string,
198
+ TAccountInstructionsSysvar extends string,
199
+ TAccountBuyerPaymentAccount extends string,
200
+ TAccountMakerCollateralAccount extends string,
201
+ TAccountEscrowState extends string,
202
+ TAccountEscrowTokenAccount extends string,
203
+ TAccountEscrowAuthority extends string,
204
+ TAccountBuyer extends string,
205
+ TAccountTokenProgram extends string,
206
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
207
+ >(
208
+ input: OptionExerciseAsyncInput<
209
+ TAccountOptionAccount,
210
+ TAccountPositionAccount,
211
+ TAccountMarketData,
212
+ TAccountUnderlyingMint,
213
+ TAccountSwitchboardQueue,
214
+ TAccountSlotHashesSysvar,
215
+ TAccountInstructionsSysvar,
216
+ TAccountBuyerPaymentAccount,
217
+ TAccountMakerCollateralAccount,
218
+ TAccountEscrowState,
219
+ TAccountEscrowTokenAccount,
220
+ TAccountEscrowAuthority,
221
+ TAccountBuyer,
222
+ TAccountTokenProgram
223
+ >,
224
+ config?: { programAddress?: TProgramAddress },
225
+ ): Promise<
226
+ OptionExerciseInstruction<
227
+ TProgramAddress,
228
+ TAccountOptionAccount,
229
+ TAccountPositionAccount,
230
+ TAccountMarketData,
231
+ TAccountUnderlyingMint,
232
+ TAccountSwitchboardQueue,
233
+ TAccountSlotHashesSysvar,
234
+ TAccountInstructionsSysvar,
235
+ TAccountBuyerPaymentAccount,
236
+ TAccountMakerCollateralAccount,
237
+ TAccountEscrowState,
238
+ TAccountEscrowTokenAccount,
239
+ TAccountEscrowAuthority,
240
+ TAccountBuyer,
241
+ TAccountTokenProgram
242
+ >
243
+ > {
244
+ // Program address.
245
+ const programAddress =
246
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
247
+
248
+ // Original accounts.
249
+ const originalAccounts = {
250
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
251
+ positionAccount: { value: input.positionAccount ?? null, isWritable: true },
252
+ marketData: { value: input.marketData ?? null, isWritable: false },
253
+ underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },
254
+ switchboardQueue: {
255
+ value: input.switchboardQueue ?? null,
256
+ isWritable: false,
257
+ },
258
+ slotHashesSysvar: {
259
+ value: input.slotHashesSysvar ?? null,
260
+ isWritable: false,
261
+ },
262
+ instructionsSysvar: {
263
+ value: input.instructionsSysvar ?? null,
264
+ isWritable: false,
265
+ },
266
+ buyerPaymentAccount: {
267
+ value: input.buyerPaymentAccount ?? null,
268
+ isWritable: true,
269
+ },
270
+ makerCollateralAccount: {
271
+ value: input.makerCollateralAccount ?? null,
272
+ isWritable: true,
273
+ },
274
+ escrowState: { value: input.escrowState ?? null, isWritable: false },
275
+ escrowTokenAccount: {
276
+ value: input.escrowTokenAccount ?? null,
277
+ isWritable: true,
278
+ },
279
+ escrowAuthority: {
280
+ value: input.escrowAuthority ?? null,
281
+ isWritable: false,
282
+ },
283
+ buyer: { value: input.buyer ?? null, isWritable: true },
284
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
285
+ };
286
+ const accounts = originalAccounts as Record<
287
+ keyof typeof originalAccounts,
288
+ ResolvedAccount
289
+ >;
290
+
291
+ // Resolve default values.
292
+ if (!accounts.slotHashesSysvar.value) {
293
+ accounts.slotHashesSysvar.value =
294
+ "SysvarS1otHashes111111111111111111111111111" as Address<"SysvarS1otHashes111111111111111111111111111">;
295
+ }
296
+ if (!accounts.instructionsSysvar.value) {
297
+ accounts.instructionsSysvar.value =
298
+ "Sysvar1nstructions1111111111111111111111111" as Address<"Sysvar1nstructions1111111111111111111111111">;
299
+ }
300
+ if (!accounts.escrowAuthority.value) {
301
+ accounts.escrowAuthority.value = await getProgramDerivedAddress({
302
+ programAddress,
303
+ seeds: [
304
+ getBytesEncoder().encode(
305
+ new Uint8Array([
306
+ 101, 115, 99, 114, 111, 119, 95, 97, 117, 116, 104, 111, 114, 105,
307
+ 116, 121, 95, 118, 50,
308
+ ]),
309
+ ),
310
+ getAddressEncoder().encode(expectAddress(accounts.escrowState.value)),
311
+ ],
312
+ });
313
+ }
314
+ if (!accounts.tokenProgram.value) {
315
+ accounts.tokenProgram.value =
316
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
317
+ }
318
+
319
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
320
+ return Object.freeze({
321
+ accounts: [
322
+ getAccountMeta(accounts.optionAccount),
323
+ getAccountMeta(accounts.positionAccount),
324
+ getAccountMeta(accounts.marketData),
325
+ getAccountMeta(accounts.underlyingMint),
326
+ getAccountMeta(accounts.switchboardQueue),
327
+ getAccountMeta(accounts.slotHashesSysvar),
328
+ getAccountMeta(accounts.instructionsSysvar),
329
+ getAccountMeta(accounts.buyerPaymentAccount),
330
+ getAccountMeta(accounts.makerCollateralAccount),
331
+ getAccountMeta(accounts.escrowState),
332
+ getAccountMeta(accounts.escrowTokenAccount),
333
+ getAccountMeta(accounts.escrowAuthority),
334
+ getAccountMeta(accounts.buyer),
335
+ getAccountMeta(accounts.tokenProgram),
336
+ ],
337
+ data: getOptionExerciseInstructionDataEncoder().encode({}),
338
+ programAddress,
339
+ } as OptionExerciseInstruction<
340
+ TProgramAddress,
341
+ TAccountOptionAccount,
342
+ TAccountPositionAccount,
343
+ TAccountMarketData,
344
+ TAccountUnderlyingMint,
345
+ TAccountSwitchboardQueue,
346
+ TAccountSlotHashesSysvar,
347
+ TAccountInstructionsSysvar,
348
+ TAccountBuyerPaymentAccount,
349
+ TAccountMakerCollateralAccount,
350
+ TAccountEscrowState,
351
+ TAccountEscrowTokenAccount,
352
+ TAccountEscrowAuthority,
353
+ TAccountBuyer,
354
+ TAccountTokenProgram
355
+ >);
356
+ }
357
+
358
+ export type OptionExerciseInput<
359
+ TAccountOptionAccount extends string = string,
360
+ TAccountPositionAccount extends string = string,
361
+ TAccountMarketData extends string = string,
362
+ TAccountUnderlyingMint extends string = string,
363
+ TAccountSwitchboardQueue extends string = string,
364
+ TAccountSlotHashesSysvar extends string = string,
365
+ TAccountInstructionsSysvar extends string = string,
366
+ TAccountBuyerPaymentAccount extends string = string,
367
+ TAccountMakerCollateralAccount extends string = string,
368
+ TAccountEscrowState extends string = string,
369
+ TAccountEscrowTokenAccount extends string = string,
370
+ TAccountEscrowAuthority extends string = string,
371
+ TAccountBuyer extends string = string,
372
+ TAccountTokenProgram extends string = string,
373
+ > = {
374
+ optionAccount: Address<TAccountOptionAccount>;
375
+ positionAccount: Address<TAccountPositionAccount>;
376
+ /** Market data for risk-free rate (used in Black-Scholes premium calculation) */
377
+ marketData: Address<TAccountMarketData>;
378
+ /** Underlying token mint (for dynamic decimal handling - supports any SPL token) */
379
+ underlyingMint: Address<TAccountUnderlyingMint>;
380
+ switchboardQueue: Address<TAccountSwitchboardQueue>;
381
+ slotHashesSysvar?: Address<TAccountSlotHashesSysvar>;
382
+ instructionsSysvar?: Address<TAccountInstructionsSysvar>;
383
+ buyerPaymentAccount: Address<TAccountBuyerPaymentAccount>;
384
+ makerCollateralAccount: Address<TAccountMakerCollateralAccount>;
385
+ /**
386
+ * Escrow state PDA - validates maker/mint binding
387
+ * Validates escrow_state.maker matches option_account.authority (the option's maker)
388
+ */
389
+ escrowState: Address<TAccountEscrowState>;
390
+ /** Escrow token account holding collateral */
391
+ escrowTokenAccount: Address<TAccountEscrowTokenAccount>;
392
+ escrowAuthority: Address<TAccountEscrowAuthority>;
393
+ buyer: TransactionSigner<TAccountBuyer>;
394
+ tokenProgram?: Address<TAccountTokenProgram>;
395
+ };
396
+
397
+ export function getOptionExerciseInstruction<
398
+ TAccountOptionAccount extends string,
399
+ TAccountPositionAccount extends string,
400
+ TAccountMarketData extends string,
401
+ TAccountUnderlyingMint extends string,
402
+ TAccountSwitchboardQueue extends string,
403
+ TAccountSlotHashesSysvar extends string,
404
+ TAccountInstructionsSysvar extends string,
405
+ TAccountBuyerPaymentAccount extends string,
406
+ TAccountMakerCollateralAccount extends string,
407
+ TAccountEscrowState extends string,
408
+ TAccountEscrowTokenAccount extends string,
409
+ TAccountEscrowAuthority extends string,
410
+ TAccountBuyer extends string,
411
+ TAccountTokenProgram extends string,
412
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
413
+ >(
414
+ input: OptionExerciseInput<
415
+ TAccountOptionAccount,
416
+ TAccountPositionAccount,
417
+ TAccountMarketData,
418
+ TAccountUnderlyingMint,
419
+ TAccountSwitchboardQueue,
420
+ TAccountSlotHashesSysvar,
421
+ TAccountInstructionsSysvar,
422
+ TAccountBuyerPaymentAccount,
423
+ TAccountMakerCollateralAccount,
424
+ TAccountEscrowState,
425
+ TAccountEscrowTokenAccount,
426
+ TAccountEscrowAuthority,
427
+ TAccountBuyer,
428
+ TAccountTokenProgram
429
+ >,
430
+ config?: { programAddress?: TProgramAddress },
431
+ ): OptionExerciseInstruction<
432
+ TProgramAddress,
433
+ TAccountOptionAccount,
434
+ TAccountPositionAccount,
435
+ TAccountMarketData,
436
+ TAccountUnderlyingMint,
437
+ TAccountSwitchboardQueue,
438
+ TAccountSlotHashesSysvar,
439
+ TAccountInstructionsSysvar,
440
+ TAccountBuyerPaymentAccount,
441
+ TAccountMakerCollateralAccount,
442
+ TAccountEscrowState,
443
+ TAccountEscrowTokenAccount,
444
+ TAccountEscrowAuthority,
445
+ TAccountBuyer,
446
+ TAccountTokenProgram
447
+ > {
448
+ // Program address.
449
+ const programAddress =
450
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
451
+
452
+ // Original accounts.
453
+ const originalAccounts = {
454
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
455
+ positionAccount: { value: input.positionAccount ?? null, isWritable: true },
456
+ marketData: { value: input.marketData ?? null, isWritable: false },
457
+ underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },
458
+ switchboardQueue: {
459
+ value: input.switchboardQueue ?? null,
460
+ isWritable: false,
461
+ },
462
+ slotHashesSysvar: {
463
+ value: input.slotHashesSysvar ?? null,
464
+ isWritable: false,
465
+ },
466
+ instructionsSysvar: {
467
+ value: input.instructionsSysvar ?? null,
468
+ isWritable: false,
469
+ },
470
+ buyerPaymentAccount: {
471
+ value: input.buyerPaymentAccount ?? null,
472
+ isWritable: true,
473
+ },
474
+ makerCollateralAccount: {
475
+ value: input.makerCollateralAccount ?? null,
476
+ isWritable: true,
477
+ },
478
+ escrowState: { value: input.escrowState ?? null, isWritable: false },
479
+ escrowTokenAccount: {
480
+ value: input.escrowTokenAccount ?? null,
481
+ isWritable: true,
482
+ },
483
+ escrowAuthority: {
484
+ value: input.escrowAuthority ?? null,
485
+ isWritable: false,
486
+ },
487
+ buyer: { value: input.buyer ?? null, isWritable: true },
488
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
489
+ };
490
+ const accounts = originalAccounts as Record<
491
+ keyof typeof originalAccounts,
492
+ ResolvedAccount
493
+ >;
494
+
495
+ // Resolve default values.
496
+ if (!accounts.slotHashesSysvar.value) {
497
+ accounts.slotHashesSysvar.value =
498
+ "SysvarS1otHashes111111111111111111111111111" as Address<"SysvarS1otHashes111111111111111111111111111">;
499
+ }
500
+ if (!accounts.instructionsSysvar.value) {
501
+ accounts.instructionsSysvar.value =
502
+ "Sysvar1nstructions1111111111111111111111111" as Address<"Sysvar1nstructions1111111111111111111111111">;
503
+ }
504
+ if (!accounts.tokenProgram.value) {
505
+ accounts.tokenProgram.value =
506
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
507
+ }
508
+
509
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
510
+ return Object.freeze({
511
+ accounts: [
512
+ getAccountMeta(accounts.optionAccount),
513
+ getAccountMeta(accounts.positionAccount),
514
+ getAccountMeta(accounts.marketData),
515
+ getAccountMeta(accounts.underlyingMint),
516
+ getAccountMeta(accounts.switchboardQueue),
517
+ getAccountMeta(accounts.slotHashesSysvar),
518
+ getAccountMeta(accounts.instructionsSysvar),
519
+ getAccountMeta(accounts.buyerPaymentAccount),
520
+ getAccountMeta(accounts.makerCollateralAccount),
521
+ getAccountMeta(accounts.escrowState),
522
+ getAccountMeta(accounts.escrowTokenAccount),
523
+ getAccountMeta(accounts.escrowAuthority),
524
+ getAccountMeta(accounts.buyer),
525
+ getAccountMeta(accounts.tokenProgram),
526
+ ],
527
+ data: getOptionExerciseInstructionDataEncoder().encode({}),
528
+ programAddress,
529
+ } as OptionExerciseInstruction<
530
+ TProgramAddress,
531
+ TAccountOptionAccount,
532
+ TAccountPositionAccount,
533
+ TAccountMarketData,
534
+ TAccountUnderlyingMint,
535
+ TAccountSwitchboardQueue,
536
+ TAccountSlotHashesSysvar,
537
+ TAccountInstructionsSysvar,
538
+ TAccountBuyerPaymentAccount,
539
+ TAccountMakerCollateralAccount,
540
+ TAccountEscrowState,
541
+ TAccountEscrowTokenAccount,
542
+ TAccountEscrowAuthority,
543
+ TAccountBuyer,
544
+ TAccountTokenProgram
545
+ >);
546
+ }
547
+
548
+ export type ParsedOptionExerciseInstruction<
549
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
550
+ TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
551
+ > = {
552
+ programAddress: Address<TProgram>;
553
+ accounts: {
554
+ optionAccount: TAccountMetas[0];
555
+ positionAccount: TAccountMetas[1];
556
+ /** Market data for risk-free rate (used in Black-Scholes premium calculation) */
557
+ marketData: TAccountMetas[2];
558
+ /** Underlying token mint (for dynamic decimal handling - supports any SPL token) */
559
+ underlyingMint: TAccountMetas[3];
560
+ switchboardQueue: TAccountMetas[4];
561
+ slotHashesSysvar: TAccountMetas[5];
562
+ instructionsSysvar: TAccountMetas[6];
563
+ buyerPaymentAccount: TAccountMetas[7];
564
+ makerCollateralAccount: TAccountMetas[8];
565
+ /**
566
+ * Escrow state PDA - validates maker/mint binding
567
+ * Validates escrow_state.maker matches option_account.authority (the option's maker)
568
+ */
569
+ escrowState: TAccountMetas[9];
570
+ /** Escrow token account holding collateral */
571
+ escrowTokenAccount: TAccountMetas[10];
572
+ escrowAuthority: TAccountMetas[11];
573
+ buyer: TAccountMetas[12];
574
+ tokenProgram: TAccountMetas[13];
575
+ };
576
+ data: OptionExerciseInstructionData;
577
+ };
578
+
579
+ export function parseOptionExerciseInstruction<
580
+ TProgram extends string,
581
+ TAccountMetas extends readonly AccountMeta[],
582
+ >(
583
+ instruction: Instruction<TProgram> &
584
+ InstructionWithAccounts<TAccountMetas> &
585
+ InstructionWithData<ReadonlyUint8Array>,
586
+ ): ParsedOptionExerciseInstruction<TProgram, TAccountMetas> {
587
+ if (instruction.accounts.length < 14) {
588
+ // TODO: Coded error.
589
+ throw new Error("Not enough accounts");
590
+ }
591
+ let accountIndex = 0;
592
+ const getNextAccount = () => {
593
+ const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
594
+ accountIndex += 1;
595
+ return accountMeta;
596
+ };
597
+ return {
598
+ programAddress: instruction.programAddress,
599
+ accounts: {
600
+ optionAccount: getNextAccount(),
601
+ positionAccount: getNextAccount(),
602
+ marketData: getNextAccount(),
603
+ underlyingMint: getNextAccount(),
604
+ switchboardQueue: getNextAccount(),
605
+ slotHashesSysvar: getNextAccount(),
606
+ instructionsSysvar: getNextAccount(),
607
+ buyerPaymentAccount: getNextAccount(),
608
+ makerCollateralAccount: getNextAccount(),
609
+ escrowState: getNextAccount(),
610
+ escrowTokenAccount: getNextAccount(),
611
+ escrowAuthority: getNextAccount(),
612
+ buyer: getNextAccount(),
613
+ tokenProgram: getNextAccount(),
614
+ },
615
+ data: getOptionExerciseInstructionDataDecoder().decode(instruction.data),
616
+ };
617
+ }