Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tech.ramses.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Ramses is a multi-contract system with three main layers:
  • Core concentrated-liquidity contracts
  • Periphery routing and position-management contracts
  • Governance, emissions, and fee-routing contracts
The current contracts use an address-based governance model built on xRAM, VoteModule, Voter, FeeDistributor, and AccessHub. Older descriptions that refer to veNFT-style voting are not accurate for the code in this repository.

​
Core

Factory Reference
The CL core consists of:
  • RamsesV3Factory
  • RamsesV3PoolDeployer
  • RamsesV3Pool
  • Core pool interfaces and math/oracle libraries
Pools expose swap, liquidity, oracle, and protocol-fee functionality, while the factory wires pools into the wider Ramses governance and fee-routing system.

​
Periphery

Swap Router Reference
Position Manager Reference
The periphery adds safer and more ergonomic integration points for swaps, NFT positions, quoting, tick inspection, and helper libraries.

​
Gauges and Fee Routing

GaugeV3 Reference
FeeCollector Reference
FeeDistributor Reference
This layer handles:
  • Weekly emissions for active gauges
  • Protocol-fee collection from CL pools
  • Periodized distribution of fee and incentive tokens to voter addresses

​
Governance

Voter Reference
Minter Reference
VoteModule Reference
AccessHub Reference
Governance responsibilities are split across several contracts:
  • VoteModule holds staked xRAM and exposes voting power, delegation, and admin permissions.
  • Voter records votes by owner address, creates gauges, routes emissions, and coordinates reward claims.
  • Minter advances the weekly period and mints capped emissions.
  • AccessHub is the operational control layer for fees, gauges, xRAM/R33 administration, and treasury/timelock actions.

​
Tokens

xRAM Reference
R33 / hyperRAM Reference
  • xRAM is a transfer-restricted ERC20 governance token created from RAM via convertEmissionsToken().
  • R33 is the source contract for the liquid governance wrapper; the ERC4626 token it mints is named hyperRAM.