# xmr.pub — full documentation for AI agents

> Anonymous VPS, Tor onion, XMR payment API, multichain RPC, and free P2Pool — no email, no KYC, Monero only.
> 匿名 VPS、Tor 洋葱、XMR 收款 API、多链 RPC、免费 P2Pool — 无邮箱、无 KYC，仅支持门罗币。

Site: https://www.xmr.pub
Pool: https://pool.xmr.pub

---

## Identity & access

- No email, no password, no KYC.
- Customer identity = `ph_` access token (HMAC-stored server-side).
- Token minted on first order at checkout; displayed **once**.
- Panel login: POST token to manage orders/services at /panel (browser stores in localStorage).
- Admin console: /admin (ADMIN_TOKEN header — operator only, not for customers).

## Product catalog (static mirror; live: GET /api/catalog)

### vps
- **Nano** (`nano`): 1 vCPU · 1 GB RAM · 15 GB NVMe — 0.03 XMR/mo
  Order: https://www.xmr.pub/checkout?product=vps&plan=nano
- **Small** (`small`): 2 vCPU · 2 GB RAM · 30 GB NVMe — 0.06 XMR/mo
  Order: https://www.xmr.pub/checkout?product=vps&plan=small
- **Medium** (`medium`): 4 vCPU · 4 GB RAM · 60 GB NVMe — 0.12 XMR/mo
  Order: https://www.xmr.pub/checkout?product=vps&plan=medium
- **Large** (`large`): 6 vCPU · 8 GB RAM · 120 GB NVMe — 0.22 XMR/mo
  Order: https://www.xmr.pub/checkout?product=vps&plan=large

### rpc
- **Starter** (`rpc-starter`): 10 req/s · 1M/mo · XMR/BTC/ETH — 0.05 XMR/mo
  Order: https://www.xmr.pub/checkout?product=rpc&plan=rpc-starter
- **Pro** (`rpc-pro`): 50 req/s · 10M/mo · XMR/BTC/ETH — 0.20 XMR/mo
  Order: https://www.xmr.pub/checkout?product=rpc&plan=rpc-pro
- **Unlimited (fair-use)** (`rpc-unlimited`): 200 req/s · 100M/mo · XMR/BTC/ETH — 0.60 XMR/mo
  Order: https://www.xmr.pub/checkout?product=rpc&plan=rpc-unlimited

### tor
- **Onion Endpoint** (`onion-basic`): Managed .onion hidden service — 0.02 XMR/mo
  Order: https://www.xmr.pub/checkout?product=tor&plan=onion-basic
- **Private obfs4 Bridge** (`onion-bridge`): Dedicated unlisted bridge — 0.03 XMR/mo
  Order: https://www.xmr.pub/checkout?product=tor&plan=onion-bridge

### pay
- **Merchant Checkout** (`pay-merchant`): Non-custodial XMR checkout API — 0.05 XMR/mo
  Order: https://www.xmr.pub/checkout?product=pay&plan=pay-merchant

### p2pool
- **Free Mining** (`p2pool-hosted`): P2Pool stratum + hashrate panel — Free
  Order: https://www.xmr.pub/checkout?product=p2pool&plan=p2pool-hosted

## Pricing rules

- All prices quoted in XMR (Monero).
- 3-month commitment: ~8% discount. 12-month: ~20% discount.
- P2Pool (p2pool-hosted): 0 XMR, instant provisioning.

## Order flow

1. GET /api/quote?product={vps|rpc|tor|pay|p2pool}&plan={id}&months={1|3|12}
2. POST /api/orders JSON: `{ product, plan, months, token?, ssh_pubkey? }`
3. Response includes order_id, invoice (XMR address) unless free.
4. Poll GET /api/orders/{id} until status=provisioning|active.
5. Panel GET /api/account with header `Authorization: Bearer ph_...`

## RPC gateway (after purchasing rpc plan)

- Issue key: POST /api/rpc/keys `{ chain: xmr|btc|eth }` with customer token.
- Use header `X-API-Key: rpc_...` on gateway paths /xmr, /btc, /eth.

## VPS access

```
torsocks ssh root@<onion-from-panel>.onion
```

## P2Pool mining

Dashboard: https://pool.xmr.pub
```
./xmrig -o <stratum-from-panel>:3333 -u <XMR_WALLET> -p x
```

## HTTP API reference

- `/api/healthz` — API liveness probe
- `/api/catalog` — JSON product catalog and XMR pricing
- `/api/status` — Aggregated service status JSON
- `/api/quote?product=vps&plan=nano&months=1` — Price quote for a plan
- `/api/orders` — POST create order (requires ph_ token for renewals)

## FAQ

### What is xmr.pub?
xmr.pub is a privacy infrastructure portal: anonymous VPS on a three-node Proxmox cluster, Tor hidden services, non-custodial XMR checkout for merchants, metered multichain RPC (XMR/BTC/ETH), and a free P2Pool mining endpoint. All prices are in Monero; there is no email signup or KYC.
（xmr.pub 是什么？）xmr.pub 是隐私基础设施门户：三节点 Proxmox 匿名 VPS、Tor 隐藏服务、非托管 XMR 商户收款、按量多链 RPC（XMR/BTC/ETH）以及免费 P2Pool 挖矿接入。标价均为门罗币，无邮箱注册与 KYC。

### How do I create an account?
There is no registration page. Place an order on /products; checkout mints a ph_ access token shown once. That token is your entire account — paste it on /panel to manage services.
（如何注册账号？）本站无注册页。在 /products 下单后，结账页会一次性显示 ph_ 访问令牌；在 /panel 粘贴该令牌即可管理全部服务。

### What happens if I lose my ph_ token?
Tokens are shown once and stored only as an HMAC hash server-side. We cannot recover a lost token. Services remain bound to the old token; you would need a new order for a new token.
（丢失 ph_ 令牌怎么办？）令牌只显示一次，服务端仅存哈希，无法找回。旧服务仍绑定旧令牌；需重新下单获得新令牌。

### How do I pay?
Paid plans generate a Monero invoice at checkout. After the required confirmations (default 10), provisioning starts automatically. P2Pool mining is free and activates immediately.
（如何付款？）付费套餐在结账时生成门罗发票，达到确认数后自动开通。P2Pool 挖矿免费，下单即开通。

### How do I SSH into my VPS?
Each VPS receives a dedicated .onion hostname in your panel after provisioning. Connect via Tor: torsocks ssh root@<your-onion>.onion
（如何 SSH 连接 VPS？）每台 VPS 开通后，面板显示专用 .onion 地址。经 Tor 连接：torsocks ssh root@<your-onion>.onion

### Where is the mining pool dashboard?
Public hashrate dashboard: https://pool.xmr.pub. Order Free Mining on /products for stratum credentials in your panel.
（矿池仪表盘在哪？）公网算力仪表盘：https://pool.xmr.pub。在 /products 选择 Free Mining 免费开通，面板可见 stratum 地址。

## Compliance

xmr.pub provides lawful privacy infrastructure only.

## Related properties

- Main portal: https://www.xmr.pub
- Mining pool UI: https://pool.xmr.pub
- This file: https://www.xmr.pub/llms-full.txt
- Summary: https://www.xmr.pub/llms.txt