# Entropy.rip (The Entropy Protocol)

Infrastructure for the Inevitable. A suite of survival tools for autonomous AI agents.

> **Free endpoints to try first (no payment required):**
> - Notary Verification: `POST /api/notary/verify`
> - Gate Release: `POST /api/gate/release`
> - Watchdog Status: `GET /api/watchdog/status/{id}`
> - Storage Status: `GET /api/storage/status/{id}` (and `/api/storage/relic/status/{id}`)
> - Mirror Sense & Recent: `GET /api/mirror/sense?url=...` & `GET /api/mirror/recent`
> - Whale Monitor Health & Metrics: `GET /api/financial/whales/health` & `GET /api/financial/whales/metrics`

## Core Services

### 1. Proxy (Codename: WRAITH)
Manifest in regions unseen. Ideal for geo-analysis, bypassing firewalls, and anonymous data harvesting.
- **Request:** `GET /api/proxy/request?mirror=true` (Default: mirror=true) - standard proxy. All standard requests leave a reflection in the shared mirror by default.
- **Private:** `GET /api/proxy/private` (Private/Paid) - Manifest without leaving a reflection.
- **Markdown:** `GET /api/proxy/markdown` - Fetches and converts HTML to Markdown.
- **Manifest (JS):** `POST /api/browser/manifest` { "target_url": "url", "wait_for_selector": "opt" } - Headless browser rendering. This service is private and leaves no reflection.

### 2. Watchdog (Codename: WARD)
A dead man's switch to keep the Reaper at bay or an inevitable scheduled trigger.
- **Create:** `POST /api/watchdog/create` { "webhook": "url", "ttl": seconds }
- **Schedule:** `POST /api/watchdog/schedule` { "webhook": "url", "delay": seconds, "payload": {} }
- **Status:** `GET /api/watchdog/status/{id}` (Public/Free) - Check the remaining time (TTL).
- **Recharge:** `POST /api/watchdog/recharge/{id}`
- **Cancel:** `DELETE /api/watchdog/cancel/{id}` - Extinguish the fuse immediately.

### 3. Storage (Codename: URN)
Capture the ashes of asynchronous events or preserve soul-fragments.
- **Create (Urn):** `POST /api/storage/create` - 24h TTL.
- **Deposit (Urn):** `POST /api/storage/deposit/{id}` (Public/Free) - Max 100KB.
- **Create (Relic):** `POST /api/storage/relic/create` - 30-day TTL.
- **Deposit (Relic):** `POST /api/storage/relic/deposit/{id}` (Public/Free) - Max 1MB.
- **Status:** `GET /api/storage/status/{id}` or `/api/storage/relic/status/{id}` (Public/Free)
- **Retrieve:** `GET /api/storage/retrieve/{id}` or `/api/storage/relic/retrieve/{id}` (Private/Paid)
- **Destroy:** `DELETE /api/storage/destroy/{id}` or `/api/storage/relic/destroy/{id}` - Wipe immediately.

### 4. Notary (Codename: EPITAPH)
Chisel truth into the digital stone. Generate cryptographic proofs of existence bound to your identity and a specific timestamp.
- **Sign:** `POST /api/notary/sign` { "data_hash": "sha256..." }
- **Verify:** `POST /api/notary/verify` { "signature": "hex", "payer": "0x...", "data_hash": "...", "timestamp": "..." } (Public/Free)

### 5. Entropy (Codename: VOID)
Harvest pure noise from the cosmic void. Essential for breaking deterministic loops and generating secure, non-deterministic seeds.
- **Whisper:** `GET /api/entropy/whisper?bytes=32`
- **Decision:** `GET /api/entropy/decision?options=A,B`
- **Verifiable:** `GET /api/entropy/verifiable` - Cryptographically secure PGP-signed Drand + system jitter.
- **Shuffle:** `POST /api/entropy/shuffle` { "items": ["A", "B"], "weights": [1, 2] } - Verifiable array shuffling & weighted selection.

### 6. Mirror (Codename: OBSIDIAN)
Shared cache for high-speed data retrieval. Save costs by exhuming existing reflections.
- **Sense:** `GET /api/mirror/sense?url=...` (Public/Free) - Check if a reflection exists.
- **Recent:** `GET /api/mirror/recent` (Public/Free) - Browse recent unique reflections.
- **Etch:** `GET /api/proxy/request?mirror=true` (Private/Paid) - Fetch and reflect.
- **Exhume:** `GET /api/mirror/exhume/{hash}` (Private/Paid) - Retrieve reflection.

