Skip to content

feat: add community staking template with Anchor and Next.js frontend#325

Open
satyawaniaman wants to merge 8 commits intosolana-foundation:mainfrom
satyawaniaman:satyawaniaman/staking-template
Open

feat: add community staking template with Anchor and Next.js frontend#325
satyawaniaman wants to merge 8 commits intosolana-foundation:mainfrom
satyawaniaman:satyawaniaman/staking-template

Conversation

@satyawaniaman
Copy link
Copy Markdown

@satyawaniaman satyawaniaman commented Mar 6, 2026

Demo

staking-walkthrough.mp4

Summary

Adds a new community/staking template for pnpm create solana-dapp --template staking.

This template provides a complete reference implementation of a Solana staking dApp including:

  • an Anchor staking program with initialize, stake, unstake, claim, and add_rewards
  • a Next.js + Tailwind + TypeScript frontend for staking, unstaking, claiming rewards, and viewing pool/user statistics
  • synced frontend IDL/types generated from the Anchor program
  • helper scripts for common setup tasks:
    • program ID synchronization
    • staking pool initialization
    • reward pool funding
  • README documentation covering architecture, deployment steps, reward calculation logic, security considerations, and troubleshooting

Validation

I verified the template locally with:

cd community/staking
anchor test
pnpm lint

cd app
pnpm lint
pnpm build

All checks completed successfully.

Manual Devnet Verification

I also validated the full workflow on devnet:

  • deploy program to devnet
  • create mint
  • initialize staking pool
  • fund reward pool
  • connect wallet in frontend
  • mint test tokens
  • stake tokens
  • claim rewards
  • unstake tokens

Notes

  • The frontend defaults to devnet via app/.env.local
  • sync-program-id.js keeps the program ID aligned across Rust, Anchor config, and frontend types/env
  • initialize-pool.js creates the staking PDAs
  • add-rewards.js funds the reward pool and sets the emission rate

@satyawaniaman
feat: add SPL token staking community template
8569783 
Anchor program with 5 instructions (initialize, stake, unstake, claim, add_rewards)
and a Next.js frontend with wallet integration, token faucet, and clean black/white UI.

- Program: SPL token staking with PDAs, reward distribution, admin controls
- Frontend: Next.js 16 + Tailwind 4 with Stake/Manage tabs
- Tests: 4 passing anchor tests (initialize, stake, unstake, error handling)
- Scripts: Pool initialization and token minting utilities
@satyawaniaman
style: polish UI with oklch dark theme matching templates convention
f24c274 
- oklch-based color tokens (matching supabase-auth convention)
- bg-card/50 navbar with proper hover transitions
- Link component for navigation
- Cleaner wallet adapter overrides
- Consistent border-border, outline-ring/50 base styles
@satyawaniaman
feat: add light/dark theme toggle with next-themes
a48a9dd 
- Light + dark oklch color schemes (matching supabase-auth convention)
- ThemeProvider wrapping app with dark default, system detection
- Sun/Moon toggle button in navbar
- Wallet adapter overrides use CSS vars for theme-awareness
@satyawaniaman
feat: Introduce a custom WalletConnectButton component, replacing `…
c1a2769 
…WalletMultiButton` and removing wallet adapter UI specific styles.
@satyawaniaman
feat(staking): harden staking template and register template entry
1be7110
@satyawaniaman
chore: revert unrelated template file changes
bef5153
@satyawaniaman
fix(staking): validate pool state and rename template path
21d1b7b
@satyawaniaman
feat(staking): sync devnet setup and reward funding flow
f43e9e4
@satyawaniaman
Copy link
Copy Markdown
Author

satyawaniaman commented Mar 7, 2026

@cxalem gentle ping for visibility, thanks.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 15, 2026

This pull request has been automatically marked as stale because it has not had any activity for 7 days.

It will be closed in 7 days if no further activity occurs.

If you believe this PR is still relevant, please add a comment or push new commits to keep it open.

Thank you for your contributions!

@github-actions github-actions bot added the stale label Mar 15, 2026
@satyawaniaman
Copy link
Copy Markdown
Author

satyawaniaman commented Mar 15, 2026

@cxalem Hi! just checking if there are any updates on this PR. Thanks!

@github-actions github-actions bot removed the stale label Mar 16, 2026
@satyawaniaman
Copy link
Copy Markdown
Author

satyawaniaman commented Mar 18, 2026

@catmcgee @cxalem @GuiBibeau @jacobcreech
Just checking in, it’s been about two weeks. Could you share any updates when you get a chance? Thanks!

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 26, 2026

This pull request has been automatically marked as stale because it has not had any activity for 7 days.

It will be closed in 7 days if no further activity occurs.

If you believe this PR is still relevant, please add a comment or push new commits to keep it open.

Thank you for your contributions!

@github-actions github-actions bot added the stale label Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@GuiBibeau GuiBibeau Awaiting requested review from GuiBibeau GuiBibeau is a code owner

@jacobcreech jacobcreech Awaiting requested review from jacobcreech jacobcreech is a code owner

@catmcgee catmcgee Awaiting requested review from catmcgee catmcgee is a code owner

@cxalem cxalem Awaiting requested review from cxalem cxalem is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

stale

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@satyawaniaman