@epicentral/sos-sdk 0.9.0-beta

package/short/close-option.ts

@@ -0,0 +1,34 @@
+import { getCloseOptionInstruction } from "../generated/instructions";
+import type { Instruction } from "@solana/kit";
+import { toAddress } from "../client/program";
+import type { AddressLike, BuiltTransaction } from "../client/types";
+
+export interface BuildCloseOptionParams {
+  optionAccount: AddressLike;
+  optionMint: AddressLike;
+  makerOptionAccount: AddressLike;
+  maker: AddressLike;
+  tokenProgram?: AddressLike;
+}
+
+export function buildCloseOptionInstruction(
+  params: BuildCloseOptionParams
+): Instruction<string> {
+  return getCloseOptionInstruction({
+    optionAccount: toAddress(params.optionAccount),
+    optionMint: toAddress(params.optionMint),
+    makerOptionAccount: toAddress(params.makerOptionAccount),
+    maker: toAddress(params.maker) as any,
+    tokenProgram: params.tokenProgram ? toAddress(params.tokenProgram) : undefined,
+  });
+}
+
+/**
+ * Builds the close-option transaction instruction set for a maker.
+ */
+export function buildCloseOptionTransaction(
+  params: BuildCloseOptionParams
+): BuiltTransaction {
+  const instruction = buildCloseOptionInstruction(params);
+  return { instructions: [instruction] };
+}

package/short/pool.ts

