Skip to content

Instantly share code, notes, and snippets.

@Aboudjem

Aboudjem/26-staking.md

Last active March 30, 2026 08:00
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Aboudjem/f623e1272a71db67a357b31dc63e9aab to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Aboudjem/f623e1272a71db67a357b31dc63e9aab to your computer and use it in GitHub Desktop.
Download ZIP
Integra PRD: 26-staking
Raw
26-staking.md

Staking dApp

Owner: Nawar | Ship: Week 1 | Est: 0.5-1 day | Chain: integra-testnet-1 (EVM 26218) URL: staking.integralayer.com

Overview

Staking interface for delegating IRL tokens to Integra validators and earning staking rewards. Uses native Cosmos SDK staking and distribution modules -- no custom contracts. Users browse validators, delegate, track accrued rewards, claim, redelegate, and undelegate. This is P0 infrastructure that every proof-of-stake chain ships on day one. Without it, users are stuck on CLI.

Features

  • Validator List — Sortable table of all active validators showing moniker, voting power %, commission rate, uptime, and status (active/jailed)
  • Delegate IRL — Select a validator and stake any amount of IRL tokens via a single transaction
  • Undelegate — Initiate unstaking with the unbonding period clearly displayed before confirmation
  • Redelegate — Move an existing delegation from one validator to another without unbonding
  • Claim Rewards — View pending staking rewards per validator and claim in one click
  • Staking Overview Dashboard — Network-wide stats: total IRL staked, bonding ratio, current APR, number of active validators
  • Personal Delegation Summary — User's total delegated amount, rewards pending, and per-validator breakdown
  • Transaction History — Recent stake/unstake/redelegate/claim actions with tx hashes and timestamps
  • APR Display — Real-time annual percentage rate based on current network inflation and bonding ratio
  • Web3Auth Login — Social account login via @integra/web3auth-provider, no wallet extension required
  • Unbonding Tracker — Shows in-progress unbonding delegations with time remaining until funds are released

Functions

  • MsgDelegate — Stake IRL to a selected validator
  • MsgUndelegate — Unstake IRL (starts unbonding period)
  • MsgBeginRedelegate — Move stake between validators without unbonding
  • MsgWithdrawDelegatorReward — Claim accumulated staking rewards
  • GET /cosmos/staking/v1beta1/validators — List all validators with commission, tokens, and status
  • GET /cosmos/staking/v1beta1/delegations/{delegator} — User's active delegations
  • GET /cosmos/distribution/v1beta1/delegators/{delegator}/rewards — Pending rewards breakdown
  • GET /cosmos/staking/v1beta1/delegators/{delegator}/unbonding_delegations — In-progress unbonding entries

User Flow

  1. User connects via Web3Auth (social login)
  2. Staking overview loads: total network staked, APR, user's delegation summary
  3. User browses the validator list sorted by voting power, commission, or uptime
  4. User selects a validator and enters an amount to delegate
  5. User confirms the delegation transaction
  6. User returns later to check accrued rewards
  7. User claims rewards in one click
  8. User can redelegate to a different validator or undelegate (with unbonding countdown)

Deliverables

  • Validator list page with sorting (voting power, commission, uptime, status)
  • Delegation form (select validator, enter amount, confirm tx)
  • Undelegation flow with unbonding period display
  • Redelegation flow (source validator to destination validator)
  • Rewards display and one-click claim
  • Staking overview dashboard (network stats + personal summary)
  • Transaction history with tx hash links to Explorer
  • Unbonding tracker with countdown timers
  • Web3Auth integration for social login

Integration Points

  • Depends on: Cosmos SDK staking module, Cosmos SDK distribution module, Integra testnet LCD/REST API, @integra/web3auth-provider
  • Used by: Ecosystem Hub (listed under DeFi category), Explorer (delegation txs visible)
  • Explorer: Integra Explorer (all staking txs indexed)
  • Note: 3 active validators on testnet (~33.3% voting power each), token is IRL / airl (18 decimals)

XP Rewards

Action Points
First delegation (stake any amount) +100 XP
Claim rewards +25 XP
Redelegate to a different validator +50 XP
Maintain active delegation for 7+ days +200 XP

Success Metrics

Metric Target
Unique delegators 500+
Total IRL staked via UI >50% of circulating supply
Average delegation txs per day 100+
Reward claims per week 200+
Users completing all 4 XP actions 100+
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment