KhipuVault Docs

Frequently Asked Questions

Comprehensive FAQ with 30+ questions covering getting started, products, security, yields, fees, and troubleshooting.

Frequently Asked Questions

Find answers to common questions about KhipuVault. Use the sections below to jump to your topic.

Table of Contents


Getting Started

What is KhipuVault?

KhipuVault is a decentralized Bitcoin savings platform built on the Mezo blockchain. It offers four innovative products:

  1. Individual Savings - Personal savings with yields
  2. Community Pools - Group savings with higher yields
  3. Rotating Pool (ROSCA) - Traditional rotating savings digitized
  4. Prize Pool - No-loss lottery with Bitcoin

All funds remain in your control (non-custodial) and can be withdrawn anytime.

Do I need crypto experience to use KhipuVault?

No! Our platform is designed for beginners. You'll need to:

  • Install MetaMask wallet (5 minutes)
  • Add Mezo network (1 click)
  • Get test MUSD from faucet (free)
  • Make your first deposit (2 clicks)

Follow our Getting Started Guide for step-by-step instructions.

Is KhipuVault free to use?

Yes, the platform is free. You only pay:

  • Gas fees for blockchain transactions (usually < $0.50)
  • 10% performance fee on yields earned (not on deposits)

No monthly fees, no hidden charges, no deposit/withdrawal fees.

What do I need to get started?

You need:

  1. Web browser (Chrome, Firefox, or Brave)
  2. MetaMask wallet (download here)
  3. Mezo testnet added to wallet
  4. Test MUSD from faucet

That's it! No ID, no email, no personal information required.

How long does it take to set up?

About 5-10 minutes total:

  • Install MetaMask: 3 minutes
  • Add Mezo network: 30 seconds
  • Get test MUSD: 2 minutes
  • First deposit: 1 minute

Quick start guide

Is this on Bitcoin mainnet?

Not yet. KhipuVault currently runs on Mezo testnet (test network).

  • Use test MUSD (no real value)
  • Perfect for learning and testing
  • Mainnet launch planned for Q2 2026

⚠️ Don't send real Bitcoin to testnet addresses


Products & Features

What's the difference between the four products?

ProductBest ForWithdrawalsYieldsGroup Size
Individual SavingsPersonal savingsAnytimeStandardJust you
Community PoolGroup savingsAnytimeHigher2-100 people
Rotating PoolCommunity ROSCAsAfter cycleNone*3-50 people
Prize PoolFun + savingsAnytimeVia prizesUnlimited

*Rotating pools earn yields collectively, distributed as lump sums

Can I use multiple products at once?

Yes! You can:

  • Save in Individual Savings
  • Join a Community Pool with friends
  • Participate in a ROSCA with family
  • Enter the Prize Pool for fun

Each product is independent. Mix and match as you like.

What is a Community Pool?

A Community Pool is shared savings where members pool funds together to earn higher yields through collective deposits.

How it works:

  1. Create a pool or join existing one
  2. Members deposit Bitcoin (MUSD)
  3. Pool earns yields together
  4. Each member keeps their share
  5. Withdraw anytime (your portion only)

Benefits:

  • Higher yields than individual savings
  • Save with friends/family/community
  • Transparent on blockchain
  • Still maintain custody

Learn more

What is a Rotating Pool (ROSCA)?

A Rotating Pool is a digital version of traditional "tandas", "pasanakus", or ROSCAs (Rotating Savings and Credit Associations).

How it works:

  1. 5-10 people commit to equal monthly deposits
  2. Each cycle, one member receives the full pot
  3. Rotates until everyone receives their turn
  4. Enforced by smart contracts

Example:

  • 10 members × $100/month = $1,000 pot
  • Month 1: Alice receives $1,000
  • Month 2: Bob receives $1,000
  • ... continues for 10 months

Learn more

What is the Prize Pool?

A Prize Pool is a no-loss lottery. Deposit Bitcoin, earn yields, and win prizes - without risking your principal.

How it works:

  1. Deposit MUSD into prize pool
  2. Pool generates yields collectively
  3. Weekly/monthly prize drawings
  4. Winners receive accumulated yields
  5. Withdraw principal anytime