@@ -0,0 +1,189 @@
+import {
+  getBorrowFromPoolInstructionAsync,
+  getRepayPoolLoanInstructionAsync,
+  getRepayPoolLoanFromCollateralInstructionAsync,
+  getRepayPoolLoanFromWalletInstructionAsync,
+} from "../generated/instructions";
+import type { Instruction } from "@solana/kit";
+import { toAddress } from "../client/program";
+import type { AddressLike, BuiltTransaction } from "../client/types";
+import { assertNonNegativeAmount, assertPositiveAmount } from "../shared/amounts";
+
+export interface BuildBorrowFromPoolParams {
+  vault: AddressLike;
+  vaultTokenAccount: AddressLike;
+  escrowTokenAccount: AddressLike;
+  collateralMint: AddressLike;
+  /** Option pool PDA for the market (links the writer position). */
+  optionPool: AddressLike;
+  /** Writer position PDA: `["writer_position", optionPool, maker]`. */
+  writerPosition: AddressLike;
+  maker: AddressLike;
+  nonce: bigint | number;
+  borrowAmount: bigint | number;
+  collateralAmount: bigint | number;
+  poolLoan?: AddressLike;
+  escrowState?: AddressLike;
+  escrowAuthority?: AddressLike;
+  tokenProgram?: AddressLike;
+  systemProgram?: AddressLike;
+}
+
+export interface BuildRepayPoolLoanParams {
+  poolLoan: AddressLike;
+  vault: AddressLike;
+  vaultTokenAccount: AddressLike;
+  escrowState: AddressLike;
+  escrowTokenAccount: AddressLike;
+  makerTokenAccount: AddressLike;
+  feeWalletTokenAccount: AddressLike;
+  optionPool: AddressLike;
+  writerPosition: AddressLike;
+  maker: AddressLike;
+  escrowAuthority?: AddressLike;
+  tokenProgram?: AddressLike;
+}
+
+export interface BuildRepayPoolLoanFromCollateralParams {
+  poolLoan: AddressLike;
+  vault: AddressLike;
+  vaultTokenAccount: AddressLike;
+  optionAccount: AddressLike;
+  optionPool: AddressLike;
+  collateralVault: AddressLike;
+  writerPosition: AddressLike;
+  feeWalletTokenAccount: AddressLike;
+  maker: AddressLike;
+  collateralPool?: AddressLike;
+  tokenProgram?: AddressLike;
+}
+
+export async function buildBorrowFromPoolInstruction(
+  params: BuildBorrowFromPoolParams
+): Promise<Instruction<string>> {
+  assertNonNegativeAmount(params.nonce, "nonce");
+  assertPositiveAmount(params.borrowAmount, "borrowAmount");
+  assertPositiveAmount(params.collateralAmount, "collateralAmount");
+
+  return getBorrowFromPoolInstructionAsync({
+    poolLoan: params.poolLoan ? toAddress(params.poolLoan) : undefined,
+    vault: toAddress(params.vault),
+    vaultTokenAccount: toAddress(params.vaultTokenAccount),
+    escrowState: params.escrowState ? toAddress(params.escrowState) : undefined,
+    escrowAuthority: params.escrowAuthority ? toAddress(params.escrowAuthority) : undefined,
+    escrowTokenAccount: toAddress(params.escrowTokenAccount),
+    collateralMint: toAddress(params.collateralMint),
+    optionPool: toAddress(params.optionPool),
+    writerPosition: toAddress(params.writerPosition),
+    maker: toAddress(params.maker) as any,
+    tokenProgram: params.tokenProgram ? toAddress(params.tokenProgram) : undefined,
+    systemProgram: params.systemProgram ? toAddress(params.systemProgram) : undefined,
+    nonce: params.nonce,
+    borrowAmount: params.borrowAmount,
+    collateralAmount: params.collateralAmount,
+  });
+}
+
+/**
+ * Builds the borrow transaction instruction set for pool leverage.
+ */
+export async function buildBorrowFromPoolTransaction(
+  params: BuildBorrowFromPoolParams
+): Promise<BuiltTransaction> {
+  const instruction = await buildBorrowFromPoolInstruction(params);
+  return { instructions: [instruction] };
+}
+
+export async function buildRepayPoolLoanInstruction(
+  params: BuildRepayPoolLoanParams
+): Promise<Instruction<string>> {
+  return getRepayPoolLoanInstructionAsync({
+    poolLoan: toAddress(params.poolLoan),
+    vault: toAddress(params.vault),
+    vaultTokenAccount: toAddress(params.vaultTokenAccount),
+    escrowState: toAddress(params.escrowState),
+    escrowAuthority: params.escrowAuthority
+      ? toAddress(params.escrowAuthority)
+      : undefined,
+    escrowTokenAccount: toAddress(params.escrowTokenAccount),
+    makerTokenAccount: toAddress(params.makerTokenAccount),
+    feeWalletTokenAccount: toAddress(params.feeWalletTokenAccount),
+    optionPool: toAddress(params.optionPool),
+    writerPosition: toAddress(params.writerPosition),
+    maker: toAddress(params.maker) as any,
+    tokenProgram: params.tokenProgram ? toAddress(params.tokenProgram) : undefined,
+  });
+}
+
+/**
+ * Builds the repay loan instruction set.
+ */
+export async function buildRepayPoolLoanTransaction(
+  params: BuildRepayPoolLoanParams
+): Promise<BuiltTransaction> {
+  const instruction = await buildRepayPoolLoanInstruction(params);
+  return { instructions: [instruction] };
+}
+
+/**
+ * Repay a pool loan entirely from maker's wallet (no escrow used).
+ * Use when standard repay fails with InsufficientEscrowBalance (stuck loan).
+ */
+export async function buildRepayPoolLoanFromWalletInstruction(
+  params: BuildRepayPoolLoanParams
+): Promise<Instruction<string>> {
+  return getRepayPoolLoanFromWalletInstructionAsync({
+    poolLoan: toAddress(params.poolLoan),
+    vault: toAddress(params.vault),
+    vaultTokenAccount: toAddress(params.vaultTokenAccount),
+    escrowState: toAddress(params.escrowState),
+    escrowAuthority: params.escrowAuthority
+      ? toAddress(params.escrowAuthority)
+      : undefined,
+    escrowTokenAccount: toAddress(params.escrowTokenAccount),
+    makerTokenAccount: toAddress(params.makerTokenAccount),
+    feeWalletTokenAccount: toAddress(params.feeWalletTokenAccount),
+    optionPool: toAddress(params.optionPool),
+    writerPosition: toAddress(params.writerPosition),
+    maker: toAddress(params.maker) as any,
+    tokenProgram: params.tokenProgram ? toAddress(params.tokenProgram) : undefined,
+  });
+}
+
+/**
+ * Builds the repay-from-wallet transaction (stuck loan recovery).
+ */
+export async function buildRepayPoolLoanFromWalletTransaction(
+  params: BuildRepayPoolLoanParams
+): Promise<BuiltTransaction> {
+  const instruction = await buildRepayPoolLoanFromWalletInstruction(params);
+  return { instructions: [instruction] };
+}
+
+export async function buildRepayPoolLoanFromCollateralInstruction(
+  params: BuildRepayPoolLoanFromCollateralParams
+): Promise<Instruction<string>> {
+  return getRepayPoolLoanFromCollateralInstructionAsync({
+    poolLoan: toAddress(params.poolLoan),
+    vault: toAddress(params.vault),
+    vaultTokenAccount: toAddress(params.vaultTokenAccount),
+    optionAccount: toAddress(params.optionAccount),
+    optionPool: toAddress(params.optionPool),
+    collateralPool: params.collateralPool ? toAddress(params.collateralPool) : undefined,
+    collateralVault: toAddress(params.collateralVault),
+    writerPosition: toAddress(params.writerPosition),
+    feeWalletTokenAccount: toAddress(params.feeWalletTokenAccount),
+    maker: toAddress(params.maker) as any,
+    tokenProgram: params.tokenProgram ? toAddress(params.tokenProgram) : undefined,
+  });
+}
+
+/**
+ * Builds the repay-from-collateral instruction set.
+ */
+export async function buildRepayPoolLoanFromCollateralTransaction(
+  params: BuildRepayPoolLoanFromCollateralParams
+): Promise<BuiltTransaction> {
+  const instruction = await buildRepayPoolLoanFromCollateralInstruction(params);
+  return { instructions: [instruction] };
+}