# xMAQUINA DAO Portal

> Markdown mirror of the xMAQUINA DAO portal home page at https://dao.xmaquina.io. xMAQUINA is a DAO that gives token-holders early exposure to the world's leading humanoid robotics companies, governed on-chain by xDEUS holders. This file documents the page's structure and tells an LLM (or agent) where to fetch each live value. It does NOT contain live numbers — DEUS price, supply, treasury NAV, proposals, and portfolio data are served from the xMAQUINA backend API and must be fetched fresh. Update cadence on the live endpoints: ~60s for /dao/stats, on-demand for /dao/proposals.

## DAO

- Name: xMAQUINA DAO
- Mission: XMAQUINA is a decentralized ecosystem dedicated to humanoid robotics. Through the DEUS token, it coordinates treasury deployment, protocol development, and onchain infrastructure, providing structured access to the robotics capital markets.
- Governance token: xDEUS (staked DEUS — used to vote, propose, and direct treasury capital)
- Underlying token: DEUS (omnichain ERC-20 / SPL via LayerZero OFT, 3/3 DVN)
- Max DEUS supply: 1,000,000,000 (hard cap)

## Official DEUS contract addresses (all chains)

- Base: `0x940A319B75861014A220D9c6c144d108552B089B` — explorer: https://basescan.org/address/0x940A319B75861014A220D9c6c144d108552B089B
- peaq (same address as Base): `0x940A319B75861014A220D9c6c144d108552B089B` — explorer: https://peaq.subscan.io/account/0x940A319B75861014A220D9c6c144d108552B089B
- Ethereum: `0x2D3A1adC8C81d79251876ed686C996554Fb31C1F` — explorer: https://etherscan.io/address/0x2D3A1adC8C81d79251876ed686C996554Fb31C1F
- Solana (SPL mint): `7JoGUTeaXkjcMGa6xJP2idYNYiLreto1WnsACHnpw3Gd` — explorer: https://orbmarkets.io/token/7JoGUTeaXkjcMGa6xJP2idYNYiLreto1WnsACHnpw3Gd

DEUS is an omnichain fungible token powered by LayerZero, configured with 3/3 DVN. Only interact with the addresses above.

## Governance & staking contracts (Base)

DEUS-staking and DAO governance contracts, all on Base. The two staking contracts (xDEUS NFT + Escrow) are the ones surfaced on the /stake page.

- xDEUS NFT (staked position — your voting rights): `0xE6d5f7439Bc236C40054e2275f765f59343D4431` — explorer: https://basescan.org/address/0xE6d5f7439Bc236C40054e2275f765f59343D4431
- Escrow (holds staked DEUS): `0xA85A38796B951CE87B378538b32B3E6Ee3C4C373` — explorer: https://basescan.org/address/0xA85A38796B951CE87B378538b32B3E6Ee3C4C373
- DAO (Aragon DAO on Base): `0xfEA21e0500022F34dE0a02Ae3A7D04dF923Ed020` — explorer: https://basescan.org/address/0xfEA21e0500022F34dE0a02Ae3A7D04dF923Ed020

## Backend API

All endpoints below are relative to the xMAQUINA API base URL:

- Production: `https://api.xmaquina.io`

All endpoints are HTTP GET, return JSON, and require no authentication for the read paths listed here.

---

## Section 1 — DAO Stats (top of the home page)

The header band shows four KPI tiles plus a launch-state cell.

### Launch state cell

The cell renders a "Trade DEUS on Aerodrome" CTA card linking to the DEUS/VIRTUAL pool on Aerodrome:

- Aerodrome swap URL (DEUS/VIRTUAL on Base): https://aerodrome.finance/swap?from=0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b&to=0x940a319b75861014a220d9c6c144d108552b089b&chain0=8453&chain1=8453

### Four KPI tiles

Single endpoint backs all four tiles:

- `GET /dao/stats`

Response shape:

```json
{
  "deusPrice": "0.06",
  "deusPriceIsLive": false,
  "deusPriceChange": "0",
  "deusCirculatingSupply": "412538503",
  "deusMarketCap": "24752310",
  "deusMarketCapChange": "0",
  "deusFDV": "60000000",
  "deusFDVUSD": "60000000",
  "capitalDeployed": "...",
  "treasuryNAVUSD": "..."
}
```

Field map (header tiles):

- DEUS Price → `deusPrice` (USD). Sourced from CoinGecko: https://www.coingecko.com/en/coins/xmaquina
- DEUS Circulating Supply → `deusCirculatingSupply` (DEUS units). Includes publicly circulating DEUS plus the DAO treasury balance, which is under the direct control of xDEUS holders via governance. Follows CoinMarketCap's published circulating-supply methodology.
- Fully Diluted Valuation → `deusFDVUSD` (USD). Equals `deusPrice × 1,000,000,000`.
- Treasury NAV → `treasuryNAVUSD` (USD). Total treasury value including liquid assets, token holdings, and equity positions at current estimated value. Includes DEUS-priced positions, so it tracks the DEUS price feed.