Benefits:

  • Can't lose your deposit
  • Chance to win big prizes
  • Fun way to save
  • Withdraw anytime

Learn more

Can I create my own Community Pool?

Yes! Anyone can create a pool:

  1. Go to Community Pools
  2. Click "Create Pool"
  3. Set pool name and parameters
  4. Invite members (optional)
  5. Start saving together

You control:

  • Pool name and description
  • Minimum deposit amount
  • Member approval settings
  • Public or private

How do I join an existing pool?

Public Pools:

  1. Browse available pools
  2. Click "View Details"
  3. Click "Join Pool"
  4. Make your first deposit

Private Pools:

  1. Get invite link from pool creator
  2. Click the link
  3. Request to join
  4. Wait for approval
  5. Make your deposit

Yields & Earnings

How do yields work?

Yields come from deploying pooled Bitcoin into various DeFi strategies:

  • Mezo staking rewards
  • Bitcoin lending protocols
  • Liquidity provision
  • MEZ token incentives (future)

Your deposit earns yields automatically. Earnings are distributed weekly.

What are the typical yields?

Current yields (testnet):

  • Individual Savings: ~5-8% APY
  • Community Pools: ~8-12% APY
  • Rotating Pools: Varies (lump sum)
  • Prize Pools: Prizes from collective yields

⚠️ Yields are variable and depend on market conditions.

How are yields calculated?

Formula:

Your Yield = (Your Deposit / Total Pool) × Pool Earnings

