@epicentral/sos-sdk 0.14.1-beta → 0.15.0-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/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/generated/instructions/index.ts

@@ -51,5 +51,6 @@ export * from "./transferMarketDataAuthority";
 export * from "./unwindWriterUnsold";
 export * from "./updateImpliedVolatility";
 export * from "./updateMarketData";
+export * from "./updateMarketDataSwitchboardFeed";
 export * from "./withdrawFromPosition";
 export * from "./writeToPool";

package/generated/instructions/updateMarketDataSwitchboardFeed.ts

@@ -0,0 +1,312 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+  combineCodec,
+  fixDecoderSize,
+  fixEncoderSize,
+  getAddressEncoder,
+  getBytesDecoder,
+  getBytesEncoder,
+  getProgramDerivedAddress,
+  getStructDecoder,
+  getStructEncoder,
+  transformEncoder,
+  type AccountMeta,
+  type AccountSignerMeta,
+  type Address,
+  type FixedSizeCodec,
+  type FixedSizeDecoder,
+  type FixedSizeEncoder,
+  type Instruction,
+  type InstructionWithAccounts,
+  type InstructionWithData,
+  type ReadonlyAccount,
+  type ReadonlySignerAccount,
+  type ReadonlyUint8Array,
+  type TransactionSigner,
+  type WritableAccount,
+} from "@solana/kit";
+import { OPTION_PROGRAM_PROGRAM_ADDRESS } from "../programs";
+import {
+  expectAddress,
+  getAccountMetaFactory,
+  type ResolvedAccount,
+} from "../shared";
+
+export const UPDATE_MARKET_DATA_SWITCHBOARD_FEED_DISCRIMINATOR = new Uint8Array(
+  [146, 182, 211, 101, 104, 69, 76, 109],
+);
+
+export function getUpdateMarketDataSwitchboardFeedDiscriminatorBytes() {
+  return fixEncoderSize(getBytesEncoder(), 8).encode(
+    UPDATE_MARKET_DATA_SWITCHBOARD_FEED_DISCRIMINATOR,
+  );
+}
+
+export type UpdateMarketDataSwitchboardFeedInstruction<
+  TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
+  TAccountMarketData extends string | AccountMeta<string> = string,
+  TAccountUnderlyingAsset extends string | AccountMeta<string> = string,
+  TAccountAuthority extends string | AccountMeta<string> = string,
+  TRemainingAccounts extends readonly AccountMeta<string>[] = [],
+> = Instruction<TProgram> &
+  InstructionWithData<ReadonlyUint8Array> &
+  InstructionWithAccounts<
+    [
+      TAccountMarketData extends string
+        ? WritableAccount<TAccountMarketData>
+        : TAccountMarketData,
+      TAccountUnderlyingAsset extends string
+        ? ReadonlyAccount<TAccountUnderlyingAsset>
+        : TAccountUnderlyingAsset,
+      TAccountAuthority extends string
+        ? ReadonlySignerAccount<TAccountAuthority> &
+            AccountSignerMeta<TAccountAuthority>
+        : TAccountAuthority,
+      ...TRemainingAccounts,
+    ]
+  >;
+
+export type UpdateMarketDataSwitchboardFeedInstructionData = {
+  discriminator: ReadonlyUint8Array;
+  newSwitchboardFeedId: ReadonlyUint8Array;
+};
+
+export type UpdateMarketDataSwitchboardFeedInstructionDataArgs = {
+  newSwitchboardFeedId: ReadonlyUint8Array;
+};
+
+export function getUpdateMarketDataSwitchboardFeedInstructionDataEncoder(): FixedSizeEncoder<UpdateMarketDataSwitchboardFeedInstructionDataArgs> {
+  return transformEncoder(
+    getStructEncoder([
+      ["discriminator", fixEncoderSize(getBytesEncoder(), 8)],
+      ["newSwitchboardFeedId", fixEncoderSize(getBytesEncoder(), 32)],
+    ]),
+    (value) => ({
+      ...value,
+      discriminator: UPDATE_MARKET_DATA_SWITCHBOARD_FEED_DISCRIMINATOR,
+    }),
+  );
+}
+
+export function getUpdateMarketDataSwitchboardFeedInstructionDataDecoder(): FixedSizeDecoder<UpdateMarketDataSwitchboardFeedInstructionData> {
+  return getStructDecoder([
+    ["discriminator", fixDecoderSize(getBytesDecoder(), 8)],
+    ["newSwitchboardFeedId", fixDecoderSize(getBytesDecoder(), 32)],
+  ]);
+}
+
+export function getUpdateMarketDataSwitchboardFeedInstructionDataCodec(): FixedSizeCodec<
+  UpdateMarketDataSwitchboardFeedInstructionDataArgs,
+  UpdateMarketDataSwitchboardFeedInstructionData
+> {
+  return combineCodec(
+    getUpdateMarketDataSwitchboardFeedInstructionDataEncoder(),
+    getUpdateMarketDataSwitchboardFeedInstructionDataDecoder(),
+  );
+}
+
+export type UpdateMarketDataSwitchboardFeedAsyncInput<
+  TAccountMarketData extends string = string,
+  TAccountUnderlyingAsset extends string = string,
+  TAccountAuthority extends string = string,
+> = {
+  marketData?: Address<TAccountMarketData>;
+  underlyingAsset: Address<TAccountUnderlyingAsset>;
+  authority: TransactionSigner<TAccountAuthority>;
+  newSwitchboardFeedId: UpdateMarketDataSwitchboardFeedInstructionDataArgs["newSwitchboardFeedId"];
+};
+
+export async function getUpdateMarketDataSwitchboardFeedInstructionAsync<
+  TAccountMarketData extends string,
+  TAccountUnderlyingAsset extends string,
+  TAccountAuthority extends string,
+  TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
+>(
+  input: UpdateMarketDataSwitchboardFeedAsyncInput<
+    TAccountMarketData,
+    TAccountUnderlyingAsset,
+    TAccountAuthority
+  >,
+  config?: { programAddress?: TProgramAddress },
+): Promise<
+  UpdateMarketDataSwitchboardFeedInstruction<
+    TProgramAddress,
+    TAccountMarketData,
+    TAccountUnderlyingAsset,
+    TAccountAuthority
+  >
+> {
+  // Program address.
+  const programAddress =
+    config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
+
+  // Original accounts.
+  const originalAccounts = {
+    marketData: { value: input.marketData ?? null, isWritable: true },
+    underlyingAsset: {
+      value: input.underlyingAsset ?? null,
+      isWritable: false,
+    },
+    authority: { value: input.authority ?? null, isWritable: false },
+  };
+  const accounts = originalAccounts as Record<
+    keyof typeof originalAccounts,
+    ResolvedAccount
+  >;
+
+  // Original args.
+  const args = { ...input };
+
+  // Resolve default values.
+  if (!accounts.marketData.value) {
+    accounts.marketData.value = await getProgramDerivedAddress({
+      programAddress,
+      seeds: [
+        getBytesEncoder().encode(
+          new Uint8Array([109, 97, 114, 107, 101, 116, 95, 100, 97, 116, 97]),
+        ),
+        getAddressEncoder().encode(
+          expectAddress(accounts.underlyingAsset.value),
+        ),
+      ],
+    });
+  }
+
+  const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
+  return Object.freeze({
+    accounts: [
+      getAccountMeta(accounts.marketData),
+      getAccountMeta(accounts.underlyingAsset),
+      getAccountMeta(accounts.authority),
+    ],
+    data: getUpdateMarketDataSwitchboardFeedInstructionDataEncoder().encode(
+      args as UpdateMarketDataSwitchboardFeedInstructionDataArgs,
+    ),
+    programAddress,
+  } as UpdateMarketDataSwitchboardFeedInstruction<
+    TProgramAddress,
+    TAccountMarketData,
+    TAccountUnderlyingAsset,
+    TAccountAuthority
+  >);
+}
+
+export type UpdateMarketDataSwitchboardFeedInput<
+  TAccountMarketData extends string = string,
+  TAccountUnderlyingAsset extends string = string,
+  TAccountAuthority extends string = string,
+> = {
+  marketData: Address<TAccountMarketData>;
+  underlyingAsset: Address<TAccountUnderlyingAsset>;
+  authority: TransactionSigner<TAccountAuthority>;
+  newSwitchboardFeedId: UpdateMarketDataSwitchboardFeedInstructionDataArgs["newSwitchboardFeedId"];
+};
+
+export function getUpdateMarketDataSwitchboardFeedInstruction<
+  TAccountMarketData extends string,
+  TAccountUnderlyingAsset extends string,
+  TAccountAuthority extends string,
+  TProgramAddress extends Address = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
+>(
+  input: UpdateMarketDataSwitchboardFeedInput<
+    TAccountMarketData,
+    TAccountUnderlyingAsset,
+    TAccountAuthority
+  >,
+  config?: { programAddress?: TProgramAddress },
+): UpdateMarketDataSwitchboardFeedInstruction<
+  TProgramAddress,
+  TAccountMarketData,
+  TAccountUnderlyingAsset,
+  TAccountAuthority
+> {
+  // Program address.
+  const programAddress =
+    config?.programAddress ?? OPTION_PROGRAM_PROGRAM_ADDRESS;
+
+  // Original accounts.
+  const originalAccounts = {
+    marketData: { value: input.marketData ?? null, isWritable: true },
+    underlyingAsset: {
+      value: input.underlyingAsset ?? null,
+      isWritable: false,
+    },
+    authority: { value: input.authority ?? null, isWritable: false },
+  };
+  const accounts = originalAccounts as Record<
+    keyof typeof originalAccounts,
+    ResolvedAccount
+  >;
+
+  // Original args.
+  const args = { ...input };
+
+  const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
+  return Object.freeze({
+    accounts: [
+      getAccountMeta(accounts.marketData),
+      getAccountMeta(accounts.underlyingAsset),
+      getAccountMeta(accounts.authority),
+    ],
+    data: getUpdateMarketDataSwitchboardFeedInstructionDataEncoder().encode(
+      args as UpdateMarketDataSwitchboardFeedInstructionDataArgs,
+    ),
+    programAddress,
+  } as UpdateMarketDataSwitchboardFeedInstruction<
+    TProgramAddress,
+    TAccountMarketData,
+    TAccountUnderlyingAsset,
+    TAccountAuthority
+  >);
+}
+
+export type ParsedUpdateMarketDataSwitchboardFeedInstruction<
+  TProgram extends string = typeof OPTION_PROGRAM_PROGRAM_ADDRESS,
+  TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
+> = {
+  programAddress: Address<TProgram>;
+  accounts: {
+    marketData: TAccountMetas[0];
+    underlyingAsset: TAccountMetas[1];
+    authority: TAccountMetas[2];
+  };
+  data: UpdateMarketDataSwitchboardFeedInstructionData;
+};
+
+export function parseUpdateMarketDataSwitchboardFeedInstruction<
+  TProgram extends string,
+  TAccountMetas extends readonly AccountMeta[],
+>(
+  instruction: Instruction<TProgram> &
+    InstructionWithAccounts<TAccountMetas> &
+    InstructionWithData<ReadonlyUint8Array>,
+): ParsedUpdateMarketDataSwitchboardFeedInstruction<TProgram, TAccountMetas> {
+  if (instruction.accounts.length < 3) {
+    // TODO: Coded error.
+    throw new Error("Not enough accounts");
+  }
+  let accountIndex = 0;
+  const getNextAccount = () => {
+    const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
+    accountIndex += 1;
+    return accountMeta;
+  };
+  return {
+    programAddress: instruction.programAddress,
+    accounts: {
+      marketData: getNextAccount(),
+      underlyingAsset: getNextAccount(),
+      authority: getNextAccount(),
+    },
+    data: getUpdateMarketDataSwitchboardFeedInstructionDataDecoder().decode(
+      instruction.data,
+    ),
+  };
+}

