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

2. Non-custodial gauge rewards

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

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 →

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.

5. Governance routing through AccessHub

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

Key Concepts to Understand

ConceptDescriptionLearn More
Concentrated LiquidityProviding liquidity inside custom price rangesGuide
Weekly PeriodsContract time is tracked as block.timestamp / 1 weeksGuide
GaugeV3CL emissions distribution for active poolsGuide
xRAMTransfer-restricted governance token created from RAMGuide
VoteModuleContract that holds staked xRAM and exposes voting powerGuide
VoterTracks votes, gauges, emissions, and claimsGuide
hyperRAMERC4626 liquid wrapper minted by R33.solGuide
AccessHubRole, multisig, and timelock control layerGuide
APIIndexed and on-chain data surface for pools and protocol metricsGuide

Getting Started

For Traders

  1. Understand concentrated liquidity and swaps
  2. Learn pool fee behavior and pool selection
  3. Explore pool and route concepts

For Liquidity Providers

  1. Learn how active ranges work
  2. Understand weekly reward accounting
  3. Review the contracts overview

For Governance Participants

  1. Learn how RAM, xRAM, VoteModule, and Voter fit together
  2. Review xRAM conversion and exit semantics
  3. Read the Voter reference

For Developers and Integrators

  1. Review the contracts overview
  2. Use the REST API overview
  3. Explore the contract references
  4. Follow the local environment guide

Additional Resources

Community and Support