Word came down the trunk again. Ratatoskr, who runs between the eagle at the crown and the serpent at the roots, carried this one to the shore, to Nóatún, the harbour the old poems give to Njörðr, lord of ships and the sea's edge. It is a place of trade: things arrive from other realms, change hands, and go out again.
His daughter Freyja keeps watch over wealth set in motion, what is put to work rather than kept. This is where it moves: coins traded one against another, depth laid down in the pools, wRATR locked for a share of every fee, and votes that steer where the new wRATR runs.
What follows is the harbour as it works, in the order a newcomer meets it. The steps are plain. They are meant to be read with a wallet open.
The harbour at a glance #
Nóatún is the exchange on Alephium where wRATR trades. Five things happen here:
- Swap one token for another against a pool.
- Provide liquidity: deposit both sides of a pool and earn the LPs' share of its fees.
- Lock wRATR for a term and earn a share of the protocol's cut of every fee.
- Vote with a lock position to steer each epoch's new wRATR between pools.
- Stake LP in a gauge and receive that pool's share of the new wRATR.
The page never holds a key and never custodies anything. Every action is a transaction your own wallet signs. There is no router contract in between.
Before you sail: bring the coins in #
wRATR #
wRATR is RATR, wrapped one for one by the Ratatoskr Bridge. Send RATR from its own chain to the bridge and it arrives on Alephium as wRATR. Send wRATR back and RATR is released. The bridge page shows its limits and confirmation times before you send anything.
wRATR on Base or BNB Chain is the same coin. It bridges to Alephium the same way.
ratatoskrbridge.enchantedforestdefi.com →
ALPH and dollars #
ALPH is Alephium's own coin. Buy it anywhere ALPH trades, or trade for it in the harbour. The harbour's two dollars both come over the Alephium Bridge: USDC.eth from Ethereum and USDT.bsc from BNB Chain.
Gas
Every Alephium transaction pays a little ALPH for gas. Keep about 1 ALPH in the wallet you use here.
Connect a wallet #
- Press the wallet button, top right.
- Choose the Alephium extension wallet or the desktop wallet.
- Approve the connection in the wallet.
The page then reads your balances and positions from the chain.
One approval per action
Each approval in the wallet is a separate transaction, and the wallet keeps its queue even across a page reload. If it ever shows more than one approval waiting, approve one and reject the rest. The harbour's transaction box says this every time, and will not send a second copy of the same request for two minutes.
Swap #
- Open the Swap tab and pick the pool.
- Pick the direction and type the amount.
- Read the panel: what you receive, the minimum you will accept at your slippage tolerance, the price impact, the pool's fee and the spot rate.
- Sign.
Every figure on the panel is computed from the pool's reserves a moment before. The minimum protects you. If another trade lands first and moves the price past your tolerance, your swap reverts instead of filling at the worse price.
The price-impact line shows how far your trade moves the pool's price. A large trade against a shallow pool moves it a long way, and the panel says so before you sign.
Each pool's fee is set in its contract, which only accepts values from 0.01% to 1.00%. The fee in force is the one the panel shows.
Provide liquidity #
- Open the Liquidity tab and pick the pool.
- Type one amount. The other side fills in at the pool's current ratio.
- Sign. You receive LP tokens for your share of the pool.
From then on, the LPs' share of every trade's fee in that pool accrues to you, share for share, inside the pool's reserves. How large that share is depends on whether the pool has a gauge. A pool with no gauge keeps at least 80% of every fee for its LPs, a floor written into the contract. A gauged pool's LPs keep a smaller share, and the pool also receives new wRATR through its gauge (see Gauges). Each pool's current split is on its card in the Liquidity tab, read from the contract.
Withdraw any part of your position whenever you like. There is no lock and no exit fee. Withdrawals round down by one base unit in the pool's favour.
Off-ratio deposits and empty pools
A deposit off the pool's ratio is not lost. Only the matched amounts are taken and the rest stays in your wallet, but the position is smaller than the amounts you typed. The panel shows what would go unused before you sign. On an empty pool the first deposit sets the price, and the panel says so when that is the case.
Lock wRATR for the fees #
Lock wRATR for one to twenty-six epochs. An epoch is one week, and it turns at Thursday 00:00 UTC.
A position has power: the amount locked times the time it has left to run. A longer term carries more power, and power steps down at each epoch turn as the term runs out. Every fee delivery to the lock is shared among all live power, share for share.
The protocol's cut of every fee comes to the lock and divides two ways: the lockers' share, and the rest to the sink. The lockers' share is set in the FeeSplitter contract, which only accepts values from 33% to 80%. Its current value is a field on that contract, which is listed with its explorer link in the harbour's footer.
- Open the Lock tab.
- Type the amount and choose the term in epochs.
- Sign. The position appears with its power.
- Claim fees from the Lock tab whenever you like.
There is nothing to check in for. Fees accrue from the next delivery on, and what is yours stays claimable for as long as you leave it.
You can add to a position or extend its term at any time. A term cannot be shortened and the principal cannot be withdrawn early. When the term ends, withdraw the principal. Any fees still owed stay claimable afterwards.
Vote: steer the new wRATR #
Each epoch a fresh stream of wRATR is released to the gauged pools. The stream tapers every epoch, and the Minter that releases it can never book more than its pot holds. Lockers vote on how it is divided.
- You vote with a lock position, not a wallet. Each position votes its own power, and can divide that power across gauged pools. Power divides; it does not copy.
- A vote lasts one epoch. It does not carry into the next. The weights one epoch's votes build divide the following epoch's stream, and a position that wants a say again votes again.
- A vote counts for the time it is in place. It earns its weight for every moment from when it is cast to the end of the epoch. Cast at the start, it counts for the whole epoch. Cast in the final hour, it counts for that hour.
- Voters steer the new wRATR; they do not receive it. It goes to the people staking LP in the gauges. Lockers are paid from fees whether they vote or not: not voting costs influence, never fees.
Vote incentives #
Anyone may deposit tokens against a gauge to draw votes to it. Once the epoch closes, those incentives are split among the positions that voted for that gauge, in proportion to the vote weight each earned. They are claimed per position.
- Open the Vote tab with a wallet that holds a lock position.
- Choose the position and divide its power across the pools.
- Sign. Repeat in each epoch you want a say in.
Gauges: stake your LP #
A gauge is a pool's LP staking contract. Stake the LP tokens you received for providing liquidity, and that pool's share of each epoch's new wRATR streams to you per second, in proportion to your stake.
- Provide liquidity to a gauged pool (see Provide liquidity).
- Open the Gauges tab and pick that pool.
- Type the LP amount and sign.
- Claim whenever you like. Unstake to get the LP back, then withdraw from the pool in the Liquidity tab.
Stake, unstake or claim at any time. Nothing is forfeited and there is nothing to check in for. A claim pays everything accrued up to the moment it lands. If nobody is staked in a gauge, its stream waits and resumes for the first staker in.
While your LP is staked, the LPs' share of the pool's fees keeps accruing inside the reserves, and you collect it when you withdraw from the pool. The gauge holds your LP and has no path for anyone else to move it: no owner withdrawal, no rescue, no drain.
Where every fee goes #
Every trade pays the pool's fee. The LPs' share stays in the pool. The rest is the protocol's cut, which divides between the lockers and the sink as set out above.
The fee basket #
Fees paid in tokens other than wRATR cannot go to the lockers as they are. They collect in a basket, and anyone may buy the whole basket by paying its posted price in wRATR. That wRATR then flows to the lockers and the sink in the same split as every other fee. The basket's contents and its price are on the Dashboard, read from the contract.
The sink #
The sink is a one-way door. The contract has one function, which receives. It has no withdrawal, no owner, no rescue and no self-destruct. Whatever arrives is out of reach for everyone, for good.
It is called sunk rather than burned, and the difference is real. wRATR is not the canonical coin: RATR on its own chain is. So nothing here destroys supply. wRATR's total supply is deliberately left untouched, which keeps the bridge's backing arithmetic honest. The sink keeps its own running count, and its wRATR balance on chain is the independent check on that count. Anyone can read both. The running total is on the harbour's ticker, marked Sunk.
Your berth: the Dashboard #
The Dashboard shows everything the connected wallet holds in the harbour on one page: balances, deposits per pool with what a full withdrawal would return now, and every lock position with its power and what is claimable. It also shows the harbour's total depth and what wRATR trades for here and elsewhere.
Nothing signs from the Dashboard. Every row hands you to the tab that owns the action.
Verify before you trust #
Every contract the harbour calls is listed in its footer with an explorer link, together with the codeHash the page checks against the chain before it renders. The address your wallet shows on a signing prompt should be one of those.
None of them is a deposit address. Nothing in the harbour asks you to send coins to an address.
Carried down 2026-10-03. This chapter states rules, not snapshots: live values are on the harbour's own tabs and contracts. Measured figures, with their dates, belong in the Reference chapter.