FLOWFLOW
DocsWhitepaperPrivacyTermsSign in

FLOW · User & Operator Guide

FLOW Documentation

Learn how to use FLOW to manage personal multi-chain wallets, receive, send, convert, request payments, and earn native yield on NEAR. Looking for architecture, design principles, and trust assumptions? Read the FLOW Whitepaper.

Open AppWhitepaperPrivacy PolicyTerms of ServiceGitHub

On this page

  • 1. Quickstart & getting started
  • 2. Supported networks & assets
  • 3. Dashboard & activity
  • 4. Receive: direct deposits
  • 5. Send & @flow IDs
  • 6. Convert
  • 7. Add Money: native NEAR
  • 8. Request Payment / Links
  • 9. FLOW Earn & fee breakdown
  • 10. States & troubleshooting
  • 11. Security, anti-phishing & privacy
  • 12. Core concepts & glossary
  • 13. FAQ
  • 14. Changelog

1. Getting started

FLOW is a multi-chain wallet and payment experience. Recipients can receive direct on-chain deposits or share payment links with a chosen settlement asset and network, while payers can fund from a different supported asset/network when an eligible route exists.

  • Create an account: Sign in with Google or an 8-digit email OTP verification code (subject to enrollment), complete Personal account onboarding, accept security/consent steps, provision your multi-chain wallet, and claim your permanent @flow ID.
  • Returning users: Signing back in restores access to your existing account and permanent wallet addresses. Logging in never replaces your wallet with a fresh one.
  • Provisioning states: Wallets move through WAITING / QUEUED, PROVISIONING (processing), ACTIVE (ready), or SETUP_FAILED / RECOVERY_PENDING. Wallet readiness requires verified provider custody registration and security policy confirmation. A displayed address alone does not establish readiness.
  • 5-Minute Quickstart: (1) Sign in with Google or email OTP on your personal account, (2) wait for your wallet status to reach ACTIVE, (3) fund via Receive or Cross-Chain Add Money, and (4) send to an address or @flow ID, convert assets, create a payment link, or deposit into FLOW Earn.

2. Supported networks and assets

Account wallets operate on four mainnet networks: NEAR Mainnet, Solana Mainnet, Ethereum Mainnet, and Base Mainnet. Wallet holdings cover five asset families (NEAR, SOL, ETH, USDC, and USDT) strictly on verified chain-specific deployments.

Network & Address Distinction

  • Ethereum / Base (EVM): 0x-prefixed 20-byte hexadecimal address (42 characters)
  • Solana: Base58-encoded Ed25519 public key (32–44 characters)
  • NEAR Protocol: Named account (e.g. alice.near) or 64-character hex implicit account

Ethereum Mainnet and Base Mainnet display the same 0x EVM address for your account, but they are separate blockchains with separate assets and gas.

Verified Mainnet Wallet Catalog (Live Registry)

Rendered directly from FLOW's curated mainnet catalog. Guest-checkout source assets can span additional chains/tokens when supported by live NEAR Intents / 1Click discovery and an executable route. FLOW does not promise “every token.”

AssetNetworkStandardDecimalsContract / Identifier
ETH (Ether)Ethereum MainnetNATIVE18native
USDC (USD Coin)Ethereum MainnetERC2060xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
USDT (Tether USD)Ethereum MainnetERC2060xdac17f958d2ee523a2206206994597c13d831ec7
ETH (Ether)BaseNATIVE18native
USDC (USD Coin)BaseERC2060x833589fcd6edb6e08f4c7c32d4f71b54bda02913
SOL (Solana)SolanaNATIVE9native
USDC (USD Coin (Solana))SolanaSPL6EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDT (Tether USD (Solana))SolanaSPL6Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
NEAR (NEAR Protocol)NEAR MainnetNATIVE24native
USDC (USD Coin (NEAR))NEAR MainnetNEP141617208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1
USDT (Tether USD (NEAR))NEAR MainnetNEP1416usdt.tether-token.near

3. Dashboard

The account dashboard displays verified token balances per network (with explicit network badges so Base USDC and Ethereum USDC are never confused), recent transactions, monthly inflow/outflow totals, and a dedicated Cashflow Insights view.

Confirmed vs. Pending: Portfolio balances reflect confirmed on-chain state synced by FLOW's chain indexers. Pending deposits, unexecuted quotes, or transfers still in processing appear in Activity and live payment timelines until finality is confirmed.


4. Receive: direct deposits

  1. Choose the network and supported asset you want to receive.
  2. Copy or scan your permanent, account-linked wallet address.
  3. Send only the supported asset on that exact displayed network.
  4. Wait for network confirmation and check Activity and updated balances.
Warning: Sending an asset on the wrong network or sending an unsupported token to a Receive address can result in permanent loss or difficult recovery. Direct Receive is not a payment link: it does not generate a quote, swap route, or one-off deposit address.

