LOCALNET_QUICKSTART.md

🚀 Quick Start - Localnet Development

Get up and running with Boring Vault on localnet in under 2 minutes!

Prerequisites

• ✅ Node.js & Yarn installed
• ✅ Rust & Anchor CLI installed
• ✅ Solana CLI installed

One-Command Setup

./scripts/localnet-dev.sh

That's it! This single command will:

1. ✅ Start localnet validator
2. ✅ Build all programs
3. ✅ Deploy to localnet
4. ✅ Run tests

What You Get

After running the script, you'll have:

• 🟢 Local validator running on http://localhost:8899
• 💰 100 SOL in your wallet
• 📦 All 5 programs deployed:
  • boring_vault_svm
  • boring_onchain_queue
  • layer_zero_share_mover
  • endpoint (mock)
  • state_assert
• ✅ Programs initialized and ready to use
• 🧪 Tests passing (if all went well)

Next Steps

View Logs

solana logs

Deploy a Test Vault

yarn ts-node scripts/deploy.ts

Run Tests Manually

anchor test --skip-local-validator

Check Your Balance

solana balance

Stop When Done

./scripts/localnet-stop.sh

Daily Workflow

# Morning: Start fresh
./scripts/localnet-dev.sh

# During development: Quick redeploy
./scripts/localnet-deploy.sh

# Evening: Clean up
./scripts/localnet-stop.sh

Troubleshooting

Validator won't start?

pkill -9 solana-test-validator
./scripts/localnet-start.sh

Build fails?

anchor clean
anchor build

Need more details?

• See scripts/README.md for full documentation
• Run any script with --help flag

---

Happy coding! 🎉