@epicentral/sos-sdk 0.2.4 → 0.2.5

package/accounts/fetchers.ts

@@ -129,3 +129,41 @@ export async function fetchManyAccounts(
     exists: infos[index] !== null,
   }));
 }
+
+const optionDecoder = getOptionAccountDecoder();
+
+/**
+ * Batch-fetches option accounts via getMultipleAccounts (one RPC round-trip).
+ * Returns a Map from address to OptionAccount or null if missing/invalid.
+ */
+export async function fetchOptionAccounts(
+  rpc: KitRpc,
+  addresses: AddressLike[]
+): Promise<Map<Address, OptionAccount | null>> {
+  if (addresses.length === 0) return new Map();
+  const keys = addresses.map((value) => toAddress(value));
+  const response = await rpc.getMultipleAccounts(keys, { encoding: "base64" }).send();
+  const infos = response.value;
+  const result = new Map<Address, OptionAccount | null>();
+  for (let i = 0; i < keys.length; i++) {
+    const accountInfo = infos[i];
+    if (!accountInfo) {
+      result.set(keys[i], null);
+      continue;
+    }
+    const [b64] = accountInfo.data;
+    if (!b64) {
+      result.set(keys[i], null);
+      continue;
+    }
+    const binary = atob(b64);
+    const data = new Uint8Array(binary.length);
+    for (let j = 0; j < binary.length; j++) data[j] = binary.charCodeAt(j);
+    try {
+      result.set(keys[i], optionDecoder.decode(data));
+    } catch {
+      result.set(keys[i], null);
+    }
+  }
+  return result;
+}

package/index.ts

@@ -9,6 +9,7 @@ export * from "./accounts/list";
 export * from "./accounts/resolve-option";
 
 export * from "./shared/amounts";
+export * from "./shared/balances";
 export * from "./shared/errors";
 export * from "./shared/remaining-accounts";
 export * from "./shared/transactions";

package/long/exercise.ts

@@ -18,6 +18,10 @@ export interface BuildOptionExerciseParams {
   tokenProgram?: AddressLike;
 }
 
+/**
+ * Legacy escrow-based option exercise. Prefer pool flows: close_long_to_pool and auto_exercise_expired.
+ * @deprecated Use buildCloseLongToPoolTransaction for closing longs and rely on auto_exercise_expired for expiration.
+ */
 export function buildOptionExerciseInstruction(
   params: BuildOptionExerciseParams
 ): Instruction<string> {
@@ -38,8 +42,9 @@ export function buildOptionExerciseInstruction(
 }
 
 /**
- * Builds an option exercise transaction instruction set.
- * Use `priceUpdate` from a fresh Pyth receiver update for accurate exercise pricing.
+ * Builds an option exercise transaction (escrow/ask-based flow).
+ * Prefer pool-based flows: buildCloseLongToPoolTransaction for closing longs and auto_exercise_expired for expired ITM.
+ * @deprecated Use buildCloseLongToPoolTransaction and auto_exercise_expired; do not use for new flows.
  */
 export function buildOptionExerciseTransaction(
   params: BuildOptionExerciseParams

package/package.json

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

package/shared/balances.ts

@@ -0,0 +1,57 @@
+import type { Address } from "@solana/kit";
+import { deriveAssociatedTokenAddress } from "../accounts/pdas";
+import { toAddress } from "../client/program";
+import type { AddressLike, KitRpc } from "../client/types";
+import { NATIVE_MINT } from "../wsol/instructions";
+
+/** SPL Token account data: amount field offset (u64 LE). */
+const TOKEN_ACCOUNT_AMOUNT_OFFSET = 64;
+
+function decodeTokenAccountAmount(data: Uint8Array): bigint {
+  if (data.length < TOKEN_ACCOUNT_AMOUNT_OFFSET + 8) return BigInt(0);
+  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+  return view.getBigUint64(TOKEN_ACCOUNT_AMOUNT_OFFSET, true);
+}
+
+async function fetchTokenAccountBalance(rpc: KitRpc, ata: Address): Promise<bigint> {
+  const response = await rpc.getAccountInfo(ata, { encoding: "base64" }).send();
+  const accountInfo = response.value;
+  if (!accountInfo) return BigInt(0);
+  const [b64] = accountInfo.data;
+  if (!b64) return BigInt(0);
+  const binary = atob(b64);
+  const data = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) data[i] = binary.charCodeAt(i);
+  return decodeTokenAccountAmount(data);
+}
+
+/**
+ * Returns the SPL token balance for an owner and mint in base units (smallest units).
+ * Derives the associated token account; returns 0n if the ATA does not exist or has no data.
+ */
+export async function getTokenBalance(
+  owner: AddressLike,
+  mint: AddressLike,
+  rpc: KitRpc
+): Promise<bigint> {
+  const ata = await deriveAssociatedTokenAddress(owner, mint);
+  return fetchTokenAccountBalance(rpc, ata);
+}
+
+/**
+ * Returns native SOL balance (lamports), wrapped SOL (WSOL) balance (base units), and total (native + wrapped).
+ * Use for SOL pools when the UI should show combined "total SOL".
+ */
+export async function getCombinedSOLBalance(
+  owner: AddressLike,
+  rpc: KitRpc
+): Promise<{ native: bigint; wrapped: bigint; total: bigint }> {
+  const ownerAddress = toAddress(owner);
+  const [nativeResponse, wrappedBalance] = await Promise.all([
+    rpc.getBalance(ownerAddress).send(),
+    getTokenBalance(ownerAddress, NATIVE_MINT, rpc),
+  ]);
+  const native = nativeResponse.value;
+  const total = native + wrappedBalance;
+  return { native, wrapped: wrappedBalance, total };
+}