5. Send & @flow IDs

  1. Choose a funded source asset and network.
  2. Enter and verify the recipient's wallet address, or enter their permanent @flow ID (e.g. name@flow) to resolve their active wallet address for the chosen destination asset and network.
  3. Enter the amount and review estimated gas/routing fees and your available balance.
  4. Approve the transfer using the app's required security and policy checks.
  5. Monitor broadcast and confirmation in Activity.

Direct transfers require the source chain's native gas token where applicable (for example, ETH on Ethereum/Base, SOL on Solana, or NEAR on NEAR). All sends are subject to account policy, spending limits, and execution enablement on that chain; self-sends to your own address or @flow ID are blocked.


6. Convert

  1. Select the source asset you hold and the target asset/network you want in your own wallet.
  2. Request an executable quote.
  3. Review estimated output, fees, quote expiration, slippage bounds, and funding requirements.
  4. Confirm and monitor settlement in the live timeline.

A quote is an estimate with an expiration window, not a completed conversion. Route availability varies with provider liquidity and pair support.


7. Add Money: native NEAR

Add Money lets you fund your permanent NEAR Mainnet wallet with native NEAR starting from an eligible external asset and network, subject to an executable cross-chain route.

Source choice → Live quote → Refund address (if required) → Provider-issued deposit instructions → External funding → Routing → Settlement verification

Important distinction: Add Money issues a quote-specific, one-off provider deposit address for that cross-chain swap. Do not confuse it with your permanent Receive address.


8. Request Payment / Payment Links

  1. Recipient chooses the desired settlement network, asset, optional fixed or open amount, and description.
  2. Recipient creates and shares the payment link.
  3. Guest payer opens the link without needing a FLOW account.
  4. Payer independently selects an eligible source network and asset.
  5. Payer reviews the live quote (and refund details if applicable) and sends funds to the provider-issued deposit instructions.
  6. Both sides track live status until confirmed settlement or an appropriate expiry, failure, or refund outcome.
Illustrative Example: A payer holds SOL on Solana while the recipient requests USDC on Base. When NEAR Intents / 1Click returns an active executable route, the payer funds the quoted Solana deposit address and FLOW tracks settlement of USDC on Base into the recipient's wallet.

9. FLOW Earn & fee breakdown

FLOW Earn connects directly to verified NEAR Mainnet DeFi contracts and displays live on-chain yields fetched from NEAR Mainnet RPC.

WorkflowAsset & ContractGas / Storage Reserve
LiNEAR DepositNEAR (linear-protocol.near)0.12 NEAR reserved for gas and NEAR account storage
LiNEAR Withdraw & ClaimLiNEAR (unstake / withdraw_all)0.05 NEAR gas floor; ~48h (~4 epochs) cooldown before Claim NEAR
Burrow Finance DepositNEAR-Mainnet USDC (contract.main.burrow.near)0.37 NEAR on first deposit (0.25 NEAR storage + 0.12 NEAR gas); 0.12 NEAR thereafter
Send & ConvertNEAR, Solana, Base, EthereumNative gas on the source chain plus live 1Click routing quote

10. Transaction states and troubleshooting

StateMeaning
QUOTE_OBSERVED / AWAITING_DEPOSIT / DEPOSIT_COMMITTEDAwaiting payer funding at the quote-specific deposit address before the quote deadline.
DETECTED / DEPOSIT_CONFIRMEDSource deposit observed on-chain; waiting for required confirmations before execution.
PROCESSING / SUBMITTED / SETTLINGCross-chain routing or destination broadcast is underway.
SETTLEDDestination transaction confirmed and reconciled in your wallet and Activity.
EXPIRED / FAILEDQuote window elapsed before funding or execution could not complete.
REFUNDED / EXCEPTION_REFUND_REQUIREDRoute did not settle; funds are returned to the configured refund address or flagged for refund handling.
UNKNOWN_AMBIGUOUS / RECONCILIATION_REQUIREDProvider response was ambiguous; automatic retries are paused while final on-chain status is verified.
  • Payment not detected yet: Verify the exact network, token contract, deposit address, and that the source transaction has sufficient confirmations.
  • Quote expired or rate changed: Request a fresh quote before sending funds; do not send to an expired deposit address.
  • Insufficient gas or balance: Ensure you hold enough of the source chain's native gas token in addition to the transfer amount.
  • Wallet provisioning pending or failed: Use the built-in onboarding recovery flow rather than attempting to recreate wallets manually.
  • Wrong-network deposit: Recovery is not guaranteed and depends on the receiving infrastructure and asset mechanics.
  • Finding hashes and references: Open Activity in your wallet to view the transaction hash, explorer link, and payment/transfer public ID.

11. Account security, anti-phishing & privacy

  • Sign in only through the official flow.devhub.forum origin using Google or email OTP; enroll or link email explicitly in Settings when required.
  • Never share OTP codes, session links, private keys, or seed phrases with anyone.
  • Review active sessions in Settings and revoke unrecognized devices immediately.
  • On-chain transaction confirmations can be irreversible. Always double-check destination network, asset, and recipient before confirming.
  • Custody model: FLOW provisions and operates wallets via provider-backed custody infrastructure (OutLayer) with encrypted custody credentials and policy enforcement; it should not be treated as purely local browser key custody.
  • Official Verification & Anti-Phishing: Only sign in at https://flow.devhub.forum. Verify NEAR Mainnet contract IDs before approving interactions: outlayer.near, intents.near, linear-protocol.near, and contract.main.burrow.near. FLOW team members will never DM you asking for OTP codes or private credentials.