Example:

  • You deposit: 1,000 MUSD
  • Total pool: 100,000 MUSD (you're 1%)
  • Pool earns: 500 MUSD this week
  • Your share: 500 × 1% = 5 MUSD

When are yields distributed?

Distribution Schedule:

ProductFrequencyMethod
Individual SavingsWeeklyAuto-compound
Community PoolWeeklyAuto-compound
Rotating PoolEnd of cycleLump sum
Prize PoolWeekly drawingPrize to winners

Can I compound my yields?

Yes, automatically!

Yields are added to your principal and earn yields too.

Example:

  • Week 1: Deposit 1,000 MUSD, earn 10 MUSD
  • Week 2: Now earning on 1,010 MUSD
  • Week 3: Now earning on 1,020.10 MUSD
  • Compounding effect grows over time

Are yields guaranteed?

No. Yields are variable and depend on:

  • DeFi protocol performance
  • Market conditions
  • Total pool deposits
  • Network activity

Past performance doesn't guarantee future results. Yields can go up or down.

What's the difference between APY and APR?

APR (Annual Percentage Rate)

  • Simple interest (no compounding)
  • Example: 10% APR = 10% per year

APY (Annual Percentage Yield)

  • Compound interest (reinvesting earnings)
  • Example: 10% APY = ~10.52% effective rate

KhipuVault displays APY because we auto-compound yields.

Can yields be negative?

In theory yes, but unlikely:

  • Smart contracts could lose funds (rare)
  • DeFi protocols could fail
  • We use conservative strategies to minimize risk

If yields are negative, we pause operations until resolved.


Fees & Costs

What fees does KhipuVault charge?

Platform Fees:

  • Deposits: Free
  • Withdrawals: Free
  • Yield earnings: 10% performance fee

Blockchain Fees:

  • Gas for transactions: ~$0.10-$1.00 (paid to network)

What is the 10% performance fee?

We take 10% of your yield earnings (not your principal).

Example:

  • You earn 100 MUSD in yields
  • Fee: 10 MUSD (10%)
  • You keep: 90 MUSD
  • Your principal: Never touched

This fee funds:

  • Development and maintenance
  • Security audits
  • Customer support
  • Platform improvements

Are there any hidden fees?

No hidden fees. You only pay:

  1. Gas fees (blockchain network, not us)
  2. 10% performance fee (only on yields earned)

That's it. No:

  • ❌ Deposit fees
  • ❌ Withdrawal fees
  • ❌ Monthly/annual fees
  • ❌ Inactivity fees
  • ❌ Early withdrawal penalties (except ROSCA)

How much are gas fees?

Typical Costs (Mezo Testnet):

ActionGas Cost
Deposit~$0.10
Withdraw~$0.15
Claim yields~$0.08
Join pool~$0.12

Actual costs vary based on network congestion.

Mainnet will be higher - plan for $1-5 per transaction.

Can I avoid gas fees?

No, gas fees are paid to the blockchain network (not KhipuVault). They're necessary to process transactions.

Ways to minimize:

  • Batch transactions (deposit once, not many times)
  • Time transactions (off-peak hours cheaper)
  • Wait for low gas prices

Are there fees to join a Community Pool?

No fees to join. You pay:

  • Gas fee to join pool (~$0.12)
  • Gas fee for first deposit (~$0.10)
  • 10% performance fee on earnings (later)

Do Rotating Pools have early withdrawal fees?

Yes. Rotating Pools require commitment:

  • Early withdrawal penalty: Lose your turn in rotation
  • Blacklist risk: May be excluded from future pools
  • Social pressure: Letting down your community

Only join if you can commit to the full cycle.


Security & Safety

Is my Bitcoin safe?

KhipuVault uses multiple security layers:

Non-custodial - You always control your keys ✅ Audited contracts - Multiple security reviews ✅ Battle-tested code - OpenZeppelin standards ✅ Multi-sig admin - No single point of failure (planned) ✅ Pausable contracts - Emergency stop if needed

Read our security documentation

Can I lose my Bitcoin?

Possible but unlikely:

Smart contract risks:

  • Undiscovered bugs (mitigated by audits)
  • Economic exploits (tested extensively)

User risks:

  • Lost private keys (backup your seed phrase!)
  • Phishing scams (verify URLs)
  • Compromised device (use hardware wallet)

Market risks:

  • Mezo blockchain issues (external dependency)
  • DeFi protocol failures (diversified strategies)

How are smart contracts secured?

We follow industry best practices:

  • Reentrancy guards on all functions
  • Access controls with role-based permissions
  • Pausable in emergencies (withdrawals always work)
  • Event logging for complete audit trail
  • Overflow protection (Solidity 0.8+)
  • Input validation on all parameters

Technical security details

Has KhipuVault been audited?

Yes:

  • Slither - Automated static analysis (Jan 2025)
  • Aderyn - Rust-based analyzer (Jan 2025)
  • 🔄 Manual audit - Professional audit (in progress)

All findings addressed. Reports published publicly.

View audit reports

What if KhipuVault gets hacked?

Our response plan:

  1. Pause contracts immediately (< 1 hour)
  2. Alert community via Discord/Twitter
  3. Assess damage and affected users
  4. Deploy fix or migrate to new contracts
  5. Publish post-mortem with full transparency

User protection:

  • Withdrawals remain enabled even when paused
  • You can always access your principal
  • We maintain emergency procedures

Emergency procedures

Do you have a bug bounty program?

Yes! We offer up to $10,000 for critical vulnerabilities.

Reward Tiers:

  • Critical: $5,000 - $10,000
  • High: $2,000 - $5,000
  • Medium: $500 - $2,000
  • Low: $100 - $500

Learn more about bug bounties

How do I protect myself from scams?

Always verify:

Official URL: https://khipuvault.comContract addresses: Check documentationSocial media: Blue checkmarks on Twitter

Never: ❌ Share your seed phrase with anyone ❌ Click links in unsolicited DMs ❌ Enter keys on unknown websites ❌ Trust "customer support" DMs

Security best practices


Wallet & Network

What wallets are supported?

Officially Supported:

  • MetaMask (browser extension & mobile)
  • Ledger (hardware wallet)
  • Trezor (hardware wallet)

Community Tested:

  • ⚠️ Rainbow Wallet (works but not officially supported)
  • ⚠️ Frame (works but not officially supported)
  • ⚠️ Rabby (works but not officially supported)

Not Supported:

  • ❌ Centralized exchange wallets (Coinbase, Binance, etc.)
  • ❌ Bitcoin-only wallets (Sparrow, Electrum, etc.)

How do I add Mezo network to MetaMask?

Automatic (recommended):

  1. Go to Add Mezo Network
  2. Click "Add to MetaMask"
  3. Approve in MetaMask
  4. Done!

Manual:

  1. Open MetaMask
  2. Click network dropdown
  3. Click "Add Network"
  4. Enter Mezo testnet details:
    • Network Name: Mezo Testnet
    • RPC URL: https://rpc.test.mezo.org
    • Chain ID: 31611
    • Currency: BTC
    • Explorer: https://explorer.test.mezo.org

What is MUSD?

MUSD is a test token that represents Bitcoin on Mezo testnet.

  • 🧪 For testing only (no real value)
  • 🆓 Free from faucet
  • 🔄 1:1 with testnet BTC
  • 🚀 Mainnet will use real BTC

Get MUSD: faucet.test.mezo.org

Can I use my Bitcoin wallet?

No, Bitcoin-only wallets (Sparrow, Electrum) won't work.

You need an EVM-compatible wallet (MetaMask, Ledger) because Mezo uses smart contracts.

Think of it as: Bitcoin security + Ethereum flexibility

Why can't I see my MUSD balance?

Add MUSD token to MetaMask:

  1. Open MetaMask
  2. Switch to Mezo Testnet
  3. Scroll down and click "Import tokens"
  4. Enter MUSD contract address: 0x118917a40FAF1CD7a13dB0Ef56C86De7973Ac503
  5. Click "Add Custom Token"
  6. Confirm

Now you'll see your MUSD balance.


Deposits & Withdrawals

How do I make a deposit?

Steps:

  1. Go to your chosen product (e.g., Individual Savings)
  2. Click "Deposit"
  3. Enter amount
  4. Click "Approve MUSD" (first time only)
  5. Confirm in MetaMask
  6. Click "Deposit"
  7. Confirm in MetaMask
  8. Done! See your deposit in dashboard

Takes ~30 seconds after confirmation.

What is the minimum deposit?

Minimums:

ProductMinimum Deposit
Individual Savings10 MUSD
Community PoolSet by pool creator (typically 10-100 MUSD)
Rotating PoolEqual for all members
Prize Pool1 MUSD

Is there a maximum deposit?

Current limits (testnet):

  • Individual Savings: 100,000 MUSD per user
  • Community Pool: 1,000,000 MUSD total pool
  • Rotating Pool: Set by pool creator
  • Prize Pool: Unlimited

Mainnet will have different limits for safety.

How long do deposits take?

Instant! (after blockchain confirmation)

  1. Approve transaction: 5-15 seconds
  2. Deposit transaction: 5-15 seconds
  3. Appears in dashboard: Immediately

Total time: ~30 seconds

Can I withdraw anytime?

Yes (with one exception):

✅ Individual Savings: Anytime, instantly ✅ Community Pool: Anytime, your portion only ✅ Prize Pool: Anytime, full amount ❌ Rotating Pool: Only after your cycle completes

No lock-up periods. Your Bitcoin, your choice.

How do I withdraw?

Steps:

  1. Go to your pool dashboard
  2. Click "Withdraw"
  3. Enter amount (or click "Max")
  4. Click "Withdraw"
  5. Confirm in MetaMask
  6. Funds arrive in 5-15 seconds

Are there withdrawal limits?

No limits:

  • Withdraw 1 MUSD or 100,000 MUSD
  • Withdraw once or 100 times
  • Withdraw 10% or 100%

You control your funds completely.

How long do withdrawals take?

Instant (after blockchain confirmation):

  • Transaction confirmation: 5-15 seconds
  • Funds in wallet: Immediately
  • No waiting periods

Exception: Rotating Pools must wait for their turn.

What happens if I try to withdraw from a Rotating Pool early?

Consequences:

  1. Forfeit your turn in the rotation
  2. Pay penalty fee (configurable by pool)
  3. Possibly blacklisted from future pools
  4. Let down community (social pressure)

Only withdraw early in genuine emergencies.


Technical Issues

Why is my transaction failing?

Common causes:

  1. Insufficient gas

    • Solution: Increase gas limit by 20%
  2. Insufficient MUSD balance

    • Solution: Check balance, reduce amount
  3. Not approved MUSD spending

    • Solution: Click "Approve" before "Deposit"
  4. Slippage too low (doesn't apply to KhipuVault)

  5. Contract paused

Full troubleshooting guide

My transaction is pending forever. What do I do?

Solutions:

Option 1: Speed Up

  1. Click pending transaction in MetaMask
  2. Click "Speed Up"
  3. Increase gas price by 10-20%
  4. Confirm

Option 2: Cancel

  1. Click pending transaction
  2. Click "Cancel"
  3. Submit cancellation (must pay gas)

Option 3: Wait

  • Transactions usually confirm within 5 minutes
  • If network is congested, may take longer

Why can't I connect my wallet?

Troubleshooting:

  1. Refresh the page
  2. Check MetaMask is unlocked
  3. Switch to Mezo Testnet
  4. Update MetaMask to latest version
  5. Try different browser (Chrome recommended)
  6. Disable other wallet extensions (conflicts)
  7. Clear cache and cookies

Still stuck? Ask in Discord #support

The website is slow or not loading

Quick fixes:

  1. Refresh the page (Cmd+R or Ctrl+R)
  2. Clear browser cache
  3. Try different browser
  4. Check your internet connection
  5. Try mobile data (to rule out WiFi issues)
  6. Check status page: status.khipuvault.com

If down for everyone, we're working on it!

I got an "Out of Gas" error

Cause: Transaction ran out of gas before completing.

Solution:

  1. Click "Edit" on gas settings in MetaMask
  2. Increase "Gas Limit" by 20-30%
  3. Keep "Gas Price" the same (unless you want faster)
  4. Retry transaction

Prevention: Use "Fast" gas setting for complex transactions.

My balance is showing incorrectly

Troubleshooting:

  1. Refresh the page (data might be cached)
  2. Check on block explorer (source of truth)
  3. Clear browser cache
  4. Disconnect and reconnect wallet

If explorer shows correct but UI doesn't: Wait 5 mins or contact support.


Account & Privacy

Do I need to create an account?

No account needed!

  • ✅ Just connect your wallet
  • ✅ No email, password, or personal info
  • ✅ No KYC or identity verification
  • ✅ Completely anonymous

Your wallet address is your "account".

What data does KhipuVault collect?

We collect:

  • ✅ Wallet address (public on blockchain)
  • ✅ Transaction history (public on blockchain)
  • ✅ Session data (temporary, for login)

We don't collect:

  • ❌ Name, email, phone
  • ❌ IP addresses (beyond temporary logs)
  • ❌ Browsing history
  • ❌ Personal information

Privacy Policy

Is my data private?

Blockchain data is PUBLIC:

  • All transactions visible to everyone
  • Wallet addresses are pseudonymous (not anonymous)
  • Can be linked to identity if you're not careful

Website data:

  • We don't track beyond necessary analytics
  • No third-party trackers
  • No selling data to advertisers

Can I use KhipuVault from any country?

Currently yes (testnet):

  • No geographic restrictions
  • No KYC requirements
  • Available worldwide

Mainnet may differ:

  • Legal compliance required
  • Possible country restrictions
  • Will announce policy before launch

How do I delete my account?

No account to delete!

Simply:

  1. Withdraw all funds
  2. Disconnect wallet
  3. Stop using the platform

Your on-chain history remains (blockchain is permanent), but you're no longer actively using KhipuVault.


Mezo Blockchain

What is Mezo?

Mezo is a Bitcoin layer 2 blockchain that:

  • 🔒 Inherits Bitcoin's security
  • ⚡ Enables smart contracts
  • 💰 Uses Bitcoin as native currency
  • 🌉 Bridges to Bitcoin mainnet

Think: Bitcoin security + Ethereum features

Learn more at mezo.org

Why use Mezo instead of Ethereum?

Bitcoin Alignment:

  • ✅ Uses BTC, not ETH
  • ✅ Bitcoin-native security
  • ✅ Serves Bitcoin community

Better for Savings:

  • ✅ Bitcoin is hardest money
  • ✅ Lower volatility than altcoins
  • ✅ Long-term store of value

How does Mezo secure Bitcoin?

Mezo uses Bitcoin as its trust layer:

  1. Checkpoints posted to Bitcoin blockchain
  2. Economic security backed by Bitcoin hashrate
  3. Finality when Bitcoin confirms checkpoints

Your Mezo transactions inherit Bitcoin's security.

What is the difference between Mezo testnet and mainnet?

FeatureTestnetMainnet
CurrencyTest MUSD (no value)Real BTC
PurposeTesting & learningReal savings
RiskZero (test tokens)Real money at risk
NetworkSometimes unstableProduction ready
FaucetFree tokensNo free money

Use testnet to learn, mainnet for real savings.

How do I get Mezo testnet tokens?

Get MUSD (free):

  1. Go to faucet.test.mezo.org
  2. Connect MetaMask
  3. Click "Request MUSD"
  4. Wait 30 seconds
  5. Check balance in MetaMask

Limits:

  • 1,000 MUSD per request
  • 1 request per hour
  • Multiple addresses allowed

Detailed guide

When is Mezo mainnet launching?

Mezo Mainnet Status:

  • Current: Testnet (active)
  • Mainnet: Expected Q2-Q3 2026

KhipuVault Mainnet:

  • Dependent on Mezo mainnet
  • Additional security audits required
  • Announcement 30+ days before launch

Follow @MezoNetwork for updates.


Still Have Questions?

Not covered here?

Try these resources:

  1. 🔍 Search this documentation (top-right search bar)
  2. 💬 Ask in Discord - discord.gg/khipuvault
  3. 📧 Email support - support@khipuvault.com
  4. 📖 Read guides - Getting Started

Want to add a question?

Help us improve this FAQ:


Last updated: February 2026 | Questions: 40+

Thank you for using KhipuVault! 🚀

On this page

Frequently Asked QuestionsTable of ContentsGetting StartedWhat is KhipuVault?Do I need crypto experience to use KhipuVault?Is KhipuVault free to use?What do I need to get started?How long does it take to set up?Is this on Bitcoin mainnet?Products & FeaturesWhat's the difference between the four products?Can I use multiple products at once?What is a Community Pool?What is a Rotating Pool (ROSCA)?What is the Prize Pool?Can I create my own Community Pool?How do I join an existing pool?Yields & EarningsHow do yields work?What are the typical yields?How are yields calculated?When are yields distributed?Can I compound my yields?Are yields guaranteed?What's the difference between APY and APR?Can yields be negative?Fees & CostsWhat fees does KhipuVault charge?What is the 10% performance fee?Are there any hidden fees?How much are gas fees?Can I avoid gas fees?Are there fees to join a Community Pool?Do Rotating Pools have early withdrawal fees?Security & SafetyIs my Bitcoin safe?Can I lose my Bitcoin?How are smart contracts secured?Has KhipuVault been audited?What if KhipuVault gets hacked?Do you have a bug bounty program?How do I protect myself from scams?Wallet & NetworkWhat wallets are supported?How do I add Mezo network to MetaMask?What is MUSD?Can I use my Bitcoin wallet?Why can't I see my MUSD balance?Deposits & WithdrawalsHow do I make a deposit?What is the minimum deposit?Is there a maximum deposit?How long do deposits take?Can I withdraw anytime?How do I withdraw?Are there withdrawal limits?How long do withdrawals take?What happens if I try to withdraw from a Rotating Pool early?Technical IssuesWhy is my transaction failing?My transaction is pending forever. What do I do?Why can't I connect my wallet?The website is slow or not loadingI got an "Out of Gas" errorMy balance is showing incorrectlyAccount & PrivacyDo I need to create an account?What data does KhipuVault collect?Is my data private?Can I use KhipuVault from any country?How do I delete my account?Mezo BlockchainWhat is Mezo?Why use Mezo instead of Ethereum?How does Mezo secure Bitcoin?What is the difference between Mezo testnet and mainnet?How do I get Mezo testnet tokens?When is Mezo mainnet launching?Still Have Questions?Not covered here?Want to add a question?