Overview
GweAI’s Vault allows you to lock cryptocurrency assets for fixed periods and earn guaranteed yields. The longer you lock, the higher the APY. All stakes are secured on-chain via the VaultStaking smart contract.Guaranteed APY
Fixed returns based on lock duration
Flexible Durations
Lock for 30, 60, 90, 180, or 365 days
Early Unlock Option
Withdraw early with proportional penalty
Real-Time Yield
Watch your earnings grow every second
Accessing the Vault
Stake Pools
Available Pools
Three primary staking pools:Bitcoin (BTC) Pool
Bitcoin (BTC) Pool
Base APY: 10.0%Lock Durations:
- 30 days: 7.0% APY (0.7× multiplier)
- 60 days: 8.5% APY (0.85× multiplier)
- 90 days: 10.0% APY (1.0× multiplier)
- 180 days: 11.5% APY (1.15× multiplier)
- 365 days: 13.0% APY (1.3× multiplier)
Solana (SOL) Pool
Solana (SOL) Pool
Base APY: 9.0%Lock Durations:
- 30 days: 6.3% APY
- 60 days: 7.65% APY
- 90 days: 9.0% APY
- 180 days: 10.35% APY
- 365 days: 11.7% APY
USDC Pool
USDC Pool
Base APY: 6.0%Lock Durations:
- 30 days: 4.2% APY
- 60 days: 5.1% APY
- 90 days: 6.0% APY
- 180 days: 6.9% APY
- 365 days: 7.8% APY
Pool Statistics
Each pool displays:- Total Staked: Combined amount from all users
- Total Staked USD: Dollar value at current prices
- Participants: Number of active stakers
- APY Range: Min to max based on duration
Staking Process
Enter Amount
Type the amount of tokens to lockBalance Check: Shows your available balanceExample:
5000 (for 5,000 USDC)Approve & Stake
Click Stake NowTransaction 1: Approve USDC spendingTransaction 2: Execute stakeBoth require wallet confirmation
Smart Contract Integration
VaultStaking Contract
All stakes are managed on-chain:Stake Approval Flow
Step 1: Token Approval
Step 1: Token Approval
First Transaction:Why? ERC-20 tokens require permission before contracts can transfer them.
Step 2: Stake Execution
Step 2: Stake Execution
Second Transaction:
Step 3: On-Chain Recording
Step 3: On-Chain Recording
Contract Creates Stake:This event is used to rebuild your stakes from blockchain.
Viewing Your Stakes
Locked Assets Tab
Shows all active stakes:
- Token & Amount: Logo, symbol, quantity
- USD Value: Current market value
- Lock Duration: Total days (e.g., “90 days”)
- APY: Effective annual percentage yield
- Unlock Date: When you can withdraw
- Countdown Timer: Days/hours/minutes remaining
- Current Yield: Real-time accrued earnings
- Total Yield: Final amount at unlock
- Progress Bar: Visual completion percentage
Real-Time Yield Calculation
Yields update every second:Unlocking Assets
Normal Unlock (After Lock Period)
Wait for Unlock Date
Monitor countdown timer on your stake cardWhen timer reaches 0, status changes to “Unlocked”
Contract Withdrawal
Early Unlock
When to Use Early Unlock
Sometimes you need access to locked funds before maturity:- Emergency expenses
- Better investment opportunities
- Market conditions change
Penalty Calculation
Early Unlock Process
Contract Early Withdrawal
Penalty is Yield Only: The penalty NEVER affects your principal. You always get back at least what you staked.
Transaction History
History Tab
Tracks all vault activity:
- STAKED: New stake created
- UNSTAKED: Normal unlock (full yield)
- EARLY UNLOCK: Early withdrawal (with penalty)
- Type Badge: Colored by action type
- Token & Amount: What was staked/unlocked
- Timestamp: When action occurred
- APY: Rate earned (for stakes)
- Penalty: Percentage lost (for early unlocks)
- Status: Completed/Failed
- Transaction Hash: Link to blockchain explorer
Persistent Storage
History is saved in localStorage per wallet:Stake Synchronization
Fetching from Blockchain
Your stakes are always fetched from the smart contract:Refresh from Contract
Click the “Refresh from Contract” button to sync:Source of Truth: The blockchain is always the authoritative source. LocalStorage is just a cache for faster initial load.
Vault Dashboard Stats
Real-Time Statistics
Top of the Vault page shows aggregated metrics:Total Locked
Combined USD value of all your stakes
Total Yield
Sum of current accrued earnings across all stakes
Active Vaults
Number of locked + unlocking stakes
Average APY
Weighted average APY across all vaults
Calculation Details
Best Practices
Choose Duration Wisely
Choose Duration Wisely
Longer = Higher APYBut only lock funds you won’t need:
- 30 days: Short-term savings
- 90 days: Medium-term goals
- 180-365 days: Long-term wealth building
Diversify Lock Periods
Diversify Lock Periods
Staggered Unlocks:Don’t lock everything for 365 days. Instead:
- 25% for 30 days
- 25% for 90 days
- 25% for 180 days
- 25% for 365 days
Monitor Yield Regularly
Monitor Yield Regularly
Check your vault weekly:
- Verify yield is accruing
- Plan for upcoming unlocks
- Decide whether to restake
Understand Early Unlock Costs
Understand Early Unlock Costs
Only use early unlock if:
- Emergency expense arises
- Better opportunity appears (rare)
- You’ve passed 75%+ of lock period (low penalty)
Reinvest Unlocked Funds
Reinvest Unlocked Funds
Compounding Strategy:When stakes unlock:
- Withdraw principal + yield
- Immediately restake the full amount
- Choose same or longer duration
Security & Safety
Smart Contract Audited
VaultStaking contract verified on BaseScan
Non-Custodial
You control your private keys at all times
On-Chain Guarantees
Yields are locked in smart contract code
No Rug Pull Risk
Contract cannot withdraw your funds
Contract Address
Troubleshooting
”Invalid Stake ID” Error
Cause: Stake not found on blockchain Solution:- Click Refresh from Contract
- Check transaction history to verify stake was created
- View stake on blockchain explorer
Yield Not Increasing
Cause: UI not updating (display issue only) Solution:- Refresh the page
- Click Refresh from Contract
- Yield calculation happens every second client-side
Early Unlock Not Working
Cause: Multiple possibilities Solutions:- Still Locked: Use early unlock, not normal unlock
- Already Unlocked: Use normal unlock instead
- Network Issue: Check Base Sepolia status
”Insufficient Balance” When Staking
Cause: Not enough tokens in wallet Solution:- Check balance in Portfolio
- Buy or deposit more tokens
- Reduce stake amount
FAQ
Can I add to an existing stake?
Can I add to an existing stake?
No. Each stake is independent. To add more:
- Create a new stake with additional funds
- Both stakes will run separately
What happens if I lose my wallet?
What happens if I lose my wallet?
Your funds are safe if you have your seed phrase.Stakes are tied to your address, not the wallet app. Simply:
- Restore wallet using seed phrase
- Reconnect to GweAI
- Your stakes reappear (fetched from blockchain)
Are yields taxable?
Are yields taxable?
Likely yes in most jurisdictions.Consult a tax professional. Generally:
- Staking rewards = taxable income
- Taxed at time of receipt (unlock)
- Keep records of transaction hashes
Can the APY change after I stake?
Can the APY change after I stake?
No. Your APY is locked in at stake time.The contract guarantees:
- APY rate at stake creation
- Total yield amount
- Unlock date
Next Steps
Portfolio
Monitor your staked assets’ value
Trading
Buy more tokens to stake
Swap
Convert tokens before staking
AI Chat
Ask about staking strategies