Token, hook, charter, artifacts, log.
Six contracts that share one ocean.
EtherSea is one ERC-20 token (symbol ES, supply 1,000,000) paired with ETH in a Uniswap V4 pool. The pool is wired to a custom hook that quotes a dynamic swap fee based on the trader's "depth", a number the hook itself tracks. The more you trade, the deeper your vessel sits. The deeper you sit, the cheaper your next swap is, down to a quarter of one percent at hadal depths.
Around the hook sit four supporting contracts that turn the protocol into a fleet rather than a single curve. The Charter registers a vessel name and callsign for each address. The Artifacts contract is an ERC-721 collection of dive markers, claimable when you cross a depth threshold. The Log is an append-only record of short captain's notes, gated by the Charter. Each web page reads one or more of these contracts directly. Where this document and the on-chain code disagree, the code wins.
Six production contracts in total, plus a CREATE2 deployer for the hook. All compile under solc 0.8.26, Cancun EVM, optimizer 200 runs. The hook permission bits are 0x0080 (beforeSwap only); the deployer mines a salt until the predicted address has that low-bit pattern.
04Each web page sits on top of one or more on-chain contracts. The full list:
The token. Standard ERC-20 with anti-whale guards at launch (1.0 percent max tx, 2.0 percent max wallet) and a one-way trading gate. All 1,000,000 ES is minted to the deployer at construction. The deployer pairs the entire supply with ETH in the V4 pool and calls openTrading(). After that point, no further mint is possible.
The V4 beforeSwap hook. Reads the trader's current depth, quotes a fee from the band table, then writes back the descent gained from this swap. Also keeps per-vessel counts of total cycles, total volume, deepest depth ever reached, and a ring buffer of the last 8 swaps. Tracks the single deepest vessel ever (the floor holder).
Per-address vessel registry. Each address can commission one vessel with a name, an 8-character callsign (unique, first come first served), and an optional motto. The Vessel page reads this. The Captain's log requires a commission before it accepts entries.
ERC-721 collection of dive markers, six tiers (Photic, Mesopelagic, Bathyal, Abyssal, Hadal, Mariana). Claim by calling claim(tier). The contract reads currentDepth from the hook and only allows the mint if the threshold is met. Each address can hold at most one marker per tier.
Pure on-chain SVG renderer for the markers. Six different tier motifs, each seeded by token id for visual variation. tokenURI returns a base64 data URI directly. No IPFS, no external API, no rerender transaction needed.
Append-only captain's log. Any commissioned vessel can write entries up to 200 characters. A 60 second cooldown stops spam. The Vessel page shows your own entries, the Soundings page shows the latest fleet-wide.
CREATE2 mining utility for the hook deployment. Brute-forces a salt until the predicted address ends in the right 14 low bits (0x0080) for beforeSwap-only permission. Run once.
Seven bells, in order from STOP to EMERGENCY, govern the dive cycle. The bell does not dictate final depth; it dictates the descent envelope. Currents and the vessel's existing operational depth modulate the result by ±18 %.
| BELL | SIZE | DESCENT | BAND |
|---|---|---|---|
| STOP | 0.00 | 0 m | Berthed |
| Dead Slow | 0.05 - 0.25 | ~ 340 m | Photic |
| Slow Ahead | 0.25 - 0.8 | ~ 720 m | Mesopelagic |
| Half Ahead | 0.8 - 4.0 | ~ 1 740 m | Mesopelagic |
| Full Ahead | 4.0 - 14 | ~ 4 480 m | Bathyal |
| Flank | 14 - 24 | ~ 7 820 m | Abyssal |
| Emergency | 24 + | ~ 10 800 m | Hadal |
A bell is ordered at the telegraph; the engine room must answer within the same block. An unanswered bell is the only condition under which a swap may revert at the hook layer. See § 05.2 (Reverts & the Mate's logbook).
Bells do not stack. A second order in the same block replaces the first; the engine room logs the replacement on Mate's logbook line 7. The vessel descends only to the last ordered bell, never the sum.
The floor is the deepest active vessel at any moment. While a vessel holds the floor, every other vessel's cycle credits a small ration - 0.18 % of swap size - to its hold. The hold accumulates without compounding and may be drawn at surface only.
Title transfers the instant a deeper vessel logs its cycle. There is no grace. The dispossessed vessel's hold is sealed at the cycle that displaced it; subsequent cycles will not credit until it re-takes the floor.
A vessel surfaces by abstaining from cycles for 24 hours. Its operational depth then resets to 0 m and its hold is released to the crew wallet. Surfacing forfeits any active floor; the floor passes to whichever vessel is next deepest.
Below 6 500 m the protocol charges an additional 0.04 % premium on the vessel's own cycle. This is the cost of operating in the hadal lattice and is paid to other floor-eligible vessels. It is not refundable.
A plate of the entire water column to scale, from the photic surface to the eleven thousand metres of the Mariana hadal. Click the plate to unfold.
The hadal is not hostile. It is indifferent. The vessel that respects this distinction returns; the vessel that does not, does not. The following are not optional:
The bridge bell, sonar return, and hadal creak are audio-opt-in. The crew may enable them from the bridge bar's right-side telemetry. Reduced motion disables all of the above and renders the ocean as a still gradient.
This manual is set in Cormorant SC at the captain's headings, Inter at the body, and Space Mono at the instrumentation. The cover bears the EtherSea seal, ink rust at the corners by design. The foldout is reproduced at A3 landscape; the binding tolerates one full unfolding without distress.
For corrections, address the Mate, c/o the Bridge.
09