HomeUser Guide

User Guide

Everything you need to deposit, bridge, and earn yield with BridgeFlow.

Connect Your Wallet

1

Install MetaMask

Download MetaMask from metamask.io. Mobile and browser extension both work.
2

Click Connect Wallet

Press the Connect Wallet button in the top-right corner of the app. Select MetaMask from the list.
3

Approve the connection

MetaMask will pop up asking permission. Click Connect. Your address will appear in the nav bar.
4

Switch to Polygon

BridgeFlow runs on Polygon. If prompted, click Switch Network and approve the Polygon Mainnet (chain ID 137) addition in MetaMask.
You need a small amount of POL (Polygon's gas token) in your wallet to pay transaction fees. Get some from any exchange that supports Polygon withdrawals.

Deposit USDC

Direct deposits work if your USDC is already on Polygon. For USDC on other chains, use the bridge instead (next section).

1

Go to the Dashboard

Navigate to the main dashboard. Click the "Deposit" button.
2

Enter an amount

Type the amount of USDC you want to deposit. The current limits are shown below the input — $500 max per deposit during the launch period.
3

Approve USDC

The first time you deposit, MetaMask will ask you to approve BridgeFlow to spend your USDC. This is a standard ERC-20 approval — confirm it.
4

Confirm the deposit

Click Deposit and confirm the transaction in MetaMask. Once confirmed, you'll receive bfUSDC shares representing your position.
bfUSDC is your vault share token. It automatically appreciates in value as the vault earns yield — you don't need to do anything else.

Launch Limits

Max single deposit$500 USDC
Max single withdrawal$250 USDC
Max TVL$2,000 USDC
Performance fee5% on yield only

Cross-Chain Bridge (CCTP)

Have USDC on Ethereum, Arbitrum, Base, or Optimism? Bridge it directly into BridgeFlow using Circle's CCTP protocol. The process has three steps spread across two pages.

1

Burn on source chain — /burn

Connect MetaMask to your source chain (e.g. Ethereum). Go to the Burn page, enter your amount, and approve + confirm the burn transaction. Circle will destroy your USDC on this chain and issue an attestation.

2

Wait for attestation — /attest

The Attest page polls Circle's API and shows you a live status. You cannot skip this wait.

Ethereum13–19 min
Arbitrum~2 min
Base~2 min
Optimism~2 min
3

Claim & deposit — /bridge

Switch MetaMask to Polygon. Click Claim & Deposit. This mints your USDC on Polygon and deposits it into the vault atomically — one transaction.

Never close the Attest page mid-flow. If you do, return to it with the same wallet — your burn message hash is tracked automatically.

Withdraw

1

Open the Withdraw panel

On the dashboard, click the "Withdraw" tab next to the Deposit button.
2

Enter the amount

Enter how much USDC you want to withdraw. The vault will calculate the bfUSDC shares to burn. Max $250 USDC per transaction during launch.
3

Confirm

Click Withdraw and confirm in MetaMask. USDC arrives in your wallet within the same block. No lock-up period.
Withdrawals include your principal plus any yield earned. The vault keeps a 10% liquidity buffer on-hand at all times, so funds are available immediately.

AI Optimizer

You don't need to do anything — the optimizer runs automatically. Here's how it works:

Fetch Chainlink Functions runs a JS script off-chain every hour, pulling live APYs from Aave V3, Compound V3, and Spark.
Compare If any protocol offers ≥ 50bps (0.5%) more than the current one, a rebalance signal is generated.
Rebalance The vault automatically moves all funds to the highest-yield protocol. Slippage limits protect against bad conditions.
Harvest Yield is harvested periodically. A 5% performance fee is taken on profit only — never on your principal.
The AI Optimizer card on your dashboard shows the current protocol, live APY, and last rebalance time. If it shows "Waiting for Chainlink…" on first load, it's requesting its first signal — this can take up to 60 seconds.

Security

Non-custodial

BridgeFlow never holds your funds. Assets go directly into audited DeFi protocols.

No lock-up

Withdraw at any time. There is no vesting period or exit penalty.

24h timelock

Any adapter change requires a 24-hour waiting period before it can take effect.

Circuit breaker

If an anomaly is detected, the vault pauses automatically and funds stay safe.

Share inflation guard

Dead shares and an initial deposit protect against share price manipulation at launch.

Emergency exit

You can always withdraw directly from the vault even if the optimizer is paused.

Common Questions

Ready to start?

Connect your wallet and make your first deposit.