@epicentral/sos-sdk 0.15.2-beta → 0.16.0-beta

package/README.md

@@ -61,6 +61,10 @@ Additional modules:
 | Function | Description |
 |----------|-------------|
 | `buildOptionMintTransactionWithDerivation` | Builds option mint (write) transaction. By default appends CloseAccount for the maker's LONG token account after mint (reclaim rent). Supports multi-collateral: use `collateralMint` to back positions with any supported asset (USDC, BTC, SOL, etc.). |
+| `deriveOptionSeriesLegAddresses` | Multi-strike: derives every per-leg PDA/ATA (option account, mints, pools, vaults, maker SHORT ATA, writer position, canonical pool loan) for one strike. |
+| `findLegsNeedingSeriesInit` | Multi-strike: returns the legs whose option account or writer position is missing on-chain (i.e. need `init_option_series`). |
+| `buildInitOptionSeriesInstruction` | Multi-strike: one `init_option_series` instruction — creates the series (option account, mints, pools, ATAs, writer position) **without Metaplex metadata** and without an oracle quote. Idempotent; chunk `MAX_SERIES_INITS_PER_TRANSACTION` (2) per tx. |
+| `buildOptionMintMultiTransactionWithDerivation` | Multi-strike: chunks legs into `option_mint_multi` transactions of ≤ `MAX_MINT_LEGS` (3, on-chain max 4), one Switchboard quote per chunk (`switchboardQuoteInstructionIndex`, OPX passes 2), per-leg account bundles in remaining accounts, and returns `lookupAddresses` for ALT extension before sending. Every leg's series must already exist (`SeriesNotInitialized` otherwise). Unlevered legs only is the typical use; leveraged legs require the canonical pool loan to exist per strike. |
 | `buildUnwindWriterUnsoldTransactionWithDerivation` | Builds unwind unsold transaction. |
 | `buildUnwindWriterUnsoldWithLoanRepayment` | **Unwind + repay pool loans in one tx.** Use when closing unsold shorts that borrowed from OMLP. |
 | `buildSyncWriterPositionTransaction` | Syncs writer position with pool accumulators. |

package/generated/errors/optionProgram.ts

@@ -242,6 +242,12 @@ export const OPTION_PROGRAM_ERROR__INVALID_LOAN_REPAYMENT = 0x17df; // 6111
 export const OPTION_PROGRAM_ERROR__RESCUE_PRECONDITIONS_NOT_MET = 0x17e0; // 6112
 /** StaleCanonicalLoanRequiresCleanup: Canonical pool loan carries untracked residual principal from an abandoned borrow setup; repay/clean up the open loan before minting */
 export const OPTION_PROGRAM_ERROR__STALE_CANONICAL_LOAN_REQUIRES_CLEANUP = 0x17e1; // 6113
+/** SeriesNotInitialized: Option series not initialized for this leg; call init_option_series first */
+export const OPTION_PROGRAM_ERROR__SERIES_NOT_INITIALIZED = 0x17e2; // 6114
+/** TooManyMintLegs: option_mint_multi received more legs than MAX_MINT_LEGS allows */
+export const OPTION_PROGRAM_ERROR__TOO_MANY_MINT_LEGS = 0x17e3; // 6115
+/** MintLegAccountsMismatch: option_mint_multi remaining_accounts do not match the expected per-leg layout */
+export const OPTION_PROGRAM_ERROR__MINT_LEG_ACCOUNTS_MISMATCH = 0x17e4; // 6116
 
 export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__ACCOUNT_FROZEN
@@ -316,6 +322,7 @@ export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__MAXIMUM_POSITION_SIZE_EXCEEDED
   | typeof OPTION_PROGRAM_ERROR__MAX_POSITIONS_REACHED
   | typeof OPTION_PROGRAM_ERROR__MINIMUM_POSITION_SIZE_NOT_MET
+  | typeof OPTION_PROGRAM_ERROR__MINT_LEG_ACCOUNTS_MISMATCH
   | typeof OPTION_PROGRAM_ERROR__NO_COLLATERAL_TO_WITHDRAW
   | typeof OPTION_PROGRAM_ERROR__NO_POSITIONS_PROVIDED
   | typeof OPTION_PROGRAM_ERROR__NOT_FORECLOSABLE
@@ -341,6 +348,7 @@ export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__PRICE_IMPACT_TOO_HIGH
   | typeof OPTION_PROGRAM_ERROR__RESCUE_PRECONDITIONS_NOT_MET
   | typeof OPTION_PROGRAM_ERROR__RESCUE_UNAUTHORIZED
+  | typeof OPTION_PROGRAM_ERROR__SERIES_NOT_INITIALIZED
   | typeof OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_ALREADY_CLAIMED
   | typeof OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_ALREADY_PREPARED
   | typeof OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_NOT_PREPARED
