Skip to main content
The YtPosition class represents a user’s yield position for a specific vault. It tracks deposited YT balance, accrued interest, and emission rewards.

​
Loading a Position

​
By address

import { YtPosition, Vault, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const vault = await Vault.load(LOCAL_ENV, connection, vaultAddress);

// vault is optional — if omitted, it will be auto-loaded from the position's vault address
const ytPosition = await YtPosition.load(LOCAL_ENV, connection, positionAddress, vault);

​
By owner

const ytPosition = await YtPosition.loadByOwner(
  LOCAL_ENV,
  connection,
  wallet.publicKey,
  vault,
);

​
Multiple positions for one owner

// Accepts PublicKey[] or (Vault | PublicKey)[] — passing loaded Vault instances avoids redundant RPC fetches
const vaultAddresses = [vaultAddress1, vaultAddress2, vaultAddress3];

const positions = await YtPosition.loadAllByOwner(
  LOCAL_ENV,
  connection,
  wallet.publicKey,
  vaultAddresses,
);

​
Reading Position State

console.log("YT balance:", ytPosition.ytBalance);
console.log("Owner:", ytPosition.owner.toBase58());
console.log("Staged interest:", ytPosition.stagedInterest);

​
Available Properties

PropertyTypeDescription
ytBalancebigintAmount of YT deposited in the position
ownerPublicKeyOwner of the yield position
stagedInterestbigintInterest that has been staged for collection
selfAddressPublicKeyThe yield position PDA address
vaultVaultThe associated vault instance

​
Refreshing State

await ytPosition.reload(connection);

​
Serialization

const json = ytPosition.toJson();
Returns a YtPositionJson object with:
  • owner — Owner public key as string
  • ytBalance — YT balance as string
  • interest — Interest tracker with lastSeenIndex and staged
  • claimableInterest — Calculated claimable interest amount
  • emissions — Array of emission trackers
  • vault — Serialized vault state