Creating Your First Pool

Create your personal savings pool in under 5 minutes. This guide walks you through every step with detailed explanations.

Before You Start

Make sure you have:

• ✅ MetaMask installed and connected
• ✅ Mezo Testnet added to your wallet
• ✅ At least 10 MUSD in your wallet
• ✅ Small amount of BTC for gas (~0.0005 BTC)

Not ready? Complete these guides first:

• Connect Your Wallet
• Add Mezo Network
• Get MUSD

Pool Creation Process

Good names: "Bitcoin Savings 2026", "My First Pool", "Retirement Fund"
Bad names: "Pool", "123", "asdfsadf"

Pool Name: "House Down Payment"
Goal Amount: 50000 MUSD
Description: "Saving $50k for a house in Miami by June 2027"

Estimated Gas: ~0.0002 BTC (~$0.02 USD)

Contract Interaction
To: IndividualPool Contract (0xdfBE...0393)
Data: createPool(...)
Estimated Gas: 0.0002 BTC

Creating your pool...
Transaction submitted: 0x1234...abcd
Waiting for confirmation (usually 5-10 seconds)

🎉 Pool Created Successfully!

Your Pool Address: 0x7890...def1
Pool Name: House Down Payment
Goal: 50,000 MUSD
Status: Active

[View on Explorer] [Go to Dashboard]

What Just Happened?

Let's break down what occurred on-chain:

Smart Contract Deployment

// A new contract was deployed just for you:
IndividualPoolInstance deployed at: 0x7890...def1

Constructor called with:
- owner: YOUR_WALLET_ADDRESS
- name: "House Down Payment"
- goalAmount: 50000000000000000000000 (50k MUSD in wei)

Blockchain Event

event PoolCreated(
    address indexed owner,
    address indexed poolAddress,
    string name,
    uint256 goalAmount,
    uint256 timestamp
);

This event is permanent and can be queried anytime to prove you created this pool.

Storage Allocated

Your pool contract now stores:

• Owner address (you)
• Pool name ("House Down Payment")
• Goal amount (50,000 MUSD)
• Creation timestamp
• Initial balance (0 MUSD)

Next Steps After Creation

📊 My Pools

House Down Payment
Created: 2 minutes ago
Balance: 0 MUSD
Progress: 0% of 50,000 MUSD goal
Status: Active (ready for deposits)

[Deposit] [Settings]

Understanding Your Pool Contract

Your pool is now a live smart contract on Mezo blockchain. Here's what you can do with it:

Owner Privileges

As the owner, you can:

• ✅ Deposit MUSD anytime
• ✅ Withdraw funds anytime (principal + yields)
• ✅ Update pool metadata (name, goal, description)
• ✅ Emergency withdraw (if paused)
• ✅ View detailed analytics

No one else can:

• ❌ Deposit to your pool
• ❌ Withdraw your funds
• ❌ Modify your settings
• ❌ Access your balance

Verifying Your Pool

To verify your pool on-chain:

1. Go to Mezo Block Explorer
2. Paste your pool address: 0x7890...def1
3. You should see:
   • Contract creation transaction
   • Your wallet as deployer
   • Contract code (verified)
   • Zero transactions (until first deposit)

Reading Pool Data

You can query your pool directly:

// Using ethers.js
const pool = new ethers.Contract(poolAddress, poolABI, provider);

// Get pool info
const name = await pool.name(); // "House Down Payment"
const goal = await pool.goalAmount(); // 50000000000000000000000
const balance = await pool.balanceOf(yourAddress); // 0 (no deposits yet)
const owner = await pool.owner(); // YOUR_WALLET_ADDRESS

Developer docs →

Pool Creation Costs

Here's the full cost breakdown:

Multiple Pools

Can you create more pools? Absolutely!

Why Have Multiple Pools?

Users often create separate pools for:

• 🎯 Different goals (emergency fund, vacation, house)
• 📊 Different strategies (aggressive, conservative)
• 📅 Different timeframes (short-term, long-term)
• 🔒 Different risk profiles

Example Multi-Pool Strategy:

Pool 1: "Emergency Fund" (Goal: $10k, conservative)
Pool 2: "House Down Payment" (Goal: $50k, moderate)
Pool 3: "Retirement" (Goal: $100k, aggressive)

Creating Additional Pools

Same process:

1. Go to Individual Savings page
2. Click "Create New Pool" again
3. Fill in details for new pool
4. Each pool costs ~0.0002 BTC to create

Troubleshooting

Transaction Failed

Error: "Transaction failed"

Possible causes:

1. Insufficient BTC for gas → Get more from faucet
2. Wrong network → Switch to Mezo Testnet
3. Network congestion → Wait 5 minutes and retry
4. MetaMask nonce issue → Reset account (Settings → Advanced → Reset)

Pool Name Already Taken

Error: "Pool name already exists"

Solution: Pool names must be unique per user. Try:

• Adding a date: "My Pool 2026"
• Adding a number: "My Pool v2"
• Being more specific: "Emergency Fund - Q1"

MetaMask Not Popping Up

Issue: Clicked "Create Pool" but no MetaMask window

Solutions:

1. Check for MetaMask icon in browser extensions (click it manually)
2. Disable pop-up blockers for khipuvault.com
3. Refresh page and try again
4. Restart browser

Gas Estimate Shows "Error"

Issue: Can't estimate gas fee

Solutions:

1. Verify you're on Mezo Testnet (not Ethereum)
2. Check you have some BTC for gas
3. Try disconnecting and reconnecting wallet
4. Clear browser cache and reload

Pool Created But Not Showing

Issue: Transaction succeeded but pool not in dashboard

Solutions:

1. Refresh the page (may take 10-20 seconds to index)
2. Check transaction on Explorer
3. Verify you're connected with the same wallet that created it
4. Clear browser cache

Advanced Options

Setting a Custom Goal Strategy

Instead of a single goal, some users track multiple metrics:

Option A: Percentage-Based

• Goal: Grow balance by 20% each quarter
• Requires manual tracking (calculate externally)

Option B: Time-Based

• Goal: Save $500/month for 24 months = $12k total
• Set goal to 12,000 MUSD

Option C: Yield-Based

• Goal: Earn $1,000 in yields (not principal)
• Track yields separately in dashboard

Naming Conventions for Organization

If you plan to have many pools:

Format: [Category] - [Purpose] - [Timeline]

Examples:
- "Emergency - Medical - 2026"
- "Savings - House - 5yr"
- "Investment - Crypto - Longterm"

Benefits:

• Easy sorting
• Clear purpose
• Better tracking

Best Practices

What's Next?

You've successfully created your pool! Now it's time to fund it and start earning:

Pool created successfully? Share your success in Discord and help others!

Questions? Check the FAQ or ask the community.