Devnet

Last updated: April 23, 2026 (v0.11.5)

Program IDs

Program	Address
Keystone Alpha Fund	2JTb5UiM6mAYDUmnSiTgZXTTEJAJs98YRDcKLU6AGeZN
Keystone Neutral Fund	BxKFa6GRKYgNKxRzJ4kXCHiDo2PodpNtKVWhJTZMtAXR
Keystone Defense Fund	FKtpFEd4B5jGRkgLf5AN2eZMikmkEJYf59XzR6YbTxPA
Keystone Core	rDd3hjjEdH2xJWH9RnQupX7ZTPxrzmBZhL76eS8dW8c

Architecture

Core is a router, not a vault. User USDC flows through Core in a single transaction — Core splits and routes it to the three sub-funds (Alpha, Neutral, Defense) according to each portfolio's target allocations. Core holds no assets between transactions.

Each Core portfolio has its own dedicated fund instances — one per program, per risk profile. fund_id == portfolio_id within each sub-program.

Portfolio	Risk Profile	Alpha fund_id	Neutral fund_id	Defense fund_id
1	Conservative	1	1	1
2	Balanced	2	2	2
3	Growth	3	3	3

CoreGate: All 9 fund instances are gated. Direct deposits and withdrawals to Alpha, Neutral, or Defense are blocked at the contract level — only the matching Core portfolio's core_authority PDA can call them. This is enforced at the sub-fund level, not Core, because Core is the authorized router for each fund.

Test Tokens

Token	Devnet Mint
Test USDC	3wtMD9NVz4QvmtGw3ZvYva1BvWQzRAavC1r1tBYJJXvc
wSOL (jitoSOL/JupSOL substitute)	So11111111111111111111111111111111111111112

wSOL stands in for jitoSOL (Alpha, Neutral) and JupSOL (Defense) on devnet. Test USDC has unlimited supply.

---

Build

export PATH="$HOME/.cargo/bin:$HOME/.local/share/solana/install/active_release/bin:$PATH"

# Alpha, Neutral, and Defense programs require --features devnet (skips Pyth oracle validation)
cargo-build-sbf --manifest-path programs/keystone-alpha/Cargo.toml -- --features devnet
cargo-build-sbf --manifest-path programs/keystone-neutral/Cargo.toml -- --features devnet
cargo-build-sbf --manifest-path programs/keystone-defense/Cargo.toml -- --features devnet

# Core does not need the devnet flag
cargo-build-sbf --manifest-path programs/keystone-core/Cargo.toml

Devnet builds add -- --features devnet to skip Pyth ownership validation and use a mock $100 SOL price. Do not add that flag for mainnet.

Deploy

RPC="https://solana-devnet.g.alchemy.com/v2/<key>"  # or https://api.devnet.solana.com
WALLET="$HOME/.config/solana/devnet.json"

solana program deploy target/deploy/keystone_alpha.so \
  --program-id target/deploy/keystone_alpha-keypair.json --keypair $WALLET --url $RPC
solana program deploy target/deploy/keystone_neutral.so \
  --program-id target/deploy/keystone_neutral-keypair.json --keypair $WALLET --url $RPC
solana program deploy target/deploy/keystone_defense.so \
  --program-id target/deploy/keystone_defense-keypair.json --keypair $WALLET --url $RPC
solana program deploy target/deploy/keystone_core.so \
  --program-id target/deploy/keystone_core-keypair.json --keypair $WALLET --url $RPC

Parallel deploys work fine; only one buffer is allocated per program.

---

Fresh Deploy (from Zero)

Run this sequence whenever you want to wipe state and start clean.

Step 1 — Close existing fund states

# Closes Alpha/Neutral/Defense fund_state PDAs for fund_ids 1, 2, 3
# Reclaims rent. Skips any fund_id that doesn't exist on-chain.
npx tsx scripts/devnet/close-funds.ts

# Or target specific programs / fund IDs:
PROGRAMS=alpha FUND_IDS=1 npx tsx scripts/devnet/close-funds.ts

Step 2 — Initialize everything

# Inits 9 sub-funds (Alpha 1/2/3, Neutral 1/2/3, Defense 1/2/3)
# Inits 3 Core portfolios + registers fund ATAs
# Sets all 9 CoreGates
npx tsx scripts/devnet/fresh-deploy.ts

Both scripts are idempotent — already-initialized accounts are skipped, already-closed accounts are skipped.

Step 3 — (Optional) Test deposit

# 100 USDC via Core, Balanced portfolio
npx tsx scripts/deposit.ts balanced 100

# Check state
npx tsx scripts/status.ts

---

Partial Operations

# Re-run only the CoreGates (e.g. after a program upgrade)
npx tsx scripts/devnet/set-core-gates.ts

# Close a single fund and re-init it
PROGRAMS=neutral FUND_IDS=2 npx tsx scripts/devnet/close-funds.ts
npx tsx scripts/devnet/fresh-deploy.ts

---

Notes

anchor build does not work on this repo — use cargo-build-sbf directly with rustup's cargo on PATH.

Compute Budget (Deposits): Core deposits fan out to three fund CPIs and require more than the default 200K compute units. deposit.ts adds a ComputeBudgetProgram.setComputeUnitLimit({ units: 600_000 }) instruction automatically.

IDL sync: After building, copy IDLs to the frontend: cp target/idl/keystone_*.json idl/

---

Explorer

• Keystone Alpha

• Keystone Neutral

• Keystone Defense

• Keystone Core

• Test USDC