Account Structure

Fund instructions list the main config account under the Anchor/IDL name fundState (camelCase of Rust fund_state). The serialized account types are still named FundState, BasisFundState, and DefenseFundState, so generated clients typically expose program.account.fundState, program.account.basisFundState, and program.account.defenseFundState for .fetch(...).

Keystone Core

Account	Seeds	Purpose
PortfolioState	["core_portfolio", portfolio_id]	Per-portfolio config, fund links, and ksCORE supply
CoreAuthority	["core_authority", portfolio_id]	PDA that signs fund CPI calls
CoreShareMint	["core_share_mint", portfolio_id]	ksCORE token mint
CoreUserPosition	["core_user_position", portfolio_id, user]	Per-user ksCORE balance and deposit tracking
CoreUserRegistry	["core_user_registry", user]	Single-portfolio enforcement — records active portfolio per wallet

Keystone Alpha Fund

Account	Seeds	Purpose
FundState	["fund", fund_id]	Main config and state
FundAuthority	["fund_authority", fund_id]	PDA that signs token operations
ShareMint	["share_mint", fund_id]	Share token mint
UserPosition	["user_position", fund_id, user]	Per-user deposit/withdrawal tracking
CoreGate	["core_gate", fund_state]	Access control PDA — when enabled, only the stored core_authority pubkey may deposit/withdraw. Set via set_core_gate(fund_id, core_authority, enabled).

Keystone Neutral Fund

Account	Seeds	Purpose
BasisFundState	["basis_fund", fund_id]	Main config and state
FundAuthority	["fund_authority", fund_id]	PDA that signs token operations
ShareMint	["share_mint", fund_id]	Share token mint
UserPosition	["user_position", fund_id, user]	Per-user deposit/withdrawal tracking
PendingWithdrawal	["pending_withdrawal", fund_id, user]	Created on queued withdrawal; closed (rent returned) on claim_withdrawal
CoreGate	["core_gate", fund_state]	Access control PDA — when enabled, only the stored core_authority pubkey may deposit/withdraw. Set via set_core_gate(fund_id, core_authority, enabled).

Keystone Defense Fund

Account	Seeds	Purpose
DefenseFundState	["defense_fund", fund_id]	Main config and state
FundAuthority	["fund_authority", fund_id]	PDA that signs token operations
ShareMint	["share_mint", fund_id]	Share token mint
UserPosition	["user_position", fund_id, user]	Per-user deposit/withdrawal tracking
CoreGate	["core_gate", fund_state]	Access control PDA — when enabled, only the stored core_authority pubkey may deposit/withdraw. Set via set_core_gate(fund_id, core_authority, enabled).

Derivation

Keystone Alpha Fund

const fundId = new BN(3); // deployed fund ID

const [fundState] = PublicKey.findProgramAddressSync(
  [Buffer.from("fund"), fundId.toArrayLike(Buffer, "le", 8)],
  programId
);

const [fundAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("fund_authority"), fundId.toArrayLike(Buffer, "le", 8)],
  programId
);

const [userPosition] = PublicKey.findProgramAddressSync(
  [Buffer.from("user_position"), fundId.toArrayLike(Buffer, "le", 8), user.toBuffer()],
  programId
);

Keystone Neutral Fund

const fundId = new BN(2); // deployed fund ID

const [neutralFundState] = PublicKey.findProgramAddressSync(
  [Buffer.from("basis_fund"), fundId.toArrayLike(Buffer, "le", 8)],
  neutralProgramId
);

const [neutralFundAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("fund_authority"), fundId.toArrayLike(Buffer, "le", 8)],
  neutralProgramId
);

const [userPosition] = PublicKey.findProgramAddressSync(
  [Buffer.from("user_position"), fundId.toArrayLike(Buffer, "le", 8), user.toBuffer()],
  neutralProgramId
);

const [pendingWithdrawal] = PublicKey.findProgramAddressSync(
  [Buffer.from("pending_withdrawal"), fundId.toArrayLike(Buffer, "le", 8), user.toBuffer()],
  neutralProgramId
);

const [coreGate] = PublicKey.findProgramAddressSync(
  [Buffer.from("core_gate"), neutralFundState.toBuffer()],
  neutralProgramId
);

Keystone Defense Fund

const fundId = new BN(3); // deployed fund ID

const [fundState] = PublicKey.findProgramAddressSync(
  [Buffer.from("defense_fund"), fundId.toArrayLike(Buffer, "le", 8)],
  defenseProgramId
);

const [fundAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("fund_authority"), fundId.toArrayLike(Buffer, "le", 8)],
  defenseProgramId
);

const [userPosition] = PublicKey.findProgramAddressSync(
  [Buffer.from("user_position"), fundId.toArrayLike(Buffer, "le", 8), user.toBuffer()],
  defenseProgramId
);

const [coreGate] = PublicKey.findProgramAddressSync(
  [Buffer.from("core_gate"), fundState.toBuffer()],
  defenseProgramId
);

Keystone Core

const portfolioId = new BN(1); // 1=Conservative, 2=Balanced, 3=Growth

const [portfolioState] = PublicKey.findProgramAddressSync(
  [Buffer.from("core_portfolio"), portfolioId.toArrayLike(Buffer, "le", 8)],
  coreProgramId
);

const [coreAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("core_authority"), portfolioId.toArrayLike(Buffer, "le", 8)],
  coreProgramId
);

const [userRegistry] = PublicKey.findProgramAddressSync(
  [Buffer.from("core_user_registry"), user.toBuffer()],
  coreProgramId
);