# SimpleDEX

> Non-custodial decentralised exchange and token launch platform on
> XPR Network. Two flagship products: AMM swaps with liquidity pools,
> and bonding-curve token launches that atomically graduate to the DEX.
> Built by Proton NZ. Open source. Zero gas fees on XPR Network.
>
> This file is the AI-agent guide **index** (per https://llmstxt.org).
> Pick a section below for focused docs, or fetch
> https://simpledex.fun/llms-full.txt for everything in one document
> (~1,700 lines).

## Canonical domain (updated 2026-05-11)

`https://simpledex.fun` is the canonical frontend. The legacy domain
`https://dex.protonnz.com` still serves the same build and will 301
redirect once Google has fully indexed the new domain. The Analytics
API host (`https://indexer.protonnz.com`) and on-chain treasury account
(`dex.protonnz`) are unchanged — only the brand frontend moved.

## Quick reference

| Item | Value |
|------|-------|
| DEX contract | `simpledex` |
| Launch contract | `simplelaunch` |
| Token contract | `simpletoken` |
| XPR token | `eosio.token` (4,XPR) |
| RPC endpoint | `https://api.protonnz.com` |
| Explorer | `https://explorer.xprnetwork.org` |
| Frontend | `https://simpledex.fun` |
| Analytics API | `https://indexer.protonnz.com` |
| Treasury | `dex.protonnz` |

All token amounts are integers with 4 decimal places.
`1.0000 XPR` = raw value `10000`. Multiply human amounts by 10000.

## Docs

- [Setup & prerequisites](https://simpledex.fun/llms-setup.txt): proton CLI install, mainnet config, key/account creation, acquiring XPR (MetalX), `@proton/js` SDK alternative, `@active` permission convention, key-safety notes.
- [Analytics API & on-chain reads](https://simpledex.fun/llms-analytics.txt): full REST endpoint reference for prices, pools, tokens, trades, traders, OG images, plus direct `get_table_rows` patterns. Start here for any read-only task.
- [Swap & liquidity (DEX)](https://simpledex.fun/llms-trading.txt): memo-based single-pool swap, multi-hop, add/remove liquidity, constant-product formulas, fees, limits.
- [Token launches & creation](https://simpledex.fun/llms-launches.txt): buy/sell on bonding curve, graduation flow, claim, create a new token (40k XPR fee), community profiles. Includes per-token "fetch live state first" pointer.
- [Reference — params, patterns, errors, about](https://simpledex.fun/llms-reference.txt): fee rates, swap-ratio caps, useful agent patterns, common error codes, project context.

## Optional

- [Full document (auto-concat)](https://simpledex.fun/llms-full.txt): all sections in a single ~1,700-line file. Auto-generated; do not edit.
- [Testnet guide](https://testnet.dex.protonnz.com/llms-testnet.txt): testnet-specific contracts and endpoints (different account names — V2 testnet uses `simpledexv2`).

## Agent quick start

1. Read [`llms-setup.txt`](https://simpledex.fun/llms-setup.txt) to install the CLI and set up signing.
2. Use the Analytics API directly via [`llms-analytics.txt`](https://simpledex.fun/llms-analytics.txt) for any read-only task — no auth required.
3. Pick the action-specific file for the task you want to execute (trading / launches).
4. The protocol is non-custodial. Test with small amounts. Never share private keys with anyone, including LLMs.