@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,764 @@
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
+ getU64Decoder,
20
+ getU64Encoder,
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 UNWIND_WRITER_UNSOLD_DISCRIMINATOR = new Uint8Array([
45
+ 48, 116, 34, 53, 22, 225, 22, 79,
46
+ ]);
47
+
48
+ export function getUnwindWriterUnsoldDiscriminatorBytes() {
49
+ return fixEncoderSize(getBytesEncoder(), 8).encode(
50
+ UNWIND_WRITER_UNSOLD_DISCRIMINATOR,
51
+ );
52
+ }
53
+
54
+ export type UnwindWriterUnsoldInstruction<
55
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
56
+ TAccountOptionPool extends string | AccountMeta<string> = string,
57
+ TAccountOptionAccount extends string | AccountMeta<string> = string,
58
+ TAccountMarketData extends string | AccountMeta<string> = string,
59
+ TAccountCollateralPool extends string | AccountMeta<string> = string,
60
+ TAccountWriterPosition extends string | AccountMeta<string> = string,
61
+ TAccountLongMint extends string | AccountMeta<string> = string,
62
+ TAccountShortMint extends string | AccountMeta<string> = string,
63
+ TAccountEscrowLongAccount extends string | AccountMeta<string> = string,
64
+ TAccountWriterShortAccount extends string | AccountMeta<string> = string,
65
+ TAccountCollateralVault extends string | AccountMeta<string> = string,
66
+ TAccountPremiumVault extends string | AccountMeta<string> = string,
67
+ TAccountWriterCollateralAccount extends string | AccountMeta<string> = string,
68
+ TAccountOmlpVaultState extends string | AccountMeta<string> = string,
69
+ TAccountOmlpVault extends string | AccountMeta<string> = string,
70
+ TAccountFeeWallet extends string | AccountMeta<string> = string,
71
+ TAccountWriter extends string | AccountMeta<string> = string,
72
+ TAccountTokenProgram extends string | AccountMeta<string> =
73
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
74
+ TAccountSystemProgram extends string | AccountMeta<string> =
75
+ "11111111111111111111111111111111",
76
+ TRemainingAccounts extends readonly AccountMeta<string>[] = [],
77
+ > = Instruction<TProgram> &
78
+ InstructionWithData<ReadonlyUint8Array> &
79
+ InstructionWithAccounts<
80
+ [
81
+ TAccountOptionPool extends string
82
+ ? WritableAccount<TAccountOptionPool>
83
+ : TAccountOptionPool,
84
+ TAccountOptionAccount extends string
85
+ ? WritableAccount<TAccountOptionAccount>
86
+ : TAccountOptionAccount,
87
+ TAccountMarketData extends string
88
+ ? ReadonlyAccount<TAccountMarketData>
89
+ : TAccountMarketData,
90
+ TAccountCollateralPool extends string
91
+ ? WritableAccount<TAccountCollateralPool>
92
+ : TAccountCollateralPool,
93
+ TAccountWriterPosition extends string
94
+ ? WritableAccount<TAccountWriterPosition>
95
+ : TAccountWriterPosition,
96
+ TAccountLongMint extends string
97
+ ? WritableAccount<TAccountLongMint>
98
+ : TAccountLongMint,
99
+ TAccountShortMint extends string
100
+ ? WritableAccount<TAccountShortMint>
101
+ : TAccountShortMint,
102
+ TAccountEscrowLongAccount extends string
103
+ ? WritableAccount<TAccountEscrowLongAccount>
104
+ : TAccountEscrowLongAccount,
105
+ TAccountWriterShortAccount extends string
106
+ ? WritableAccount<TAccountWriterShortAccount>
107
+ : TAccountWriterShortAccount,
108
+ TAccountCollateralVault extends string
109
+ ? WritableAccount<TAccountCollateralVault>
110
+ : TAccountCollateralVault,
111
+ TAccountPremiumVault extends string
112
+ ? WritableAccount<TAccountPremiumVault>
113
+ : TAccountPremiumVault,
114
+ TAccountWriterCollateralAccount extends string
115
+ ? WritableAccount<TAccountWriterCollateralAccount>
116
+ : TAccountWriterCollateralAccount,
117
+ TAccountOmlpVaultState extends string
118
+ ? WritableAccount<TAccountOmlpVaultState>
119
+ : TAccountOmlpVaultState,
120
+ TAccountOmlpVault extends string
121
+ ? WritableAccount<TAccountOmlpVault>
122
+ : TAccountOmlpVault,
123
+ TAccountFeeWallet extends string
124
+ ? WritableAccount<TAccountFeeWallet>
125
+ : TAccountFeeWallet,
126
+ TAccountWriter extends string
127
+ ? WritableSignerAccount<TAccountWriter> &
128
+ AccountSignerMeta<TAccountWriter>
129
+ : TAccountWriter,
130
+ TAccountTokenProgram extends string
131
+ ? ReadonlyAccount<TAccountTokenProgram>
132
+ : TAccountTokenProgram,
133
+ TAccountSystemProgram extends string
134
+ ? ReadonlyAccount<TAccountSystemProgram>
135
+ : TAccountSystemProgram,
136
+ ...TRemainingAccounts,
137
+ ]
138
+ >;
139
+
140
+ export type UnwindWriterUnsoldInstructionData = {
141
+ discriminator: ReadonlyUint8Array;
142
+ unwindQty: bigint;
143
+ };
144
+
145
+ export type UnwindWriterUnsoldInstructionDataArgs = {
146
+ unwindQty: number | bigint;
147
+ };
148
+
149
+ export function getUnwindWriterUnsoldInstructionDataEncoder(): FixedSizeEncoder<UnwindWriterUnsoldInstructionDataArgs> {
150
+ return transformEncoder(
151
+ getStructEncoder([
152
+ ["discriminator", fixEncoderSize(getBytesEncoder(), 8)],
153
+ ["unwindQty", getU64Encoder()],
154
+ ]),
155
+ (value) => ({
156
+ ...value,
157
+ discriminator: UNWIND_WRITER_UNSOLD_DISCRIMINATOR,
158
+ }),
159
+ );
160
+ }
161
+
162
+ export function getUnwindWriterUnsoldInstructionDataDecoder(): FixedSizeDecoder<UnwindWriterUnsoldInstructionData> {
163
+ return getStructDecoder([
164
+ ["discriminator", fixDecoderSize(getBytesDecoder(), 8)],
165
+ ["unwindQty", getU64Decoder()],
166
+ ]);
167
+ }
168
+
169
+ export function getUnwindWriterUnsoldInstructionDataCodec(): FixedSizeCodec<
170
+ UnwindWriterUnsoldInstructionDataArgs,
171
+ UnwindWriterUnsoldInstructionData
172
+ > {
173
+ return combineCodec(
174
+ getUnwindWriterUnsoldInstructionDataEncoder(),
175
+ getUnwindWriterUnsoldInstructionDataDecoder(),
176
+ );
177
+ }
178
+
179
+ export type UnwindWriterUnsoldAsyncInput<
180
+ TAccountOptionPool extends string = string,
181
+ TAccountOptionAccount extends string = string,
182
+ TAccountMarketData extends string = string,
183
+ TAccountCollateralPool extends string = string,
184
+ TAccountWriterPosition extends string = string,
185
+ TAccountLongMint extends string = string,
186
+ TAccountShortMint extends string = string,
187
+ TAccountEscrowLongAccount extends string = string,
188
+ TAccountWriterShortAccount extends string = string,
189
+ TAccountCollateralVault extends string = string,
190
+ TAccountPremiumVault extends string = string,
191
+ TAccountWriterCollateralAccount extends string = string,
192
+ TAccountOmlpVaultState extends string = string,
193
+ TAccountOmlpVault extends string = string,
194
+ TAccountFeeWallet extends string = string,
195
+ TAccountWriter extends string = string,
196
+ TAccountTokenProgram extends string = string,
197
+ TAccountSystemProgram extends string = string,
198
+ > = {
199
+ /** The option pool */
200
+ optionPool: Address<TAccountOptionPool>;
201
+ /** The option account */
202
+ optionAccount: Address<TAccountOptionAccount>;
203
+ /** Market data (historical vol baseline for IV kink) */
204
+ marketData: Address<TAccountMarketData>;
205
+ /** Collateral pool */
206
+ collateralPool?: Address<TAccountCollateralPool>;
207
+ /** Writer's unified position account */
208
+ writerPosition?: Address<TAccountWriterPosition>;
209
+ /** LONG token mint (for burning from escrow) */
210
+ longMint: Address<TAccountLongMint>;
211
+ /** SHORT token mint (for burning from writer) */
212
+ shortMint: Address<TAccountShortMint>;
213
+ /** Pool's LONG escrow (source of LONG tokens to burn) */
214
+ escrowLongAccount: Address<TAccountEscrowLongAccount>;
215
+ /** Writer's SHORT token account (source of SHORT tokens to burn) */
216
+ writerShortAccount: Address<TAccountWriterShortAccount>;
217
+ /** Collateral vault (source of collateral return + collateral-side debt repayment) */
218
+ collateralVault: Address<TAccountCollateralVault>;
219
+ /**
220
+ * Pool premium vault (source of theta-first debt repayment + leftover
221
+ * theta returned to the writer). Same underlying_mint as the pool.
222
+ */
223
+ premiumVault: Address<TAccountPremiumVault>;
224
+ /**
225
+ * Writer's token account for returned collateral + any leftover theta.
226
+ * Must be the underlying_mint so leftover theta (denominated in
227
+ * premium_vault.mint == underlying_mint) can be deposited here.
228
+ */
229
+ writerCollateralAccount: Address<TAccountWriterCollateralAccount>;
230
+ /** OMLP Vault state PDA (for total_loans, add_interest_to_index) - optional, required when repaying loans */
231
+ omlpVaultState?: Address<TAccountOmlpVaultState>;
232
+ /** OMLP vault token account (receives loan repayments) - optional */
233
+ omlpVault?: Address<TAccountOmlpVault>;
234
+ /** Protocol fee wallet (receives protocol fees) - optional */
235
+ feeWallet?: Address<TAccountFeeWallet>;
236
+ writer: TransactionSigner<TAccountWriter>;
237
+ tokenProgram?: Address<TAccountTokenProgram>;
238
+ systemProgram?: Address<TAccountSystemProgram>;
239
+ unwindQty: UnwindWriterUnsoldInstructionDataArgs["unwindQty"];
240
+ };
241
+
242
+ export async function getUnwindWriterUnsoldInstructionAsync<
243
+ TAccountOptionPool extends string,
244
+ TAccountOptionAccount extends string,
245
+ TAccountMarketData extends string,
246
+ TAccountCollateralPool extends string,
247
+ TAccountWriterPosition extends string,
248
+ TAccountLongMint extends string,
249
+ TAccountShortMint extends string,
250
+ TAccountEscrowLongAccount extends string,
251
+ TAccountWriterShortAccount extends string,
252
+ TAccountCollateralVault extends string,
253
+ TAccountPremiumVault extends string,
254
+ TAccountWriterCollateralAccount extends string,
255
+ TAccountOmlpVaultState extends string,
256
+ TAccountOmlpVault extends string,
257
+ TAccountFeeWallet extends string,
258
+ TAccountWriter extends string,
259
+ TAccountTokenProgram extends string,
260
+ TAccountSystemProgram extends string,
261
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
262
+ >(
263
+ input: UnwindWriterUnsoldAsyncInput<
264
+ TAccountOptionPool,
265
+ TAccountOptionAccount,
266
+ TAccountMarketData,
267
+ TAccountCollateralPool,
268
+ TAccountWriterPosition,
269
+ TAccountLongMint,
270
+ TAccountShortMint,
271
+ TAccountEscrowLongAccount,
272
+ TAccountWriterShortAccount,
273
+ TAccountCollateralVault,
274
+ TAccountPremiumVault,
275
+ TAccountWriterCollateralAccount,
276
+ TAccountOmlpVaultState,
277
+ TAccountOmlpVault,
278
+ TAccountFeeWallet,
279
+ TAccountWriter,
280
+ TAccountTokenProgram,
281
+ TAccountSystemProgram
282
+ >,
283
+ config?: { programAddress?: TProgramAddress },
284
+ ): Promise<
285
+ UnwindWriterUnsoldInstruction<
286
+ TProgramAddress,
287
+ TAccountOptionPool,
288
+ TAccountOptionAccount,
289
+ TAccountMarketData,
290
+ TAccountCollateralPool,
291
+ TAccountWriterPosition,
292
+ TAccountLongMint,
293
+ TAccountShortMint,
294
+ TAccountEscrowLongAccount,
295
+ TAccountWriterShortAccount,
296
+ TAccountCollateralVault,
297
+ TAccountPremiumVault,
298
+ TAccountWriterCollateralAccount,
299
+ TAccountOmlpVaultState,
300
+ TAccountOmlpVault,
301
+ TAccountFeeWallet,
302
+ TAccountWriter,
303
+ TAccountTokenProgram,
304
+ TAccountSystemProgram
305
+ >
306
+ > {
307
+ // Program address.
308
+ const programAddress =
309
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
310
+
311
+ // Original accounts.
312
+ const originalAccounts = {
313
+ optionPool: { value: input.optionPool ?? null, isWritable: true },
314
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
315
+ marketData: { value: input.marketData ?? null, isWritable: false },
316
+ collateralPool: { value: input.collateralPool ?? null, isWritable: true },
317
+ writerPosition: { value: input.writerPosition ?? null, isWritable: true },
318
+ longMint: { value: input.longMint ?? null, isWritable: true },
319
+ shortMint: { value: input.shortMint ?? null, isWritable: true },
320
+ escrowLongAccount: {
321
+ value: input.escrowLongAccount ?? null,
322
+ isWritable: true,
323
+ },
324
+ writerShortAccount: {
325
+ value: input.writerShortAccount ?? null,
326
+ isWritable: true,
327
+ },
328
+ collateralVault: { value: input.collateralVault ?? null, isWritable: true },
329
+ premiumVault: { value: input.premiumVault ?? null, isWritable: true },
330
+ writerCollateralAccount: {
331
+ value: input.writerCollateralAccount ?? null,
332
+ isWritable: true,
333
+ },
334
+ omlpVaultState: { value: input.omlpVaultState ?? null, isWritable: true },
335
+ omlpVault: { value: input.omlpVault ?? null, isWritable: true },
336
+ feeWallet: { value: input.feeWallet ?? null, isWritable: true },
337
+ writer: { value: input.writer ?? null, isWritable: true },
338
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
339
+ systemProgram: { value: input.systemProgram ?? null, isWritable: false },
340
+ };
341
+ const accounts = originalAccounts as Record<
342
+ keyof typeof originalAccounts,
343
+ ResolvedAccount
344
+ >;
345
+
346
+ // Original args.
347
+ const args = { ...input };
348
+
349
+ // Resolve default values.
350
+ if (!accounts.collateralPool.value) {
351
+ accounts.collateralPool.value = await getProgramDerivedAddress({
352
+ programAddress,
353
+ seeds: [
354
+ getBytesEncoder().encode(
355
+ new Uint8Array([
356
+ 99, 111, 108, 108, 97, 116, 101, 114, 97, 108, 95, 112, 111, 111,
357
+ 108,
358
+ ]),
359
+ ),
360
+ getAddressEncoder().encode(expectAddress(accounts.optionAccount.value)),
361
+ ],
362
+ });
363
+ }
364
+ if (!accounts.writerPosition.value) {
365
+ accounts.writerPosition.value = await getProgramDerivedAddress({
366
+ programAddress,
367
+ seeds: [
368
+ getBytesEncoder().encode(
369
+ new Uint8Array([
370
+ 119, 114, 105, 116, 101, 114, 95, 112, 111, 115, 105, 116, 105, 111,
371
+ 110,
372
+ ]),
373
+ ),
374
+ getAddressEncoder().encode(expectAddress(accounts.optionPool.value)),
375
+ getAddressEncoder().encode(expectAddress(accounts.writer.value)),
376
+ ],
377
+ });
378
+ }
379
+ if (!accounts.tokenProgram.value) {
380
+ accounts.tokenProgram.value =
381
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
382
+ }
383
+ if (!accounts.systemProgram.value) {
384
+ accounts.systemProgram.value =
385
+ "11111111111111111111111111111111" as Address<"11111111111111111111111111111111">;
386
+ }
387
+
388
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
389
+ return Object.freeze({
390
+ accounts: [
391
+ getAccountMeta(accounts.optionPool),
392
+ getAccountMeta(accounts.optionAccount),
393
+ getAccountMeta(accounts.marketData),
394
+ getAccountMeta(accounts.collateralPool),
395
+ getAccountMeta(accounts.writerPosition),
396
+ getAccountMeta(accounts.longMint),
397
+ getAccountMeta(accounts.shortMint),
398
+ getAccountMeta(accounts.escrowLongAccount),
399
+ getAccountMeta(accounts.writerShortAccount),
400
+ getAccountMeta(accounts.collateralVault),
401
+ getAccountMeta(accounts.premiumVault),
402
+ getAccountMeta(accounts.writerCollateralAccount),
403
+ getAccountMeta(accounts.omlpVaultState),
404
+ getAccountMeta(accounts.omlpVault),
405
+ getAccountMeta(accounts.feeWallet),
406
+ getAccountMeta(accounts.writer),
407
+ getAccountMeta(accounts.tokenProgram),
408
+ getAccountMeta(accounts.systemProgram),
409
+ ],
410
+ data: getUnwindWriterUnsoldInstructionDataEncoder().encode(
411
+ args as UnwindWriterUnsoldInstructionDataArgs,
412
+ ),
413
+ programAddress,
414
+ } as UnwindWriterUnsoldInstruction<
415
+ TProgramAddress,
416
+ TAccountOptionPool,
417
+ TAccountOptionAccount,
418
+ TAccountMarketData,
419
+ TAccountCollateralPool,
420
+ TAccountWriterPosition,
421
+ TAccountLongMint,
422
+ TAccountShortMint,
423
+ TAccountEscrowLongAccount,
424
+ TAccountWriterShortAccount,
425
+ TAccountCollateralVault,
426
+ TAccountPremiumVault,
427
+ TAccountWriterCollateralAccount,
428
+ TAccountOmlpVaultState,
429
+ TAccountOmlpVault,
430
+ TAccountFeeWallet,
431
+ TAccountWriter,
432
+ TAccountTokenProgram,
433
+ TAccountSystemProgram
434
+ >);
435
+ }
436
+
437
+ export type UnwindWriterUnsoldInput<
438
+ TAccountOptionPool extends string = string,
439
+ TAccountOptionAccount extends string = string,
440
+ TAccountMarketData extends string = string,
441
+ TAccountCollateralPool extends string = string,
442
+ TAccountWriterPosition extends string = string,
443
+ TAccountLongMint extends string = string,
444
+ TAccountShortMint extends string = string,
445
+ TAccountEscrowLongAccount extends string = string,
446
+ TAccountWriterShortAccount extends string = string,
447
+ TAccountCollateralVault extends string = string,
448
+ TAccountPremiumVault extends string = string,
449
+ TAccountWriterCollateralAccount extends string = string,
450
+ TAccountOmlpVaultState extends string = string,
451
+ TAccountOmlpVault extends string = string,
452
+ TAccountFeeWallet extends string = string,
453
+ TAccountWriter extends string = string,
454
+ TAccountTokenProgram extends string = string,
455
+ TAccountSystemProgram extends string = string,
456
+ > = {
457
+ /** The option pool */
458
+ optionPool: Address<TAccountOptionPool>;
459
+ /** The option account */
460
+ optionAccount: Address<TAccountOptionAccount>;
461
+ /** Market data (historical vol baseline for IV kink) */
462
+ marketData: Address<TAccountMarketData>;
463
+ /** Collateral pool */
464
+ collateralPool: Address<TAccountCollateralPool>;
465
+ /** Writer's unified position account */
466
+ writerPosition: Address<TAccountWriterPosition>;
467
+ /** LONG token mint (for burning from escrow) */
468
+ longMint: Address<TAccountLongMint>;
469
+ /** SHORT token mint (for burning from writer) */
470
+ shortMint: Address<TAccountShortMint>;
471
+ /** Pool's LONG escrow (source of LONG tokens to burn) */
472
+ escrowLongAccount: Address<TAccountEscrowLongAccount>;
473
+ /** Writer's SHORT token account (source of SHORT tokens to burn) */
474
+ writerShortAccount: Address<TAccountWriterShortAccount>;
475
+ /** Collateral vault (source of collateral return + collateral-side debt repayment) */
476
+ collateralVault: Address<TAccountCollateralVault>;
477
+ /**
478
+ * Pool premium vault (source of theta-first debt repayment + leftover
479
+ * theta returned to the writer). Same underlying_mint as the pool.
480
+ */
481
+ premiumVault: Address<TAccountPremiumVault>;
482
+ /**
483
+ * Writer's token account for returned collateral + any leftover theta.
484
+ * Must be the underlying_mint so leftover theta (denominated in
485
+ * premium_vault.mint == underlying_mint) can be deposited here.
486
+ */
487
+ writerCollateralAccount: Address<TAccountWriterCollateralAccount>;
488
+ /** OMLP Vault state PDA (for total_loans, add_interest_to_index) - optional, required when repaying loans */
489
+ omlpVaultState?: Address<TAccountOmlpVaultState>;
490
+ /** OMLP vault token account (receives loan repayments) - optional */
491
+ omlpVault?: Address<TAccountOmlpVault>;
492
+ /** Protocol fee wallet (receives protocol fees) - optional */
493
+ feeWallet?: Address<TAccountFeeWallet>;
494
+ writer: TransactionSigner<TAccountWriter>;
495
+ tokenProgram?: Address<TAccountTokenProgram>;
496
+ systemProgram?: Address<TAccountSystemProgram>;
497
+ unwindQty: UnwindWriterUnsoldInstructionDataArgs["unwindQty"];
498
+ };
499
+
500
+ export function getUnwindWriterUnsoldInstruction<
501
+ TAccountOptionPool extends string,
502
+ TAccountOptionAccount extends string,
503
+ TAccountMarketData extends string,
504
+ TAccountCollateralPool extends string,
505
+ TAccountWriterPosition extends string,
506
+ TAccountLongMint extends string,
507
+ TAccountShortMint extends string,
508
+ TAccountEscrowLongAccount extends string,
509
+ TAccountWriterShortAccount extends string,
510
+ TAccountCollateralVault extends string,
511
+ TAccountPremiumVault extends string,
512
+ TAccountWriterCollateralAccount extends string,
513
+ TAccountOmlpVaultState extends string,
514
+ TAccountOmlpVault extends string,
515
+ TAccountFeeWallet extends string,
516
+ TAccountWriter extends string,
517
+ TAccountTokenProgram extends string,
518
+ TAccountSystemProgram extends string,
519
+ TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
520
+ >(
521
+ input: UnwindWriterUnsoldInput<
522
+ TAccountOptionPool,
523
+ TAccountOptionAccount,
524
+ TAccountMarketData,
525
+ TAccountCollateralPool,
526
+ TAccountWriterPosition,
527
+ TAccountLongMint,
528
+ TAccountShortMint,
529
+ TAccountEscrowLongAccount,
530
+ TAccountWriterShortAccount,
531
+ TAccountCollateralVault,
532
+ TAccountPremiumVault,
533
+ TAccountWriterCollateralAccount,
534
+ TAccountOmlpVaultState,
535
+ TAccountOmlpVault,
536
+ TAccountFeeWallet,
537
+ TAccountWriter,
538
+ TAccountTokenProgram,
539
+ TAccountSystemProgram
540
+ >,
541
+ config?: { programAddress?: TProgramAddress },
542
+ ): UnwindWriterUnsoldInstruction<
543
+ TProgramAddress,
544
+ TAccountOptionPool,
545
+ TAccountOptionAccount,
546
+ TAccountMarketData,
547
+ TAccountCollateralPool,
548
+ TAccountWriterPosition,
549
+ TAccountLongMint,
550
+ TAccountShortMint,
551
+ TAccountEscrowLongAccount,
552
+ TAccountWriterShortAccount,
553
+ TAccountCollateralVault,
554
+ TAccountPremiumVault,
555
+ TAccountWriterCollateralAccount,
556
+ TAccountOmlpVaultState,
557
+ TAccountOmlpVault,
558
+ TAccountFeeWallet,
559
+ TAccountWriter,
560
+ TAccountTokenProgram,
561
+ TAccountSystemProgram
562
+ > {
563
+ // Program address.
564
+ const programAddress =
565
+ config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
566
+
567
+ // Original accounts.
568
+ const originalAccounts = {
569
+ optionPool: { value: input.optionPool ?? null, isWritable: true },
570
+ optionAccount: { value: input.optionAccount ?? null, isWritable: true },
571
+ marketData: { value: input.marketData ?? null, isWritable: false },
572
+ collateralPool: { value: input.collateralPool ?? null, isWritable: true },
573
+ writerPosition: { value: input.writerPosition ?? null, isWritable: true },
574
+ longMint: { value: input.longMint ?? null, isWritable: true },
575
+ shortMint: { value: input.shortMint ?? null, isWritable: true },
576
+ escrowLongAccount: {
577
+ value: input.escrowLongAccount ?? null,
578
+ isWritable: true,
579
+ },
580
+ writerShortAccount: {
581
+ value: input.writerShortAccount ?? null,
582
+ isWritable: true,
583
+ },
584
+ collateralVault: { value: input.collateralVault ?? null, isWritable: true },
585
+ premiumVault: { value: input.premiumVault ?? null, isWritable: true },
586
+ writerCollateralAccount: {
587
+ value: input.writerCollateralAccount ?? null,
588
+ isWritable: true,
589
+ },
590
+ omlpVaultState: { value: input.omlpVaultState ?? null, isWritable: true },
591
+ omlpVault: { value: input.omlpVault ?? null, isWritable: true },
592
+ feeWallet: { value: input.feeWallet ?? null, isWritable: true },
593
+ writer: { value: input.writer ?? null, isWritable: true },
594
+ tokenProgram: { value: input.tokenProgram ?? null, isWritable: false },
595
+ systemProgram: { value: input.systemProgram ?? null, isWritable: false },
596
+ };
597
+ const accounts = originalAccounts as Record<
598
+ keyof typeof originalAccounts,
599
+ ResolvedAccount
600
+ >;
601
+
602
+ // Original args.
603
+ const args = { ...input };
604
+
605
+ // Resolve default values.
606
+ if (!accounts.tokenProgram.value) {
607
+ accounts.tokenProgram.value =
608
+ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
609
+ }
610
+ if (!accounts.systemProgram.value) {
611
+ accounts.systemProgram.value =
612
+ "11111111111111111111111111111111" as Address<"11111111111111111111111111111111">;
613
+ }
614
+
615
+ const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
616
+ return Object.freeze({
617
+ accounts: [
618
+ getAccountMeta(accounts.optionPool),
619
+ getAccountMeta(accounts.optionAccount),
620
+ getAccountMeta(accounts.marketData),
621
+ getAccountMeta(accounts.collateralPool),
622
+ getAccountMeta(accounts.writerPosition),
623
+ getAccountMeta(accounts.longMint),
624
+ getAccountMeta(accounts.shortMint),
625
+ getAccountMeta(accounts.escrowLongAccount),
626
+ getAccountMeta(accounts.writerShortAccount),
627
+ getAccountMeta(accounts.collateralVault),
628
+ getAccountMeta(accounts.premiumVault),
629
+ getAccountMeta(accounts.writerCollateralAccount),
630
+ getAccountMeta(accounts.omlpVaultState),
631
+ getAccountMeta(accounts.omlpVault),
632
+ getAccountMeta(accounts.feeWallet),
633
+ getAccountMeta(accounts.writer),
634
+ getAccountMeta(accounts.tokenProgram),
635
+ getAccountMeta(accounts.systemProgram),
636
+ ],
637
+ data: getUnwindWriterUnsoldInstructionDataEncoder().encode(
638
+ args as UnwindWriterUnsoldInstructionDataArgs,
639
+ ),
640
+ programAddress,
641
+ } as UnwindWriterUnsoldInstruction<
642
+ TProgramAddress,
643
+ TAccountOptionPool,
644
+ TAccountOptionAccount,
645
+ TAccountMarketData,
646
+ TAccountCollateralPool,
647
+ TAccountWriterPosition,
648
+ TAccountLongMint,
649
+ TAccountShortMint,
650
+ TAccountEscrowLongAccount,
651
+ TAccountWriterShortAccount,
652
+ TAccountCollateralVault,
653
+ TAccountPremiumVault,
654
+ TAccountWriterCollateralAccount,
655
+ TAccountOmlpVaultState,
656
+ TAccountOmlpVault,
657
+ TAccountFeeWallet,
658
+ TAccountWriter,
659
+ TAccountTokenProgram,
660
+ TAccountSystemProgram
661
+ >);
662
+ }
663
+
664
+ export type ParsedUnwindWriterUnsoldInstruction<
665
+ TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
666
+ TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
667
+ > = {
668
+ programAddress: Address<TProgram>;
669
+ accounts: {
670
+ /** The option pool */
671
+ optionPool: TAccountMetas[0];
672
+ /** The option account */
673
+ optionAccount: TAccountMetas[1];
674
+ /** Market data (historical vol baseline for IV kink) */
675
+ marketData: TAccountMetas[2];
676
+ /** Collateral pool */
677
+ collateralPool: TAccountMetas[3];
678
+ /** Writer's unified position account */
679
+ writerPosition: TAccountMetas[4];
680
+ /** LONG token mint (for burning from escrow) */
681
+ longMint: TAccountMetas[5];
682
+ /** SHORT token mint (for burning from writer) */
683
+ shortMint: TAccountMetas[6];
684
+ /** Pool's LONG escrow (source of LONG tokens to burn) */
685
+ escrowLongAccount: TAccountMetas[7];
686
+ /** Writer's SHORT token account (source of SHORT tokens to burn) */
687
+ writerShortAccount: TAccountMetas[8];
688
+ /** Collateral vault (source of collateral return + collateral-side debt repayment) */
689
+ collateralVault: TAccountMetas[9];
690
+ /**
691
+ * Pool premium vault (source of theta-first debt repayment + leftover
692
+ * theta returned to the writer). Same underlying_mint as the pool.
693
+ */
694
+ premiumVault: TAccountMetas[10];
695
+ /**
696
+ * Writer's token account for returned collateral + any leftover theta.
697
+ * Must be the underlying_mint so leftover theta (denominated in
698
+ * premium_vault.mint == underlying_mint) can be deposited here.
699
+ */
700
+ writerCollateralAccount: TAccountMetas[11];
701
+ /** OMLP Vault state PDA (for total_loans, add_interest_to_index) - optional, required when repaying loans */
702
+ omlpVaultState?: TAccountMetas[12] | undefined;
703
+ /** OMLP vault token account (receives loan repayments) - optional */
704
+ omlpVault?: TAccountMetas[13] | undefined;
705
+ /** Protocol fee wallet (receives protocol fees) - optional */
706
+ feeWallet?: TAccountMetas[14] | undefined;
707
+ writer: TAccountMetas[15];
708
+ tokenProgram: TAccountMetas[16];
709
+ systemProgram: TAccountMetas[17];
710
+ };
711
+ data: UnwindWriterUnsoldInstructionData;
712
+ };
713
+
714
+ export function parseUnwindWriterUnsoldInstruction<
715
+ TProgram extends string,
716
+ TAccountMetas extends readonly AccountMeta[],
717
+ >(
718
+ instruction: Instruction<TProgram> &
719
+ InstructionWithAccounts<TAccountMetas> &
720
+ InstructionWithData<ReadonlyUint8Array>,
721
+ ): ParsedUnwindWriterUnsoldInstruction<TProgram, TAccountMetas> {
722
+ if (instruction.accounts.length < 18) {
723
+ // TODO: Coded error.
724
+ throw new Error("Not enough accounts");
725
+ }
726
+ let accountIndex = 0;
727
+ const getNextAccount = () => {
728
+ const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
729
+ accountIndex += 1;
730
+ return accountMeta;
731
+ };
732
+ const getNextOptionalAccount = () => {
733
+ const accountMeta = getNextAccount();
734
+ return accountMeta.address === OPTION_PROGRAM_PROGRAM_ADDRESS
735
+ ? undefined
736
+ : accountMeta;
737
+ };
738
+ return {
739
+ programAddress: instruction.programAddress,
740
+ accounts: {
741
+ optionPool: getNextAccount(),
742
+ optionAccount: getNextAccount(),
743
+ marketData: getNextAccount(),
744
+ collateralPool: getNextAccount(),
745
+ writerPosition: getNextAccount(),
746
+ longMint: getNextAccount(),
747
+ shortMint: getNextAccount(),
748
+ escrowLongAccount: getNextAccount(),
749
+ writerShortAccount: getNextAccount(),
750
+ collateralVault: getNextAccount(),
751
+ premiumVault: getNextAccount(),
752
+ writerCollateralAccount: getNextAccount(),
753
+ omlpVaultState: getNextOptionalAccount(),
754
+ omlpVault: getNextOptionalAccount(),
755
+ feeWallet: getNextOptionalAccount(),
756
+ writer: getNextAccount(),
757
+ tokenProgram: getNextAccount(),
758
+ systemProgram: getNextAccount(),
759
+ },
760
+ data: getUnwindWriterUnsoldInstructionDataDecoder().decode(
761
+ instruction.data,
762
+ ),
763
+ };
764
+ }