> ## 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.

# Overview

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**](./core/RamsesV3Factory)

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**](./periphery/SwapRouter)

> [**Position Manager Reference**](./periphery/RamsesV3PositionManager)

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**](./gauge/GaugeV3)

> [**FeeCollector Reference**](./gauge/FeeCollector)

> [**FeeDistributor Reference**](./gauge/FeeDistributor)

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**](./governance/Voter)

> [**Minter Reference**](./governance/Minter)

> [**VoteModule Reference**](./governance/VoteModule)

> [**AccessHub Reference**](./governance/AccessHub)

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**](./tokens/xRAM)

> [**R33 / hyperRAM Reference**](./tokens/R33)

* **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`.