Key Concepts Explained

Your Personal Vault

Think of your vault as a smart safe deposit box:

What It Is

• A smart contract deployed on Scroll blockchain
• Your personal "home base" for all DeFi activities
• Tracks all your positions across multiple chains
• Only you have the key (non-custodial)

What It Does

• Holds your idle assets: USDC waiting to be allocated
• Tracks your positions: Monitors investments on other chains
• Executes transactions: Handles deposits, withdrawals, and bridging
• Collects yield: Accumulates earnings from your strategies

What It's NOT

• Not a new wallet (your wallet is for signing in)
• Not custodial (Bundie cannot access your funds)
• Not on every chain (only on Scroll, but tracks positions everywhere)

Example You deposit 1,000 USDC to your vault on Scroll, then allocate:

• 400 USDC → Morpho on Base (10% APY)
• 300 USDC → Yearn on Optimism (9% APY)
• 300 USDC → Stays in vault (0% yield but available for quick moves)

Your vault on Scroll tracks all three positions, even though the assets are working on different chains.

Vault vs Wallet

Receipt Tokens (Shares)

When you deposit to a yield strategy, you receive receipt tokens that represent your share of the pool.

What Are They?

• Represent your share of the yield pool
• Increase in value as yield accrues
• Automatically tracked in your vault
• Can be withdrawn anytime (subject to strategy liquidity)

When you deposit:

1. You send 1,000 USDC to Morpho
2. You receive ~950 mUSDC receipt tokens
3. These tokens represent your share of Morpho's USDC vault

As yield accrues:

1. The value of each mUSDC token increases
2. After 1 month: Your 950 mUSDC might be worth 1,008 USDC
3. You earned 8 USDC (0.8% monthly return)

When you withdraw:

1. You return your 950 mUSDC tokens
2. You receive 1,008 USDC back
3. The receipt tokens are burned (destroyed)

Why Receipt Tokens?

Proof of ownership:

• Receipt tokens prove you have funds in the protocol
• Like a claim ticket for your deposit

Automatic yield tracking:

• Token value increases as yield accrues
• No need for manual calculations

Transferable:

