← Home

Documentation

Technical and user documentation for VaultStake. This covers wallet integrations, staking mechanics, reward calculations, and protocol architecture.

Overview

VaultStake is a multi-asset staking platform supporting BTC, ETH, XRP, USDT and more. It enables users to:

  • Stake digital assets in flexible or locked pools
  • Earn variable daily staking rewards
  • Participate in reward campaigns and ecosystem distributions
  • Track portfolio performance in real-time

VaultStake uses a custodial model for deposit handling. Deposits are credited to your account after on-chain confirmation. Rewards accrue daily based on your staking position.

Architecture
VaultStake Platform Stack
─────────────────────────────
Layer 1:  Multi-chain deposit ingestion (XRP Ledger, Stellar, ERC-20, BEP-20)
Layer 2:  Custodial vault management
Layer 3:  Reward calculation engine
Layer 4:  Staking pool management
Layer 5:  VaultStake web application

Deposit Methods

Supported Networks

VaultStake accepts deposits from the following networks:

  • XRP Ledger: XRP and RLUSD
  • Stellar: XLM and USDC
  • Ethereum (ERC-20): ETH, USDT, USDC
  • BNB Chain (BEP-20): BNB, USDT
  • TRON (TRC-20): TRX, USDT

How Deposits Work

Send assets to the deposit address shown in your dashboard. After 1–3 network confirmations, submit your transaction hash for verification. Your balance is updated automatically after on-chain confirmation.

Deposit Flow
1. Navigate to Dashboard → Receive
2. Select your preferred network and asset
3. Copy the deposit address (and memo if required)
4. Send the assets from your external wallet
5. Wait for network confirmations
6. Paste the transaction hash in the deposit form
7. On-chain verification completes and balance is credited automatically

Staking Mechanics

VaultStake offers two types of staking pools: flexible and locked. All APY figures are variable estimates and not guaranteed returns.

Flexible Pools

Flexible pools allow withdrawal at any time. They offer lower APY than locked pools but provide full liquidity. Rewards accrue daily.

Locked Pools

Locked pools commit your assets for a fixed period (30, 90, or 180 days) in exchange for higher reward rates. Assets cannot be withdrawn early.

Reward Rate Formula (illustrative)
base_apy = pool_configuration_rate  // set per pool
multiplier = streak_bonus × loyalty_bonus × lock_bonus
estimated_daily_reward = (staked_amount_usd × base_apy × multiplier) / 365

Note: All rates are variable and subject to pool conditions.

Reward System

Protocol incentives are distributed from a protocol reward pool to eligible vault participants. The reward pool is replenished through protocol fee collection and ecosystem allocations.

Important Disclosure

Reward rates are variable and not guaranteed. Past rates do not predict future rates. Participating in vault programs involves risk including the possibility of reduced or zero protocol incentives during low-activity periods.

Claiming Rewards

Rewards accumulate in your protocol reward balance and can be claimed at any time. Claiming initiates an on-chain transaction that transfers the accumulated reward amount to your wallet.

  • Rewards accrue daily to your account balance
  • Claim rewards at any time from the Rewards dashboard
  • Minimum claim threshold may apply based on your account tier

Reward Campaigns

VaultStake runs periodic reward campaigns for active stakers. Campaign rewards are distributed directly to eligible user accounts.

Eligibility

Eligibility for each campaign is based on your staking activity at the campaign snapshot date. Criteria typically include:

  • Active staking position at snapshot time
  • Minimum staking duration
  • Daily streak requirements
  • Minimum staked USD value
Claiming a Campaign Reward
1. Navigate to Dashboard → Rewards
2. Check active campaigns and your eligibility score
3. Click "Claim" on eligible campaigns
4. Rewards are credited to your account balance instantly

Staking Governance

VaultStake governance allows active stakers to vote on platform proposals that affect:

  • Reward pool APY parameters
  • New asset and pool listings
  • Platform fee structures
  • Ecosystem partnership decisions
  • Reward campaign parameters

Governance Disclosure

Governance voting is advisory. Outcomes do not represent binding financial commitments. Staking rewards are variable and not guaranteed returns. Platform decisions may override governance votes in exceptional circumstances.

System Architecture

Non-Custodial Design

VaultStake is architected to never hold or access user private keys. The application follows a client-server separation:

  • Client side: Key derivation, transaction signing, seed phrase handling, session token storage
  • Server side: Public address indexing, reward calculation, airdrop eligibility verification, API endpoints
Data Flow
User Browser                  VaultStake Server           Blockchain
──────────────────────────────────────────────────────────────────────
[Deposit]    ─ tx_hash ──────────────────────────────→ [Credited]
[Stake]      ─ pool selection ──────────────────────→ [Staked]
[Claim]      ─ reward claim ─────────────────────────→ [Balance updated]
[Withdraw]   ─ withdrawal request ──────────────────→ [Processed]
                                               [Server calculates rewards]
                                               [Portfolio display]

Technology Stack

  • Frontend: Next.js 16, React 19, TypeScript, TailwindCSS v4
  • Authentication: NextAuth v5, TOTP (otplib)
  • Multi-chain: XRP Ledger, Stellar, EVM-compatible chains
  • Database: PostgreSQL with Prisma ORM

API Reference

VaultStake exposes a REST API for authenticated users. All API requests require a valid session token obtained through the authentication flow.

Base URL
https://vaultstake.com/api

Public Endpoints

GET /api/public/stats
// Returns protocol-wide statistics
{
  "activeVaults": 12400,
  "totalParticipants": 180000,
  "networksSupported": ["XRPL", "Stellar", "ERC20", "BEP20", "TRC20"],
  "protocolUptime": "99.97%"
}

Authenticated Endpoints

Authenticated endpoints require an Authorization header with your session token. These are primarily used by the VaultStake web application.

GET /api/user/rewards
Headers:
  Authorization: Bearer <session_token>

Response:
{
  "pendingRewards": {
    "total_usd": "14.82",
    "accrued_days": 3,
    "can_claim": true
  },
  "lastClaim": "2026-01-10T14:32:00Z",
  "rewardRate": "variable",
  "rateLastUpdated": "2026-01-14T00:00:00Z"
}

Guides