Check Position & NAV

Query your position, fund value, and current share price.

---

Your Position

// Share balance
const userSharesAta = await getAssociatedTokenAddress(shareMint, wallet.publicKey);
const shareBalance = await connection.getTokenAccountBalance(userSharesAta);
console.log("Your shares:", shareBalance.value.uiAmount);

// Position history
const [userPosition] = PublicKey.findProgramAddressSync(
  [Buffer.from("user_position"), fundId.toArrayLike(Buffer, "le", 8), wallet.publicKey.toBuffer()],
  program.programId
);
const position = await program.account.userPosition.fetch(userPosition);
console.log("Total deposited:", position.totalDepositedUsdc.toNumber() / 1e6, "USDC");
console.log("Total withdrawn:", position.totalWithdrawnUsdc.toNumber() / 1e6, "USDC");

---

Fund NAV

Examples below deserialize fund state with the Anchor-generated namespaces for each account struct (FundState → fundState, BasisFundState → basisFundState, DefenseFundState → defenseFundState). When you invoke instructions, pass the same PDA under the IDL key fundState.

Keystone Alpha Fund

NAV = USDC balance + (jitoSOL * SOL price) + USDC in lending

const fund = await program.account.fundState.fetch(fundPda);
const usdcBal = await connection.getTokenAccountBalance(fund.fundUsdc);
const solBal = await connection.getTokenAccountBalance(fund.fundJitosol);
const solPrice = await getPythPrice(SOL_FEED_ID);

const nav = usdcBal.value.uiAmount
  + (solBal.value.uiAmount * solPrice)
  + (fund.usdcDepositedLending.toNumber() / 1e6);

Keystone Neutral Fund

NAV depends on the active state:

Standard basis (long jitoSOL / short SOL-PERP):

NAV = idle USDC + (jitoSOL deposited × SOL price) + funding earned

Reverse basis (long SOL-PERP / short jitoSOL via Kamino borrow):

NAV = USDC collateral (from jitoSOL borrow) + funding earned

Idle (no position open):

NAV = idle USDC

const fund = await program.account.basisFundState.fetch(fundPda);
const usdcBal = await connection.getTokenAccountBalance(fund.fundUsdc);
const solPrice = await getPythPrice(SOL_FEED_ID);

let nav: number;
if (fund.reversePositionOpen) {
  // Reverse basis: USDC collateral posted to Kamino + funding earned
  nav = (fund.usdcCollateralPosted.toNumber() / 1e6)
    + (fund.totalFundingEarned.toNumber() / 1e6);
} else {
  // Standard basis or idle
  nav = usdcBal.value.uiAmount
    + ((fund.jitosolDeposited.toNumber() / 1e9) * solPrice)
    + (fund.totalFundingEarned.toNumber() / 1e6);
}

---

Share Price

Alpha Fund (fundState):

const fund = await alphaProgram.account.fundState.fetch(fundPda);

// Cached (may be slightly stale)
const cached = fund.sharePriceScaled.toNumber() / 1e9;

// Live
const nav = await calculateNAV(fund);
const totalShares = fund.totalShares.toNumber() / 1e9;
const live = nav / totalShares;

Neutral / Defense: use neutralProgram.account.basisFundState or defenseProgram.account.defenseFundState and the same sharePriceScaled / totalShares pattern where those fields exist on your IDL version.

---

Profit / Loss

const position = await program.account.userPosition.fetch(userPosition);
const netContribution = (position.totalDepositedUsdc.toNumber() - position.totalWithdrawnUsdc.toNumber()) / 1e6;
const currentValue = myShares * sharePrice;
const pnl = currentValue - netContribution;

console.log(`P&L: ${pnl.toFixed(2)} USDC (${((pnl / netContribution) * 100).toFixed(2)}%)`);

---

Fund Stats

Use the program and decoder that match the fund (see Account Structure).

Keystone Alpha Fund

const v = await alphaProgram.account.fundState.fetch(fundPda);

console.log("Total Shares:", v.totalShares.toNumber() / 1e9);
console.log("Paused:", v.paused);
console.log("Deposit Cap:", v.depositCap.toNumber() / 1e6, "USDC");
console.log("SOL Allocation:", v.currentSolBps.toNumber() / 100, "%");
console.log("Volatility:", v.realizedVolBps, "bps");
console.log("Regime:", v.currentRegime);

Keystone Neutral Fund

const v = await neutralProgram.account.basisFundState.fetch(fundPda);

console.log("Total Shares:", v.totalShares.toNumber() / 1e9);
console.log("Paused:", v.paused);
console.log("Deposit Cap:", v.depositCap.toNumber() / 1e6, "USDC");

const state = v.reversePositionOpen
  ? "Reverse Basis"
  : v.positionOpen
  ? "Standard Basis"
  : "Idle";
console.log("State:", state);
console.log("Funding Earned:", v.totalFundingEarned.toNumber() / 1e6, "USDC");

if (v.sizeMultNormalBps && v.sizeMultNormalBps.toNumber() > 0) {
  console.log("Volatility:", v.realizedVolBps.toNumber(), "bps");
  console.log("Vol Regime:", v.currentVolRegime); // 0=Low, 1=Normal, 2=High, 3=Extreme
}

Keystone Defense Fund

const v = await defenseProgram.account.defenseFundState.fetch(fundPda);

console.log("Total Shares:", v.totalShares.toNumber() / 1e9);
console.log("Paused:", v.paused);
console.log("Deposit Cap:", v.depositCap.toNumber() / 1e6, "USDC");

---

CLI

npm run fund:info -- --fund alpha
npm run fund:position -- --wallet <WALLET>
npm run fund:apy