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

# Concepts Overview

# Ramses Concepts

This section explains the on-chain mechanics that show up throughout the Ramses contracts, API, and integration guides.

## What is Ramses?

Ramses is a concentrated-liquidity DEX with:

* Weekly period-based liquidity accounting
* Gauge-directed emissions
* Protocol-fee routing to treasury and voter markets
* An address-based governance stack built around `xRAM`, `VoteModule`, `Voter`, and `AccessHub`
* A liquid governance wrapper exposed through `R33` / `hyperRAM`

## Core Mechanics

### 1. Concentrated liquidity with weekly accounting

Ramses extends Uniswap V3-style pools with weekly accounting that is later used by gauges and reward distributors.

* [Learn about Concentrated Liquidity →](./protocol/concentrated-liquidity)

### 2. Non-custodial gauge rewards

CL positions can earn rewards without moving the underlying pool liquidity into a separate staking contract.

* [Learn about the Protocol →](./ramses-protocol)

### 3. xRAM governance stack

The current governance model is address-based:

* `XRam.sol` converts RAM into transfer-restricted `xRAM`

* `VoteModule.sol` holds staked xRAM and exposes voting power

* `Voter.sol` stores votes for the next weekly period

* `FeeDistributor.sol` pays rewards to voter addresses based on periodized vote weight

* [Learn about Token Contracts & Emissions →](./tokenomics)

### 4. Liquid governance wrapper

`R33.sol` is the vault contract for the liquid governance wrapper. The token it mints is `hyperRAM`, an ERC4626 share token backed by xRAM staked in `VoteModule`.

* [Learn about Token Contracts & Emissions →](./tokenomics)

### 5. Governance routing through AccessHub

Operational changes across pools, gauges, xRAM, fee routing, and vault automation are coordinated through `AccessHub`.

* [Learn about the Contract Architecture →](../contracts/overview)

## Key Concepts to Understand

| Concept                    | Description                                                      | Learn More                                           |
| -------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
| **Concentrated Liquidity** | Providing liquidity inside custom price ranges                   | [Guide](./protocol/concentrated-liquidity)           |
| **Weekly Periods**         | Contract time is tracked as `block.timestamp / 1 weeks`          | [Guide](./tokenomics#weekly-periods)                 |
| **GaugeV3**                | CL emissions distribution for active pools                       | [Guide](./tokenomics#fee-routing-and-incentives)     |
| **xRAM**                   | Transfer-restricted governance token created from RAM            | [Guide](./tokenomics#xram)                           |
| **VoteModule**             | Contract that holds staked xRAM and exposes voting power         | [Guide](./tokenomics#votemodule)                     |
| **Voter**                  | Tracks votes, gauges, emissions, and claims                      | [Guide](./tokenomics#voter-and-weekly-periods)       |
| **hyperRAM**               | ERC4626 liquid wrapper minted by `R33.sol`                       | [Guide](./tokenomics#r33--hyperram)                  |
| **AccessHub**              | Role, multisig, and timelock control layer                       | [Guide](../contracts/reference/governance/AccessHub) |
| **API**                    | Indexed and on-chain data surface for pools and protocol metrics | [Guide](../api/overview)                             |

## Getting Started

### For Traders

1. Understand [concentrated liquidity and swaps](./protocol/concentrated-liquidity)
2. Learn [pool fee behavior and pool selection](./protocol/fees)
3. Explore [pool and route concepts](./protocol/swaps)

### For Liquidity Providers

1. Learn [how active ranges work](./protocol/concentrated-liquidity)
2. Understand [weekly reward accounting](./tokenomics#voter-and-weekly-periods)
3. Review the [contracts overview](../contracts/overview)

### For Governance Participants

1. Learn [how RAM, xRAM, VoteModule, and Voter fit together](./tokenomics)
2. Review [xRAM conversion and exit semantics](./tokenomics#xram)
3. Read [the Voter reference](../contracts/reference/governance/Voter)

### For Developers and Integrators

1. Review the [contracts overview](../contracts/overview)
2. Use the [REST API overview](../api/overview)
3. Explore the [contract references](../contracts/reference/overview)
4. Follow the [local environment guide](../contracts/guides/local-environment)

## Additional Resources

* [Ramses V3 Contracts Repository](https://github.com/RamsesExchange/ramses-v3-contracts)
* [ConsenSys Diligence Audit](https://diligence.security/audits/2024/08/ramses-v3/)
* [Cantina / Spearbit Audit](https://cantina.xyz/portfolio/ramses-exchange)
* [Code4rena Audit Report](https://code4rena.com/reports/2024-10-ramses-exchange)
* [Contract Addresses](https://docs.ramses.xyz/security/contract-addresses)
* [Research Papers](./research)

## Community and Support

* [Official Documentation](https://docs.ramses.xyz)
* [Discord Community](https://discord.gg/ramses)
* [Twitter/X](https://twitter.com/RamsesExchange)
* [GitHub](https://github.com/RamsesExchange)