package/generated/programs/optionProgram.ts

@@ -59,6 +59,7 @@ import {
   type ParsedUnwindWriterUnsoldInstruction,
   type ParsedUpdateImpliedVolatilityInstruction,
   type ParsedUpdateMarketDataInstruction,
+  type ParsedUpdateMarketDataSwitchboardFeedInstruction,
   type ParsedWithdrawFromPositionInstruction,
   type ParsedWriteToPoolInstruction,
 } from "../instructions";
@@ -292,6 +293,7 @@ export enum OptionProgramInstruction {
   UnwindWriterUnsold,
   UpdateImpliedVolatility,
   UpdateMarketData,
+  UpdateMarketDataSwitchboardFeed,
   WithdrawFromPosition,
   WriteToPool,
 }
@@ -795,6 +797,17 @@ export function identifyOptionProgramInstruction(
   ) {
     return OptionProgramInstruction.UpdateMarketData;
   }
+  if (
+    containsBytes(
+      data,
+      fixEncoderSize(getBytesEncoder(), 8).encode(
+        new Uint8Array([146, 182, 211, 101, 104, 69, 76, 109]),
+      ),
+      0,
+    )
+  ) {
+    return OptionProgramInstruction.UpdateMarketDataSwitchboardFeed;
+  }
   if (
     containsBytes(
       data,
@@ -960,6 +973,9 @@ export type ParsedOptionProgramInstruction<
   | ({
       instructionType: OptionProgramInstruction.UpdateMarketData;
     } & ParsedUpdateMarketDataInstruction<TProgram>)
+  | ({
+      instructionType: OptionProgramInstruction.UpdateMarketDataSwitchboardFeed;
+    } & ParsedUpdateMarketDataSwitchboardFeedInstruction<TProgram>)
   | ({
       instructionType: OptionProgramInstruction.WithdrawFromPosition;
     } & ParsedWithdrawFromPositionInstruction<TProgram>)

package/generated/types/index.ts

@@ -11,6 +11,7 @@ export * from "./liquidationExecuted";
 export * from "./liquidationRescueEvent";
 export * from "./marketDataAuthorityTransferred";
 export * from "./marketDataInitialized";
+export * from "./marketDataSwitchboardFeedUpdated";
 export * from "./marketDataUpdated";
 export * from "./optionClosed";
 export * from "./optionExercised";

package/generated/types/marketDataSwitchboardFeedUpdated.ts

@@ -0,0 +1,62 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+  combineCodec,
+  fixDecoderSize,
+  fixEncoderSize,
+  getAddressDecoder,
+  getAddressEncoder,
+  getBytesDecoder,
+  getBytesEncoder,
+  getStructDecoder,
+  getStructEncoder,
+  type Address,
+  type FixedSizeCodec,
+  type FixedSizeDecoder,
+  type FixedSizeEncoder,
+  type ReadonlyUint8Array,
+} from "@solana/kit";
+
+export type MarketDataSwitchboardFeedUpdated = {
+  marketData: Address;
+  underlyingAsset: Address;
+  previousFeedId: ReadonlyUint8Array;
+  newFeedId: ReadonlyUint8Array;
+};
+
+export type MarketDataSwitchboardFeedUpdatedArgs =
+  MarketDataSwitchboardFeedUpdated;
+
+export function getMarketDataSwitchboardFeedUpdatedEncoder(): FixedSizeEncoder<MarketDataSwitchboardFeedUpdatedArgs> {
+  return getStructEncoder([
+    ["marketData", getAddressEncoder()],
+    ["underlyingAsset", getAddressEncoder()],
+    ["previousFeedId", fixEncoderSize(getBytesEncoder(), 32)],
+    ["newFeedId", fixEncoderSize(getBytesEncoder(), 32)],
+  ]);
+}
+
+export function getMarketDataSwitchboardFeedUpdatedDecoder(): FixedSizeDecoder<MarketDataSwitchboardFeedUpdated> {
+  return getStructDecoder([
+    ["marketData", getAddressDecoder()],
+    ["underlyingAsset", getAddressDecoder()],
+    ["previousFeedId", fixDecoderSize(getBytesDecoder(), 32)],
+    ["newFeedId", fixDecoderSize(getBytesDecoder(), 32)],
+  ]);
+}
+
+export function getMarketDataSwitchboardFeedUpdatedCodec(): FixedSizeCodec<
+  MarketDataSwitchboardFeedUpdatedArgs,
+  MarketDataSwitchboardFeedUpdated
+> {
+  return combineCodec(
+    getMarketDataSwitchboardFeedUpdatedEncoder(),
+    getMarketDataSwitchboardFeedUpdatedDecoder(),
+  );
+}

package/oracle/switchboard.ts

@@ -49,6 +49,9 @@ const KNOWN_FEED_ID_TO_ACCOUNT: Record<SwitchboardNetwork, Record<string, string
       "EneYGtye2n7jkSwGvQtwBaY6VBhP2mbizHD2y7hNkGFC",
     "0x883ea8295f70ae506e894679d124196bb07064ea530cefd835b58c33a5ab6549":
       "DHB2Ph8CK7PmR3xswqcmDkgQeucnwSZtfnMpnc7mQgkb",
+    // META/USD (Jupiter + DexScreener) — devnet-only oracle-only underlying.
+    "0xec1034d10cb4ddb6dcc8f74b5a90b2e5174c4e09087b7adfdfbca9a40c07a150":
+      "6kExysxFcXA7njNspz1P7ude3rB3r4UKJXhtkUsUrJRF",
   },
   mainnet: {
     "0x822512ee9add93518eca1c105a38422841a76c590db079eebb283deb2c14caa9":

package/package.json

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