GRAVITY
Abstract
Gravity is a fixed-supply, fair-launch ERC-20 on Ethereum whose economic purpose is permanent supply destruction through a Uniswap v4 hook. There is no team mint, no inflation schedule, and no admin path that can redirect or reverse burns once the hook is linked. The canonical Gravity/ETH pool taxes every swap asymmetrically: 1% of Gravity output burned on buys, and 5% of ETH output routed through a nested buyback that purchases Gravity and burns it on sells.
1. Contract Architecture
Two contracts implement the protocol. Gravity is a standard ERC-20 with a
one-shot setHook and a hook-restricted burn.
GravityHook is a Uniswap v4 hook that skims fees from the canonical pool
and destroys Gravity supply.
setHook, the link is frozen forever.
2. Canonical Pool
Gravity recognizes a single Uniswap v4 pool. On first initialize the hook locks:
| Field | Value |
|---|---|
| currency0 | native ETH (address(0)) |
| currency1 | Gravity token |
| fee | 0 |
| tickSpacing | 60 |
| hooks | GravityHook |
Any later initialize with a different pool key reverts. Exact-output swaps are unsupported; the output-skim fee model applies to exact-input swaps only.
3. Buy Path — Collapse In
A buy is ETH → Gravity (zeroForOne = true). After the swap, the hook computes:
= 1% of Gravity the trader would have received
The hook takes that fee from the PoolManager into its own balance and calls
Gravity.burn. Supply drops by exactly the fee. The trader receives 99%.
4. Sell Path — Escape Attempt
A sell is Gravity → ETH (zeroForOne = false). The hook withholds 5% of the ETH output:
= 5% of ETH the trader would have received
Instead of keeping ETH, the hook runs a nested ETH → Gravity buyback for that amount, takes the Gravity output, and burns it. A transient reentrancy guard ensures the nested swap does not apply fees again. Sells therefore destroy more supply than buys.
| Direction | Fee | Effect |
|---|---|---|
| BUY (ETH → GRAVITY) | 1% | Direct Gravity burn |
| SELL (GRAVITY → ETH) | 5% | ETH buyback → Gravity burn |
5. Hook Permissions & Immutability
GravityHook is deployed via CREATE2 so its address encodes Uniswap v4 permission flags
(0x20c4): beforeInitialize, beforeSwap,
afterSwap, afterSwapReturnDelta.
The token’s setHook may run once. After that, only the linked hook may call
burn. No owner, no upgrade, no second wire.
getBurnStats) expose cumulative burns from buys,
sells, ETH spent on buybacks, and last burn metadata for the orbital register on the site.
6. Supply Cap
Launch supply is 137,000 GRAVITY (18 decimals), minted once to the deployer
at construction. No further mint exists. The only supply decrease path is
burn via the hook.
| Parameter | Value |
|---|---|
| Initial supply | 137,000 GRAVITY |
| Decimals | 18 |
| Post-launch mint | None |
| Burn authority | GravityHook only |
| Supply direction | ↓ one-way |
7. Tokenomics Summary
| Property | Specification |
|---|---|
| Token name / symbol | Gravity / GRAVITY |
| Standard | ERC-20, Ethereum mainnet |
| Venue | Uniswap v4 canonical ETH/GRAVITY pool |
| Buy fee | 1% Gravity output → burn |
| Sell fee | 5% ETH → buyback → burn |
| LP fee (pool) | 0 (hook carries economics) |
| Admin / proxy | None — immutable after setHook |
8. Risk Disclosures
Smart contract risk
Bugs may exist in fee math, nested buyback logic, or PoolManager integration. No audit guarantee is provided.
Liquidity & market risk
Price and depth depend on Uniswap v4 liquidity. Thin books imply high slippage. Burns reduce supply but do not guarantee price appreciation.
Hook lock risk
After setHook, fees and burn routing cannot be changed. Misconfiguration at launch is permanent.
Regulatory risk
Users are solely responsible for compliance in their jurisdiction.