@@ -350,6 +358,7 @@ export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__STALE_ORACLE_PRICE
   | typeof OPTION_PROGRAM_ERROR__SUPPLY_LIMIT_EXCEEDED
   | typeof OPTION_PROGRAM_ERROR__THETA_CLAIM_DISABLED
+  | typeof OPTION_PROGRAM_ERROR__TOO_MANY_MINT_LEGS
   | typeof OPTION_PROGRAM_ERROR__UNAUTHORIZED_ACCESS
   | typeof OPTION_PROGRAM_ERROR__UNAUTHORIZED_EXERCISE
   | typeof OPTION_PROGRAM_ERROR__UNAUTHORIZED_OMLP
@@ -434,6 +443,7 @@ if (process.env.NODE_ENV !== "production") {
     [OPTION_PROGRAM_ERROR__MAXIMUM_POSITION_SIZE_EXCEEDED]: `Maximum position size exceeded`,
     [OPTION_PROGRAM_ERROR__MAX_POSITIONS_REACHED]: `Maximum positions limit reached`,
     [OPTION_PROGRAM_ERROR__MINIMUM_POSITION_SIZE_NOT_MET]: `Minimum position size not met`,
+    [OPTION_PROGRAM_ERROR__MINT_LEG_ACCOUNTS_MISMATCH]: `option_mint_multi remaining_accounts do not match the expected per-leg layout`,
     [OPTION_PROGRAM_ERROR__NO_COLLATERAL_TO_WITHDRAW]: `No collateral to withdraw`,
     [OPTION_PROGRAM_ERROR__NO_POSITIONS_PROVIDED]: `No positions provided in batch`,
     [OPTION_PROGRAM_ERROR__NOT_FORECLOSABLE]: `Loan is not eligible for foreclosure`,
@@ -459,6 +469,7 @@ if (process.env.NODE_ENV !== "production") {
     [OPTION_PROGRAM_ERROR__PRICE_IMPACT_TOO_HIGH]: `Price impact too high`,
     [OPTION_PROGRAM_ERROR__RESCUE_PRECONDITIONS_NOT_MET]: `Rescue preconditions not met: collateral_vault must be short of the remaining debt after theta forfeiture`,
     [OPTION_PROGRAM_ERROR__RESCUE_UNAUTHORIZED]: `Rescue liquidation is gated to the vault keeper`,
+    [OPTION_PROGRAM_ERROR__SERIES_NOT_INITIALIZED]: `Option series not initialized for this leg; call init_option_series first`,
     [OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_ALREADY_CLAIMED]: `Settlement claim has already been claimed`,
     [OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_ALREADY_PREPARED]: `Settlement claim has already been prepared`,
     [OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_NOT_PREPARED]: `Settlement claim has not been prepared`,
@@ -468,6 +479,7 @@ if (process.env.NODE_ENV !== "production") {
     [OPTION_PROGRAM_ERROR__STALE_ORACLE_PRICE]: `Oracle price is too old`,
     [OPTION_PROGRAM_ERROR__SUPPLY_LIMIT_EXCEEDED]: `Deposit would exceed vault supply limit`,
     [OPTION_PROGRAM_ERROR__THETA_CLAIM_DISABLED]: `claim_theta instruction has been removed; theta is now auto-realized on unwind or forfeited on liquidation`,
+    [OPTION_PROGRAM_ERROR__TOO_MANY_MINT_LEGS]: `option_mint_multi received more legs than MAX_MINT_LEGS allows`,
     [OPTION_PROGRAM_ERROR__UNAUTHORIZED_ACCESS]: `Unauthorized access - you don't own this resource`,
     [OPTION_PROGRAM_ERROR__UNAUTHORIZED_EXERCISE]: `Unauthorized to exercise this option`,
     [OPTION_PROGRAM_ERROR__UNAUTHORIZED_OMLP]: `Unauthorized to perform this OMLP action`,

package/generated/instructions/index.ts

@@ -23,6 +23,7 @@ export * from "./initCollateralPool";
 export * from "./initConfig";
 export * from "./initializeMarketData";
 export * from "./initOptionPool";
+export * from "./initOptionSeries";
 export * from "./liquidateWriterPosition";
 export * from "./liquidateWriterPositionRescue";
 export * from "./migrateCollateralPoolV1ToV2";
@@ -38,6 +39,7 @@ export * from "./omlpUpdateProtocolFee";
 export * from "./omlpUpdateSupplyLimit";
 export * from "./optionExercise";
 export * from "./optionMint";
+export * from "./optionMintMulti";
 export * from "./optionValidate";
 export * from "./prepareBuyerSettlement";
 export * from "./prepareMakerSettlement";