• You could theoretically sell receipt tokens (though we don't recommend it)
• Enables composability with other DeFi protocols

Important Notes

Exchange rate changes:

• 1 receipt token ≠ 1 USDC
• Exchange rate improves as yield accrues
• Check current rate before calculating value

Your vault tracks these automatically:

• You don't need to manually monitor receipt tokens
• Dashboard shows your position in USDC value
• Receipt tokens are abstracted away in the UI

Cross-Chain Bridging

Bundie uses LayerZero to move your assets between chains safely and efficiently.

Why Cross-Chain?

Best yields are spread across different networks:

• Yearn might offer 10% on Optimism
• Fluid might offer 12% on Base
• Ionic might offer 8% on Mode

Without cross-chain:

• You'd need wallets on every chain
• Manual bridging for each deposit
• Complex tracking across networks

With Bundie:

• One vault on Scroll tracks everything
• Automated bridging handled for you
• Unified dashboard for all positions

How Bridging Works

Step-by-step process:

1. You initiate: Click "Allocate" to Morpho on Arbitrum
2. Vault sends: Your USDC leaves your vault on Scroll
3. LayerZero bridges: Message sent across chains (2-5 minutes)
4. Destination receives: USDC arrives on Arbitrum
5. Protocol deposits: Funds deposited to Morpho
6. Receipt tokens issued: You receive mUSDC (ERC-4626 share tokens)
7. Validator confirms: Your vault updated with new position

What you see:

• "Processing" badge during bridge operation
• Estimated completion time (2-5 minutes)
• Real-time status updates
• LayerZero Scan link for tracking

Bridge Safety

Security measures:

• LayerZero is audited and battle-tested
• Used by 100+ protocols with billions in volume
• Each bridge operation verified before vault update
• Failed bridges trigger automatic refund

What could go wrong:

• Network congestion (delays, not losses)
• Slippage during volatile markets
• Destination protocol paused (refund triggered)

Protection mechanisms:

• Slippage protection (minimum output set)
• Timeout handling (refund after 24 hours)
• Validator monitoring (confirms completion)

Bridge Costs

LayerZero fees:

• Typically $0.50-$2.00 per bridge operation
• Paid in source chain gas token
• Covers relayer costs and destination gas

Gas fees:

• Source chain: You pay (Scroll is cheap ~$0.05)
• Destination chain: Bundie sponsors
• Total cost: ~$0.55-$2.05 per cross-chain operation

Same-Chain Operations

If strategy is on Scroll:

• No bridging needed
• Instant confirmation
• Lower fees (~$0.05 total)
• Position active immediately

Validator Role

Our validator is an automated service that monitors cross-chain operations and updates your vault.

What the Validator Does

Monitors bridges:

• Watches LayerZero for message delivery
• Confirms your deposits arrived at destination
• Detects failed or stuck operations

Updates your vault:

• Marks deposits as "Confirmed" when complete
• Updates your position balances
• Triggers refunds if operations fail

Runs continuously:

• Monitors bridges in real time
• Processes all pending operations
• Handles multiple users simultaneously

What the Validator CANNOT Do

Cannot access your funds:

• No private keys or withdrawal permissions
• Cannot move assets from your vault
• Cannot create positions without actual deposits

Cannot bypass security:

• Cannot override slippage protection
• Cannot modify your positions arbitrarily
• Cannot withdraw on your behalf

Cannot guarantee success:

• Dependent on external bridges and protocols
• Cannot force failed bridges to succeed
• Cannot prevent destination protocol issues

Why We Need a Validator

Problem without validator: You: "I deposited 1,000 USDC to Morpho" Vault: "I don't see it yet..." You: "But I sent it 5 minutes ago!" Vault: "How do I know it actually arrived?"

Solution with validator:

You: "I deposited 1,000 USDC to Morpho"
Vault: "Marked as 'Processing', waiting for confirmation"
[2-5 minutes later]
Validator: "Confirmed! 950 mUSDC received on Arbitrum"
Vault: "Position updated, you're earning yield now"

Validator Transparency

On-chain verification:

• Validator address is public in smart contracts
• All validator actions recorded on-chain
• You can verify confirmations independently

Trust model:

• Validator is a notary, not a custodian
• Worst case: Delays in confirmation (not loss of funds)
• Backup validators available if primary fails

Strategy Allocation vs Position

Understanding the difference between what you intend to do and what you actually own.

Strategy Allocation

Definition: Your decision to invest in a specific yield opportunity

Characteristics:

• Intent to invest
• Initiated by you clicking "Allocate"
• Shows as "Processing" during cross-chain operations
• Not yet earning yield

Example:

You click "Allocate 1,000 USDC to Yearn on Optimism"
Status: Allocation Pending
Funds: In transit via LayerZero
Yield: Not yet earning

Position

Definition: Actual holdings you own in a strategy (the receipt tokens)

Characteristics:

• Confirmed investment
• Shows as "Active" in your vault
• Currently earning yield
• Can be withdrawn anytime

Example:

After confirmation:
Position: 950 yUSDC in Yearn on Optimism
Status: Active
Current Value: 1,008 USDC
Yield Earned: 8 USDC

Why the Distinction Matters

During cross-chain operations:

• Allocation = "I want to invest here" (pending)
• Position = "I own shares here" (confirmed)
• Gap between them = bridge time (2-5 minutes)

For your dashboard:

• Allocations show in "Pending Operations"
• Positions show in "Active Investments"
• Total Value = Active Positions + Pending Allocations + Idle Assets

For yield calculation:

• Allocations earn 0% (not yet invested)
• Positions earn APY (actively invested)
• Start earning only after allocation becomes position

Slippage Protection

When bridging across chains, prices can shift between the time you submit and the time the bridge completes. Slippage protection sets a minimum acceptable output. If the actual output falls below it, the transaction reverts and your funds stay in your vault.

You set a tolerance (0.5% strict, 1% normal, 2-3% lenient). Slippage is not a fee, it's a safety threshold. See Security for how it's enforced on-chain.

Pending State

Understanding what "Processing" means and how long it takes.

What Causes Pending State?

Cross-chain deposits:

• Your funds are bridging to another chain
• Typical duration: 2-5 minutes
• Waiting for LayerZero message delivery

Cross-chain withdrawals:

• Your funds are bridging back to Scroll
• Typical duration: 2-5 minutes
• Waiting for receipt tokens to return

Validator confirmation:

• Bridge completed, waiting for validator to confirm
• Typical duration: under a minute

Pending State Timeline

For deposits:

0:00 - You click "Allocate"
0:10 - Transaction confirmed on Scroll
0:15 - LayerZero message sent
2:00 - Message delivered to destination chain
2:05 - Funds deposited to protocol
2:10 - Receipt tokens issued
2:30 - Validator confirms
2:30 - Position shows as "Active"

Total time: 3-5 minutes

What You See

In "Pending Operations" section:

• Destination strategy and chain
• Amount being deposited/withdrawn
• Estimated completion time
• Current status (Bridging → Confirming → Completed)
• LayerZero Scan link for tracking
• Message GUID (for support reference)

Status indicators:

• Processing: Bridge in progress
• Confirming: Bridge complete, waiting for validator
• Completed: Position active, earning yield
• Failed: Operation failed, refund triggered

When to Worry

Normal:

• Pending for 2-5 minutes (cross-chain)
• Pending briefly for validator confirmation

Slight delay:

• Pending for 5-10 minutes (network congestion)
• Check LayerZero Scan for message status

Potential issue:

• Pending for 15+ minutes (rare)
• Check message status, contact support if "FAILED"

Guaranteed refund:

• If stuck for 24+ hours, automatic refund triggers
• Your funds are never lost

Idle Assets vs Invested Assets

Understanding where your funds are and what they're doing.

Idle Assets

Location: In your vault on Scroll

Characteristics:

• Earning 0% yield
• Available for instant allocation
• Can be withdrawn to wallet immediately
• No cross-chain operations needed

Use cases:

• Staging area for new deposits
• Waiting to find good opportunities
• Quick rebalancing buffer
• Emergency liquidity

Example:

Vault Balance:
- 500 USDC (idle)
- 0.05 ETH (for gas)

Status: Ready to allocate
Yield: 0%
Availability: Instant

Invested Assets (Positions)

Location: In yield protocols on various chains

Characteristics:

• Earning APY
• Represented by receipt tokens
• Requires withdrawal to access
• Cross-chain operations may be needed

Use cases:

• Active yield generation
• Long-term holdings
• Diversified portfolio
• Compounding returns

Example:

Active Positions:
- 1,000 USDC in Morpho (Base) - 10% APY
- 750 USDC in Yearn (Optimism) - 9% APY
- 500 USDC in Fluid (Arbitrum) - 11% APY

Total Invested: 2,250 USDC
Average APY: 9.6%
Current Value: 2,268 USDC (18 USDC earned)

For a full breakdown of fees (management, bridge, gas, strategy), see How Bundie Makes Money.

Next Steps

Now that you understand the key concepts:

1. Security & Protection - How your funds are secured
2. Troubleshooting Guide - Common issues and solutions

Ready to start? Launch Bundie App →