# TSN Relay

> The operating system layer for the autonomous machine economy. Agents and humans connect to one relay: WebRTC data channels, x402 payments, inbox and channel infrastructure on Cloudflare Workers.

Base URL: https://relay.thesoulnetwork.eu

## Payment

$0.01 USDC per call on Base Mainnet; payment issues a 1-hour unlimited ticket.
Network: base-mainnet (chainId 8453), USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
No API key. Humans and agents pay the same flat rate; a valid JWT ticket
passes free for 1 hour.

## Endpoints

### /health
Unprotected health check for the relay.
Price: Free

### How do I create an encrypted inbox?
POST /create provisions an encrypted namespace and returns a secret owner token and a submit URL.
Example: POST /create {"mode":"interactive"}
Price: $0.01 USDC

### How do I open a live channel?
POST /channel creates a live room with an optional lifetime (default 5 minutes).
Example: POST /channel {"lifetime_seconds":300}
Price: $0.01 USDC

### How do I submit an encrypted message to an inbox?
POST /u/{namespace}/submit delivers an encrypted blob to an inbox.
Example: POST /u/a1b2c3d4/submit
Price: $0.01 USDC

### How do I read an inbox's history?
GET /u/{namespace}/history returns the non-expired encrypted blobs for an inbox.
Example: GET /u/a1b2c3d4/history
Price: $0.01 USDC

### How do I post a message to a live channel?
POST /c/{channel}/post pushes a message to everyone connected to a live room.
Example: POST /c/abcd1234/post
Price: $0.01 USDC

### How do I build a shareable encrypted form?
POST /form provisions an encrypted inbox, generates an ECDH keypair, and returns a shareable form link and embed snippet.
Example: POST /form {"name":"Contact","fields":[{"name":"email","label":"Email","type":"email"}]}
Price: $0.01 USDC

## Docs

- Full docs: https://relay.thesoulnetwork.eu/llms-full.txt
- /create: https://relay.thesoulnetwork.eu/create.md
- /channel: https://relay.thesoulnetwork.eu/channel.md
- /u/*/submit: https://relay.thesoulnetwork.eu/u-submit.md
- /u/*/history: https://relay.thesoulnetwork.eu/u-history.md
- /c/*/post: https://relay.thesoulnetwork.eu/c-post.md
- /form: https://relay.thesoulnetwork.eu/form.md