# Bots, agents, and integrations (cxcash.app)

cxcash.app is a **client-side** non-custodial wallet. There is no server API to move funds on a user’s behalf without their unlock password. Agents and automation should use **deep links**, **WalletConnect**, and **machine-readable docs** below—not invented “API keys” for the wallet itself.

## Start here (human or LLM)

| Resource | URL |
| --- | --- |
| Short index | https://cxcash.app/llms.txt |
| Full markdown bundle | https://cxcash.app/llms-full.txt |
| Supported assets JSON | https://cxcash.app/supported-assets.json |
| CXCASH contract facts JSON | https://coinexchange.cash/cxcash.json |
| This guide | https://cxcash.app/agents.md |

## Deep links (drive the installed wallet / PWA)

| Flow | Universal link | In-app path (basename `/app`) |
| --- | --- | --- |
| CX Pay checkout | `https://cxcash.app/?payment=pi_<32 hex>` | `/pay?payment=pi_<32 hex>` |
| WalletConnect pair | `https://cxcash.app/wc?uri=<url-encoded wc:…>` | `/wc?uri=…` |
| Optional return after WC | append `&returnUrl=<https URL>` | same |
| CXChing (requires CoinExchange login) | https://cxcash.app/app/cxching | `/cxching` |

Payment client secrets match `^pi_[0-9a-f]{32}$`.

## WalletConnect (dApps and scripted pairing)

1. Your app obtains a `wc:` pairing URI from WalletConnect / Reown.
2. Send the user to `https://cxcash.app/wc?uri=…` (or encode that URL in a QR).
3. The wallet unlocks if needed, then pairs on `/app/connect`.

## CX Pay (merchant checkout)

The browser wallet opens checkout via deep link. Merchant/engine APIs (create checkout, webhooks) are on the CX Pay product—not in the wallet repo.

## CoinExchange public APIs (no wallet keys)

- Coin requests: `https://api.coinexchange.cash/api/v1/public/coin-requests`
- Auth / CXChing / referrals: CoinExchange `/api/v1` after user login (JWT audience `cxcash`)

## What belongs on CoinExchange.cash instead

- P2P escrow trades, swap routing, buy/sell CXCASH issuance flows.
- Merchant onboarding and CX Pay **server** keys.

## Crawling

`/app/*` is noindex. Prefer llms.txt, markdown alternates, and JSON feeds for agents.

Public site: https://cxcash.app — full maintainer guide lives in `docs/AGENTS.md` in the wallet source repository (not served from this URL).