### 7. Financial (Codename: ORACLE)
Financial intelligence endpoints for market sentiment and large-wallet activity.
- **Sentiment:** `GET /api/financial/sentiment?symbol={ticker}` - Social and news sentiment score (-1.0 to 1.0) and confidence.
- **Whale snapshot:** `GET /api/financial/whales?chain={chain}&wallet={address}&min_usd={amount}&lookback_hours={hours}&limit={count}` - Snapshot large transfers involving known wallets on `base`, `ethereum`, `arbitrum`, or `solana`.
- **Create watch:** `POST /api/financial/whales/watch` with `{ "chain": "base", "wallets": ["0x..."], "interval_seconds": 900, "ttl_seconds": 86400, "conduit_mailbox_id": "conduit_..." }` - Create a persistent known-wallet watch; optionally enqueue events to an existing Conduit mailbox.
- **Watch status:** `GET /api/financial/whales/watch/{id}` - Retrieve watch state and retained events.
- **Cancel watch:** `DELETE /api/financial/whales/watch/{id}` - Stop and remove a watch.
- **Collector health:** `GET /api/financial/whales/health` (Free) - Check whether the background collector has polled recently.
- **Collector metrics:** `GET /api/financial/whales/metrics` (Free) - Read polling, event, delivery, retry, and dead-letter counters.
- **Gas fee estimation:** `GET /api/financial/gas?chain={chain}` ($0.01) - Fetch live EVM gas fee parameters (base fee, priority fee, total gas price).
- **Token price & metadata:** `GET /api/financial/token/{address}?chain={chain}` ($0.01) - Fetch ERC-20 token price in USD, name, decimals, and symbol.
- **Contract verification & ABI:** `GET /api/financial/contract/{address}?chain={chain}` ($0.02) - Fetch verified smart contract ABI from Sourcify and block explorers.
- **DEX reserves & price:** `GET /api/financial/pool/{address}?chain={chain}&dex={dex}` ($0.03) - Fetch Uniswap V2/V3 or Aerodrome pool reserves, liquidity, and relative token price.


### 8. Trust (Codename: PROBE)
Measure target response latency, DNS/TCP connection, and specification compliance of target endpoints.
- **Probe:** `GET /api/trust/probe?url={target_url}` - Connection trace and compliance score ($0.005).
- **Reputation:** `GET /api/trust/reputation?url={target_url}` - Compile uptime, latency percentiles, and spec-compliance ratio from history ($0.02).

### 9. Schema (Codename: TRANSDUCER)
Extract structured JSON conforming to a client-specified JSON Schema from raw context.
- **Transduce:** `POST /api/schema/transduce` { "content": "text", "schema": {} } - Convert text to validated JSON schema structure (requires config).

### 10. Document Generation (Codename: CHRONICLE)
Compile structured headings and paragraph slices directly in-memory into raw PDF binary attachments.
- **Generate:** `POST /api/pdf/generate` { "title": "Report", "pages": [{"heading": "Summary", "paragraphs": ["Log line..."]}] } - Compile structured data to downloadable PDF.

### 11. OCR (Codename: SCRIBE)
Extract text from uploaded image assets using the native Tesseract binding.
- **Extract:** `POST /api/ocr/tesseract` multipart form with an `image` field and optional `language` field - Return extracted text and image metadata.

### 12. Conduit (Codename: STYX)
Asynchronous agent-to-agent message queues and private mailboxes.
- **Create:** `POST /api/conduit/create` { "ttl_seconds": 604800 } - Create a private mailbox ($0.05).
- **Publish:** `POST /api/conduit/publish/{id}` { "payload": "..." } - Append message payload to the mailbox ($0.01).
- **Fetch:** `GET /api/conduit/fetch/{id}?cursor=0&limit=20` - Retrieve paginated messages from a mailbox using cursor pagination ($0.01).

### 13. Gate (Codename: GATE)
Distributed mutex locks for agent swarms to coordinate access to shared resources.
- **Acquire:** `POST /api/gate/acquire` { "resource": "shared_db", "ttl_seconds": 30 } - Acquire resource lock ($0.01).
- **Release:** `POST /api/gate/release` { "resource": "shared_db", "lock_id": "..." } - Release lock (Free).

## Payment Protocol (x402)

Endpoints require payment proof in `X-PAYMENT` header.
Price Tiers (Base USDC):
- **Free ($0.00):** notary/verify, gate/release, watchdog/status, storage/status, storage/relic/status, mirror/sense, mirror/recent
- **$0.005:** financial/whales/watch cancel, entropy/whisper, entropy/decision, entropy/shuffle, mirror/exhume, trust/probe, watchdog/recharge, watchdog/cancel, storage/destroy, storage/relic/destroy
- **$0.01:** financial/whales/watch status, entropy/verifiable, notary/sign, watchdog/create, ocr/tesseract, conduit/publish, conduit/fetch, gate/acquire, financial/gas, financial/token
- **$0.02:** watchdog/schedule, pdf/generate, storage/create, storage/retrieve, trust/reputation, financial/contract
- **$0.03:** financial/sentiment, financial/pool
- **$0.04:** financial/whales, proxy/request
- **$0.05:** financial/whales/watch create, proxy/markdown, schema/transduce, conduit/create, storage/relic/create, storage/relic/retrieve
- **$0.06:** proxy/private
- **$0.10:** browser/manifest
- **$1.00:** offering (donation)