Key Concepts Explained

Your Personal Accounts

Think of a Bundie Account as a smart safe deposit box — and you get one on each chain you use.

What It Is

• A personal smart contract deployed on a supported chain (the AccountManager deploys it for you)
• One Account per chain — Arbitrum (the hub), Base, Optimism, Avalanche, and Scroll (legacy)
• Holds your idle funds and yield positions natively on that chain
• Only you control it (non-custodial)

What It Does

• Holds your idle assets: USDC waiting to be allocated
• Tracks your positions: yield earned natively on that chain, plus cross-chain positions it routes to
• 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 a single chain — you have an Account on each chain, with Arbitrum as the hub for cross-chain routing

Example You deposit 1,000 USDC into your Arbitrum Account, then allocate:

• 400 USDC → Morpho on Arbitrum (10% APY) — same chain, no bridge
• 300 USDC → Yearn on Optimism (9% APY) — bridged via LayerZero
• 300 USDC → stays idle in your Account (0% yield but available for quick moves)

Your Account tracks all three, even though some assets are working on another chain.

Account 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 Account
• 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 Account 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
• Morpho might offer 9% on Arbitrum

Without cross-chain:

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

With Bundie:

• Per-chain Accounts, with Arbitrum as the hub
• Automated bridging handled for you
• Unified dashboard for all positions

How Bridging Works

Step-by-step process:

1. You initiate: Click "Allocate" to a strategy on another chain (e.g. Yearn on Optimism)
2. Account sends: Your USDC leaves your Account on the source chain
3. LayerZero bridges: Message sent across chains (2-5 minutes)
4. Destination receives: USDC arrives on the destination chain
5. Protocol deposits: Funds deposited to the strategy
6. Receipt tokens issued: You receive ERC-4626 share tokens
7. Validator confirms: Your Account updated with the 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 Account 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 (stuck operations are refunded)
• 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 (L2 gas is cheap, often a few cents)
• Destination chain: Bundie sponsors
• Total cost: ~$0.55-$2.05 per cross-chain operation

Same-Chain Operations

If the strategy is on the same chain as your Account:

• No bridging needed
• Instant confirmation
• Lower fees (gas only)
• Position active immediately

Validator Role

A validator is an automated service that watches your cross-chain operations and confirms them on-chain once funds actually arrive. It's a notary, not a custodian:

• Confirms and refunds — marks deposits and withdrawals complete when they land, and flags failed or stuck operations so they can be refunded.
• Can't touch your funds — it holds no keys, so it can't move assets, withdraw on your behalf, or record a position you don't actually hold.
• Transparent — every validator action is recorded on-chain, so you can verify any confirmation yourself.

The worst case is a short delay in confirmation — never loss of funds.

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 Account
• 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 Account.

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 your Account
• 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 the source chain
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: Idle in your Account on a given chain

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:

Account 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 →