@epicentral/sos-sdk 0.14.0-beta → 0.14.2-beta

package/README.md

@@ -398,6 +398,7 @@ Error codes to watch (see `generated/errors/optionProgram.ts`):
 - `RescueUnauthorized` (6102) — rescue ix caller is not the vault keeper.
 - `InvalidLoanRepayment` (6103) — repayment exceeded synced balances (slot race).
 - `RescuePreconditionsNotMet` (6104) — rescue called on a solvent position.
+- `StaleCanonicalLoanRequiresCleanup` — `option_mint` (leveraged) found the canonical loan (`["pool_loan", writer_position]`) carrying untracked residual principal from an abandoned borrow setup (TX A landed, TX B never completed). Repay the open loan before re-minting; the OPX client auto-repays via `cleanupStaleCanonicalLoanBeforeMint` before the borrow.
 
 ## Usage Examples
 

package/accounts/list.ts

@@ -146,6 +146,28 @@ export async function fetchWriterPositionsForPool(
   );
 }
 
+/**
+ * Fetches every WriterPosition account for the program in a single getProgramAccounts call.
+ *
+ * Use this instead of calling {@link fetchWriterPositionsForPool} once per pool when you need
+ * writer positions across many pools (e.g. option-chain sync). The caller can group the result
+ * by `data.optionPool` in memory, turning N RPC round-trips into one.
+ */
+export async function fetchAllWriterPositions(
+  rpc: KitRpc,
+  programId?: AddressLike
+): Promise<Array<ListedAccount<WriterPosition>>> {
+  return fetchAndDecodeProgramAccounts(
+    rpc,
+    getWriterPositionDecoder(),
+    [
+      discriminatorFilter(WRITER_POSITION_DISCRIMINATOR),
+      { dataSize: BigInt(getWriterPositionSize()) },
+    ],
+    programId ?? PROGRAM_ID
+  );
+}
+
 export async function fetchPositionAccountsByBuyer(
   rpc: KitRpc,
   buyer: AddressLike

package/generated/errors/optionProgram.ts

@@ -240,6 +240,8 @@ export const OPTION_PROGRAM_ERROR__RESCUE_UNAUTHORIZED = 0x17de; // 6110
 export const OPTION_PROGRAM_ERROR__INVALID_LOAN_REPAYMENT = 0x17df; // 6111
 /** RescuePreconditionsNotMet: Rescue preconditions not met: collateral_vault must be short of the remaining debt after theta forfeiture */
 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
 
 export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__ACCOUNT_FROZEN
@@ -343,6 +345,7 @@ export type OptionProgramError =
   | typeof OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_ALREADY_PREPARED
   | typeof OPTION_PROGRAM_ERROR__SETTLEMENT_CLAIM_NOT_PREPARED
   | typeof OPTION_PROGRAM_ERROR__SLIPPAGE_TOLERANCE_EXCEEDED
+  | typeof OPTION_PROGRAM_ERROR__STALE_CANONICAL_LOAN_REQUIRES_CLEANUP
   | typeof OPTION_PROGRAM_ERROR__STALE_MARKET_DATA
   | typeof OPTION_PROGRAM_ERROR__STALE_ORACLE_PRICE
   | typeof OPTION_PROGRAM_ERROR__SUPPLY_LIMIT_EXCEEDED
@@ -460,6 +463,7 @@ if (process.env.NODE_ENV !== "production") {
     [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`,
     [OPTION_PROGRAM_ERROR__SLIPPAGE_TOLERANCE_EXCEEDED]: `Slippage tolerance exceeded`,
+    [OPTION_PROGRAM_ERROR__STALE_CANONICAL_LOAN_REQUIRES_CLEANUP]: `Canonical pool loan carries untracked residual principal from an abandoned borrow setup; repay/clean up the open loan before minting`,
     [OPTION_PROGRAM_ERROR__STALE_MARKET_DATA]: `Market data is stale and needs to be updated`,
     [OPTION_PROGRAM_ERROR__STALE_ORACLE_PRICE]: `Oracle price is too old`,
     [OPTION_PROGRAM_ERROR__SUPPLY_LIMIT_EXCEEDED]: `Deposit would exceed vault supply limit`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epicentral/sos-sdk",
-  "version": "0.14.0-beta",
+  "version": "0.14.2-beta",
   "private": false,
   "description": "Solana Option Standard SDK. The frontend-first SDK for Native Options Trading on Solana. Created by Epicentral Labs.",
   "type": "module",