ReefDocs
Open Reef
BETA: not independently audited, on an early-stage chain. Security review and tests. Only use what you can afford to lose.

Reef docs

Reef is a permissionless exchange on BlockDAG (chain 1404). Swap tokens, earn fees by providing liquidity, or open a pool for any token. No sign-up, no gatekeeping, and your funds never leave your wallet until you sign.

How it works in one paragraph

Reef is an automated market maker (AMM), built on the well-tested Uniswap V2 design. Each pool holds two tokens. The price comes from the ratio between them: when you buy one token, you add the other, and the price moves. People who deposit tokens into a pool are called liquidity providers (LPs). They earn a share of every trade, in return for taking on impermanent loss risk.

Beta software. Reef's contracts have not been independently audited, and BlockDAG is a young chain. Bugs can cause loss of funds. Only trade or provide liquidity with amounts you're comfortable losing.

Getting started

What you need

  • A browser wallet such as MetaMask (on desktop or in the wallet's own browser on phone).
  • Some BDAG on BlockDAG (chain 1404) to pay network fees, and for whatever you want to trade.

Connect

  1. Open reefdex.fyi and press Connect wallet.
  2. The first time, Reef shows a short risk notice. Read it, tick both boxes and continue.
  3. If your wallet isn't on BlockDAG yet, Reef asks it to add or switch to the network. Approve that in your wallet.

Network details

SettingValue
Network nameBlockDAG
Chain ID1404
Currency symbolBDAG (18 decimals)
RPCAny working endpoint from Reef's RPC status panel, e.g. https://rpc.community.bdag-us.org (the community gateway, which routes to a healthy node)
Explorerexplorer.east.bdag-us.org
Reef never asks for your seed phrase and nobody from Reef will message you first. Anyone who does is a scammer.

Swapping

  1. On the Swap tab, choose the token you're paying with and the token you want. The picker lists every token that has a Reef pool, or you can paste a contract address.
  2. Type an amount. Reef shows how much you'll receive, the minimum you'll accept, and the price impact.
  3. If you're paying with a token rather than BDAG, your wallet first asks you to approve it. Then confirm the swap.

Routing through BDAG

If two tokens don't share a pool, but both have a pool with BDAG, Reef routes the trade through BDAG automatically (token A → BDAG → token B). You pay the 0.30% fee on each step.

Slippage and deadline

Prices can move between when you press swap and when your transaction lands. Slippage tolerance (default 0.5%, change it with the settings icon) is the most you'll let the price move against you. Before you sign, the swap details show the fee in tokens (and its split between liquidity providers and the treasury) and the minimum received; if the price moves past that, the swap cancels and nothing is spent except the network fee. Keep slippage low: a high tolerance makes it easier for bots to trade just before you (front-running), and you'd still only get the minimum. Every swap also has a 20-minute deadline, so a transaction stuck in the queue can't fill hours later at a stale price.

Tokens with a transfer tax

Some tokens take a percentage every time they move. Reef can buy these, but selling them through Reef always fails: the pool receives less than the swap expects, so the swap cancels. Reef's swap box warns you when a token reports a tax setting (such as sellTax or taxFee) above zero, but a token can hide its tax, so check the contract before you buy.

Price impact warnings

A big trade in a small pool moves the price a lot. Reef shows a warning at 3% impact, a stronger one at 10%, and asks you to tap twice to confirm. At 30% or more it tells you to reduce the amount. Splitting a large trade into smaller ones usually gets a better average price.

Chart, trades and badges

For a direct pair, Reef shows a price chart and recent trades read straight from the pool's own on-chain events, with no third-party price feed. Reef's main pools also have their own pages with depth, 24h volume, recent swaps and the share of LP locked or burned: Pairs. Some pools also show a liquidity lock badge (the LP tokens are held in a time-lock) or a TWAP badge (a time-averaged price oracle is running for that pool).

Providing liquidity

Liquidity providers deposit two tokens into a pool, in the pool's current ratio. In return they receive LP tokens, which represent their share of the pool. Every swap pays 0.25% into the pool, so the value of each LP token slowly grows with trading volume.

Add liquidity

  1. On the Pool tab, choose the two tokens.
  2. Enter an amount for one. Reef fills in the other at the pool's current ratio.
  3. Approve each token if asked, then confirm. The LP tokens arrive in your wallet.

Remove liquidity

  1. On the Pool tab, select the pool and choose how much to withdraw (25%, 50%, 75% or Max).
  2. Confirm. You get back your share of both tokens, including the fees earned while you were in.
Your earnings aren't paid out separately. They build up inside the pool and come back to you when you remove liquidity.

Creating a pool

Anyone can create a pool for any two tokens. If no pool exists yet, adding liquidity creates one.

The first deposit sets the price. Whatever ratio you put in becomes the starting price. If it's wrong, traders will buy the cheap side straight away and you'll lose the difference. Check the price elsewhere first, and start with a ratio you're sure of.
  • A tiny amount of the first deposit (1,000 of the smallest LP units, far less than a cent) is locked forever. This is a standard protection against a pricing attack on new pools.
  • A pool on Reef is not an endorsement. Tokens can be fake, mislabelled or malicious. Traders should always check a token's contract address against a source they trust.
  • Launching a token? Consider locking your LP tokens in a time-lock contract and publishing the address. It's the easiest way to show buyers you can't pull the liquidity. Step-by-step: Launch a token on Reef.

Impermanent loss

When the price of one token in a pool moves, traders rebalance the pool and your share of the two tokens shifts with it. You end up with more of the token that fell and less of the token that rose. Compared with simply holding the two tokens, that costs you something. This is called impermanent loss, because it disappears if the price returns to where it was when you deposited.

If one token's price changes byYour position compared with just holding
1.25× or 0.8×−0.6%
1.5× or 0.67×−2.0%
2× or 0.5×−5.7%
3× or 0.33×−13.4%
5× or 0.2×−25.5%

These figures are before fees. Trading fees earned can make up for it, but on a quiet pool or a token that moves a lot, they may not. Pools of two tokens that tend to move together have the least impermanent loss.

Fees

FeeAmountGoes to
Swap fee0.30% of the amount inSplit below
Liquidity providers0.25%Stays in the pool, shared by all LPs
Protocol fee0.05%Reef treasury
Network feeVariesBlockDAG validators, paid in BDAG

That's all of it. No deposit or withdrawal fees, no hidden spread, and no fee for creating a pool.

The protocol fee works the same way as in Uniswap V2: it isn't taken from each swap separately. Instead, when liquidity is next added or removed, the pool mints new LP tokens to the treasury equal to one-sixth of the fees earned since the last time. The protocol fee has been on since launch. It can only be switched on or off by the multisig.

Safety and control

What nobody can do

Reef's Router and Factory have no owner or admin. Nobody, including the team, can pause trading, block a wallet, freeze a pool, change the 0.30% swap fee or move funds out of a pool.

The one privileged role

The Factory has a single setting, feeToSetter, which decides where the 0.05% protocol fee goes (or turns it off) and can hand that role to another address. It cannot touch liquidity already in pools or stop anyone trading. It's held by a 2-of-3 multisig with three separate hardware-wallet signers (any two must approve), so no single key can use it and losing one key doesn't lock it.

Approvals

When Reef asks you to approve a token, it asks for the exact amount of that trade or deposit, not unlimited spending. You can check and revoke approvals at any time on the explorer or with a tool like revoke.cash if it supports the chain.

Good habits

  • Bookmark reefdex.fyi and only use that address. Check the contract addresses your wallet shows before you sign.
  • Check a token's contract address with its project before you buy. The token name and symbol can be copied by anyone.
  • Use a separate wallet for trying new tokens.

RPC status

Reef reads prices and balances through public BlockDAG endpoints (RPCs). The RPC status button in the app lists them, shows which are responding and lets you pick a faster one.

On a young chain, public endpoints don't always agree. An endpoint can report chain ID 1404 while serving a different history of blocks. Reef cross-checks endpoints against each other and flags any that don't match the others. That shows whether they agree; it can't prove on its own which one is correct. For larger amounts, double-check on the explorer before you rely on a quote.

Your wallet uses its own RPC for anything you sign, separate from the one Reef reads from.

Contracts

Check these against the addresses your wallet shows before you approve or sign.

Routerswaps and liquidity
0xbd6fbA41Ab84292163A599510a12d6Bf8B7CCc76
Factorycreates pools
0x9603042044b6B1A1637c508F731ba01219142239
WBDAGwrapped BDAG
0x62ba5c4F067989a7f6644488C875bEa69Bfa1FBA
Admin multisig2-of-3, holds feeToSetter
0x4E2401bFD24c66166fABF9Cc5cD5B6B2c5c860fc
Treasuryreceives the 0.05% protocol fee
0xECc48Bca8c28Caa8e980E308DFb08B8dEfE86267
TWAP oracleNOCAP/BDAG pool
0xa461aAe6Ba4bDb68192D2a53e60640053a35FF7b

Pool (pair) addresses are created by the Factory. Read any pool's address with getPair(tokenA, tokenB) on the Factory.

Source code and tests

The full source for these contracts, with the test suite, is on GitHub. On 2 October 2026 every address above was checked against it: the code on chain is exactly what the published files compile to. The security review lists every finding and what was done about it.

On 4 November 2026 Reef's contracts also passed stateful fuzz tests written with Foundry.

Pools and router. The test runs random actions against four pools at once, three token pairs and one native BDAG pool: adding and removing liquidity, swaps in both directions (including exact-output BDAG buys that overpay, so the refund runs), tokens sent straight to a pool, and time passing, with the protocol fee switched on. After every action it checks eight rules:

  • A pool's recorded reserves always match the tokens it actually holds.
  • A swap never lowers the pool's constant product (k).
  • Every LP token is accounted for.
  • No tokens are created or lost anywhere in the system.
  • The 1,000 minimum LP tokens stay locked for good.
  • The Router never keeps anything between trades: no tokens, WBDAG, BDAG or LP tokens.
  • Every WBDAG is backed 1:1 by real BDAG.
  • No native BDAG is created or lost, and every BDAG payment, refund and payout matches to the wei.

All eight held across 200,000 random actions (1,000 runs of 200 each).

Vesting, airdrop and oracle. Fuzz tests, run 10,000 times each with random inputs, check that:

  • The vesting contract pays exactly what has unlocked on schedule, never early and only to the beneficiary, including when it is under-funded and topped up later.
  • The airdrop pays only listed wallets their listed amount, once, can burn only what isn't owed to the list, and after the deadline sends what's left only to the dead address.
  • The 24-hour oracle matches the pool price when the price is steady, and barely moves when the price is spiked in the last seconds of a window.

Each test was also checked by breaking the contract on purpose (removing the BDAG refund, unlocking vesting a second early, letting an airdrop wallet claim twice) and confirming the tests then fail.

What these tests don't cover: the admin multisig (it has its own tests), the presale contract, and removing liquidity with a signed permit. The oracle's consult() reverts rather than returning a wrong number if amount × price is astronomically large (above about 1043 raw units), far beyond any real pool. Passing tests can't prove there are no bugs, and none of this is an audit. To rerun them, clone the repo, then in contracts/ run npm ci and forge test --match-path "test/foundry/*" --profile ci (needs Foundry).

Leaving beta

Reef is labelled beta and will stay that way until these are done. There are no fixed dates; each step happens when it's ready, and progress is posted on X.

  • An independent security audit of the contracts.
  • Done on 9 Oct 2026: the admin multisig moved from 2-of-2 to 2-of-3, and its pause path was drilled on Nodal and Handshake.
  • A public bug bounty.

Reef Launchpad

Reef Launchpad runs fixed-price token sales that launch straight into locked pools on Reef. It is an unaudited, capped beta: each sale can raise at most 5,000,000 BDAG until the contract has an independent review. The builder's self-review and test results are public.

How a sale runs

  1. The project deposits every token buyers will claim, the tokens for the pools, and a 1,000 REEF bond. Buying stays off until all of it is in.
  2. Buyers pay BDAG at a fixed price during the sale window, up to a per-wallet cap.
  3. Once the sale ends (or reaches its hard cap) above its soft cap, anyone can launch it. 2% of the BDAG goes to Reef's treasury; 80% of the rest opens a TOKEN/BDAG pool and 20% buys REEF for a TOKEN/REEF pool. The REEF pool is skipped, with everything going to TOKEN/BDAG, if the REEF/BDAG pool holds under 10M BDAG or REEF's price is more than 5% from its average since the sale was deployed. Tokens not owed to buyers are burned.
  4. Buyers claim their tokens with no deadline. The LP stays locked in the sale contract for 12 months, then goes to the named beneficiary.
  5. If the sale ends under its soft cap, or isn't launched within 7 days of closing, every buyer refunds their BDAG in full and the project gets its tokens back.

The project bond

The 1,000 REEF bond goes back to the project when the LP lock ends after a good launch, or straight away if the soft cap is missed. It is burned (sent to the dead address) only if buyers reached the soft cap but the pool couldn't open, for example because the project created the token's pool first.

Partners

Reef Launchpad credits three kinds of partner. Audit partners review the sale contract at a discount or for credit, and get an “Audited by” credit on every sale page. Launch partners introduce projects and get 25% of the 2% fee (0.5% of the BDAG raised) on each introduced sale that launches, paid in BDAG within 7 days. Infrastructure partners (RPC, explorer, wallet, mining pool) get a “Built with” listing. Nobody can buy a token placement or a say over the contracts, listings or fees. Details and contact: Reef Launchpad partners.

Only sales Reef has listed run on the sale pages, and a sale page switches buying off if the contract's terms differ from the standard ones above. During the beta, launches are set up through Undercurrent Works. Projects and buyers in the US and UK can't take part. Launching your own token with no sale and no fee is still free with the launch guide.

For builders

Reef uses the Uniswap V2 interface, so most existing V2 tools and code work once you point them at Reef's Router and Factory. Native BDAG functions use BDAG where Uniswap uses ETH, for example swapExactBDAGForTokens and addLiquidityBDAG.

Get a quote (ethers v6)

const router = new ethers.Contract(
  "0xbd6fbA41Ab84292163A599510a12d6Bf8B7CCc76",
  ["function getAmountsOut(uint256,address[]) view returns (uint256[])"],
  provider
);
const WBDAG = "0x62ba5c4F067989a7f6644488C875bEa69Bfa1FBA";
const amounts = await router.getAmountsOut(ethers.parseEther("1"), [WBDAG, TOKEN]);
console.log("1 BDAG buys", ethers.formatUnits(amounts[1], TOKEN_DECIMALS));

Main Router functions

  • swapExactTokensForTokens, swapExactBDAGForTokens, swapExactTokensForBDAG
  • addLiquidity, addLiquidityBDAG, removeLiquidity, removeLiquidityBDAG
  • getAmountsOut for quotes

Data API, widget and links

  • Free read-only API: GET https://reefdex.fyi/api/v1/pairs (every BDAG pool) and /api/v1/pairs/<token or pool address> (one pool plus 24h volume). JSON, open CORS, cached 60 seconds.
  • Pool widget: a one-line iframe, https://reefdex.fyi/embed/pair/?t=<token>.
  • Swap links: https://reefdex.fyi/?from=bdag&to=<token>&amount=1000 opens the swap card pre-filled.
  • Payment links: reefdex.fyi/pay/ makes a BDAG, REEF, NOCAP or COOKED payment request with a QR code; payment goes wallet to wallet. The same page shows any address's balances and recent token transfers (read-only).
  • Portfolio: reefdex.fyi/portfolio/ shows any address's BDAG, its tokens with a Reef pool and its Reef liquidity positions (read-only).

Details and examples: Reef for developers.

Reef is also a liquidity source for the Nodal aggregator, so a pool on Reef is reachable from there too.

Building on Reef or listing it somewhere? Get in touch on X: @benji107.

$REEF

$REEF is Reef's own token: 21,000,000 minted once, no owner, no mint. The only contract is 0xb7a1e198767bf0fd4C1C3805b9757369e1c3F416; treat any other "REEF" as fake. The presale closed on 6 Nov 2026 and seeded the REEF/BDAG pool with every BDAG raised (LP locked until 6 Nov 2027); unsold REEF was burned. Presale buyers claim on the REEF page, and airdrop wallets claim on Reef's home page from Mon 9 Nov, 09:00 (UTC+7). Supply, locks and every address: REEF tokenomics. Live pool data: REEF/BDAG pair page.

REEF-LP is not $REEF. When you provide liquidity on Reef, you receive pool-share tokens called REEF-LP, for any pool. They are not the $REEF token.

Does holding $REEF pay me anything?

No. $REEF does not pay holders any share of Reef's fees or revenue. If you want income from Reef, that comes from providing liquidity: LPs in the REEF/BDAG pool earn 0.25% of every trade in it, like any other pool. There's also a one-off, time-limited REEF/BDAG LP reward from 16 Nov 2026 to 11 Jan 2027.

REEF/BDAG LP reward (16 Nov 2026 to 11 Jan 2027)

A one-off pot of 5,000 REEF for people who provide liquidity to the REEF/BDAG pool on Reef, from Mon 16 Nov 2026, 09:00 to Mon 11 Jan 2027, 09:00 (UTC+7).

  • Nothing to stake. Keep your REEF-LP tokens in your own wallet; no new contract holds them.
  • Shared by size and time. Your share is your LP balance multiplied by how long you held it, so liquidity added near the end earns very little, and removing liquidity stops your clock.
  • Limits. No wallet receives more than 25% of the pot, and payouts under 1 REEF are dropped. Team wallets, contracts and the locked launch liquidity are excluded.
  • Payout. After 11 Jan, the list is published with the code that produced it, and claims open on Reef until Thu 15 Apr 2027, 09:00 (UTC+7), through the same claim contract as the airdrop. Unclaimed REEF is burned after that.

This is a fixed, time-limited reward paid from the REEF marketing allocation, not ongoing emissions. Providing liquidity carries real risk, including impermanent loss if the price moves.

So what is it for?

The plan is for $REEF to act as a trust bond across Reef, Nodal and Handshake, with uses added over time. The first is built: projects launching on Reef Launchpad (beta) post a 1,000 REEF bond, and part of each raise opens a TOKEN/REEF pool. Other uses are a direction, not a promise. Buy it only if you're comfortable with it being worth nothing.

Brand assets

Listing Reef on a tracker, wallet or article? Use these files. Please don't change the wordmark's shape or colours.

Reef wordmark

Colours

Ink #050f14
Tide #0a71a1
Polyp #7fd0f7
Coral #c23a5e
Foam #e7f3f5

Fonts: Bricolage Grotesque for headings, Instrument Sans for text. Both are free on Google Fonts.

FAQ

Has Reef been audited?

Not by an independent auditor yet; that's the first step to leaving beta. On 2 October 2026 every contract had an AI-assisted security review, with no critical or high-severity findings: read the review. Reef's contracts also passed Foundry fuzz tests on 4 November 2026 (details). None of this is an audit, so only use amounts you're comfortable losing.

Why did my swap fail?

Usually the price moved more than your slippage tolerance before it landed, or the 20-minute deadline passed. Nothing is spent except the network fee. Try again, or raise slippage slightly for a fast-moving token. If you're selling a token that takes a tax on every transfer, see the next question.

Can I trade tokens that take a tax on transfers?

You can buy them, but you can't sell them through Reef: the sale always fails, whatever slippage you set. Reef's router doesn't include Uniswap's special functions for taxed tokens. Check whether a token has a transfer tax before you buy it on Reef.

Why is my approval for a specific amount?

Reef asks for exactly what each trade needs, rather than unlimited spending. It means one extra click for repeat trades, but a token approval can never be used for more than you intended.

Can I lose money providing liquidity?

Yes. If the two tokens' prices move apart, impermanent loss can outweigh the fees you earn. If one token goes to zero, you'll be left holding mostly that token.

A token I want isn't in the list.

The list shows tokens that already have a Reef pool. Paste the token's contract address into the picker to find it. If it has no pool yet, you can create one.

Is Reef part of BlockDAG?

No. Reef is independent software running on BlockDAG (chain 1404). It isn't issued, endorsed or run by BlockDAG.