Review our Privacy Policy and Terms of Service.


12. Core concepts & glossary

Chain Abstraction
Separating what asset you want to hold or send from which network holds your liquidity, handled via NEAR OutLayer and NEAR Intents.
Flow ID (@handle.flow)
A unique human-readable handle linked to your personal FLOW account so other FLOW users can send to you without copying long hex or base58 addresses.
MPC Policy Custody
Multi-party computation custody via NEAR OutLayer (outlayer.near) where on-chain policies authorize transactions without exposing raw seed phrases.
NEAR Intents (1Click)
Cross-chain intent quoting and solver settlement protocol that routes tokens across NEAR, Solana, Base, Ethereum, and 35+ additional networks.
Storage Deposit
NEAR Protocol's state-staking requirement locking a small amount of NEAR for account or DeFi contract storage (e.g., 0.25 NEAR on first Burrow deposit).
Unstaking Cooldown
The ~48 hour (~4 NEAR epochs) protocol waiting period after requesting a LiNEAR withdrawal before Claim NEAR becomes active.

13. Frequently asked questions

Do sender and recipient need the same network or asset?
Not always. Direct Receive requires the exact matching asset and network. Payment Links and Add Money can bridge or swap from a different source asset/network only when a supported executable route is available.
Does the payer need a FLOW account to use a payment link?
No. Guest checkout allows a payer to open a payment link, select an eligible source asset/network, review the quote, and fund the provider-issued deposit address without signing in.
Is Receive the same as Request Payment?
No. Receive shows your permanent, account-linked wallet addresses for direct on-chain deposits. Request Payment creates a shareable payment link where a payer can request a live quote and pay cross-chain.
Why do Ethereum and Base show the same address?
Ethereum Mainnet and Base Mainnet both use the EVM 0x-prefixed address format derived for your account wallet, but they are separate blockchains with separate balances and gas.
How long does a payment take?
Timing depends on source-chain confirmations, cross-chain routing liquidity, and destination-chain finality. FLOW displays live transaction states rather than guaranteeing a fixed settlement time.
Are all assets and routes available?
No. Wallet holdings and direct operations are scoped to verified deployments on NEAR, Solana, Ethereum, and Base. Cross-chain routes depend on live NEAR Intents / 1Click liquidity and route availability.
Which gas token do I need when converting or sending (e.g., Base to NEAR)?
You only need the native gas token on the network you are sending from (for example, at least 0.00001 ETH on Base when converting or sending from Base to NEAR). You do not need NEAR gas in advance to receive your converted NEAR.
If I pay a deposit address and the page refreshes or closes, will I still be credited?
Yes. As long as you sent the quoted amount on the right network before the quote deadline expired, FLOW monitors your deposit in the background until it settles into your wallet. Active, non-expired deposit addresses also persist across page reloads.
What happens if someone sends less or more than the quoted amount? Will they be refunded?
If less than the required amount is sent, the payment is not credited unless topped up before expiry, and the partial deposit is refunded by the routing provider to your refund address. On fixed-amount payment links, the recipient still receives the exact requested amount and excess overpayment above the quote buffer is refunded to your refund address, provided a valid source-chain refund address was entered and the refund covers network fee minimums.
How do LiNEAR and Burrow withdrawals and gas reserves work?
LiNEAR deposits reserve 0.12 NEAR for gas and NEAR account storage, and withdrawals require a 0.05 NEAR gas floor with a standard ~48h (~4 epochs) unstaking cooldown before you click Claim NEAR. Burrow Finance accepts USDC on NEAR Mainnet and requires 0.37 NEAR on first-time deposit (0.25 NEAR contract storage plus 0.12 NEAR gas).
Does FLOW support business or multi-user team accounts?
No. FLOW is built exclusively for personal accounts so individual users get a fast, focused experience.

14. Changelog

v1.2.0 (November 2026)

Added live on-chain LiNEAR APY and Burrow APR feeds, 0.12 NEAR deposit gas/storage reserve enforcement, LiNEAR unstaking status and Claim NEAR button, live Earn settlement tracker modal, asset-weighted 24h dashboard PnL, and deduplicated transaction notifications.

v1.1.0 (November 2026)

Added focus-only Live Payment and Conversion Trackers with reload persistence, Flow ID (@handle.flow) transfers, Cashflow Insights, and account-aware FLOW AI.

v1.0.0 (November 2026)

Initial mainnet release with NEAR OutLayer MPC provisioning, Google and email OTP sign-in, cross-chain Payment Links (/pay/[id]), and NEAR Intents 1Click routing.

FLOWFLOWMulti-chain wallet & payment infrastructure
DocsWhitepaperPrivacyTermsHome