`deusPriceIsLive=false` means the backend is still serving the seeded reference price. When it flips to `true`, the four tiles render the live CoinGecko / DEX-derived values; until then, dependent tiles render a "no data" state in the UI.

---

## Section 2 — Portfolio Highlights (carousel)

A rotating carousel of the robotics companies the xMAQUINA treasury has exposure to. Each slide links to a dedicated company page at `/web2/<slug>` on dao.xmaquina.io.

As of this file's last update, the roster is:

- 1X — Humanoids for the home. → /web2/1x-technologies
- Agility Robotics — Humanoids for commercial logistics and industrial automation. → /web2/agility-robotics
- Figure AI Robotics — AI-powered humanoid robots designed for manufacturing and logistics. → /web2/figure-ai
- Apptronik — Humanoids for the Workforce. → /web2/apptronik
- NEURA — Cognitive robotics for industrial automation. → /web2/neura-robotics
- Robotico → /web2/robotico
- Sanctuary AI → /web2/sanctuary-ai

This roster changes over time — the live carousel at https://dao.xmaquina.io is the source of truth.

---

## Section 3 — Latest Proposals

Renders the three most recently finished governance proposals. Voters are xDEUS holders; voting happens off-chain on Snapshot at https://vote.xmaquina.io.

### Endpoint

- `GET /dao/proposals`

Response shape:

```json
{
  "proposals": {
    "<id>": {
      "tag": "...",
      "voteEndsAtTimestamp": "<unix-seconds-string>",
      "...": "..."
    }
  },
  "total": "<string>"
}
```

The home page selects past proposals where `voteEndsAtTimestamp` is in the past, sorts descending by that timestamp, and shows the top three.

---

## Section 4 — Get DEUS

Six cards: where to buy, trade, or stake DEUS. Order and content as of this file's last update:

1. Aerodrome — central trading and liquidity marketplace on Base. → https://aerodrome.finance/swap?from=0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b&to=0x940a319b75861014a220d9c6c144d108552b089b&chain0=8453&chain1=8453
2. Virtuals Protocol — marketplace for trading and monetizing on-chain AI agents and robotics assets. → https://app.virtuals.io/virtuals/75919
3. Sunrise — gateway for launching assets on Solana with day-one liquidity and canonical markets. → https://www.sunrisedefi.com/?fromToken=USDC&toToken=DEUS
4. KuCoin — global centralized exchange providing deep liquidity. → https://www.kucoin.com/trade/DEUS-USDT
5. MEXC — centralized exchange known for early token listings, low fees, and global access. → https://www.mexc.com/exchange/DEUS_USDT
6. Stake DEUS — internal route to the staking flow that mints xDEUS for governance and ecosystem value flows. → https://dao.xmaquina.io/stake

---

## Section 5 — Join The DAO

Three calls-to-action below the Get DEUS grid:

- Community — Discord server. → https://discord.gg/xmaquina
- Governance — vote on proposals off-chain via Snapshot. → https://vote.xmaquina.io/
- Working Groups — apply to a DAO unit (also via Discord). → https://discord.gg/xmaquina

---

## Top-level routes on dao.xmaquina.io

Pages an LLM crawling this portal will encounter, with one-line purposes:

- `/` — DAO portal home (this file).
- `/treasury` — Treasury composition, holdings, and capital deployment.
- `/portfolio` — User's personal DEUS / xDEUS balances and claims ("My DEUS"). Wallet-connection required.
- `/stake` — Stake DEUS to mint xDEUS for governance and value flows.
- `/proposal` — Active and past governance proposals.
- `/community` — Community quests, draws, and engagement programs.
- `/community/quests` — Live quests.
- `/community/winners` — Quest winners.
- `/genesis` — Genesis Auction landing page.
- `/web2/:slug` — Per-company landing pages (one per robotics-portfolio company; see Section 2).

(Snapshot voting: https://vote.xmaquina.io · External docs: https://docs.xmaquina.io · Marketing site: https://www.xmaquina.io)

---

## Further reading

- Live portal (human view): https://dao.xmaquina.io
- Docs: https://docs.xmaquina.io
- Marketing site: https://www.xmaquina.io
- Snapshot (off-chain voting venue): https://vote.xmaquina.io
- Aragon DAO (on-chain governance): https://app.aragon.org/dao/base-mainnet/0xfEA21e0500022F34dE0a02Ae3A7D04dF923Ed020/dashboard?members=0x826CA0c721A1F1c2c6A469C65825d4E5a331e69d-multisig&proposals=all
- Discord: https://discord.gg/xmaquina
- Genesis Auction context: https://dao.xmaquina.io/genesis

## File metadata

- File path: `/llms.txt` (under https://dao.xmaquina.io)
- Constants above (contract addresses, max supply, link URLs) are static; flow metrics (DEUS price, circulating supply, FDV, treasury NAV, proposals) MUST be fetched live from the endpoints above.