# Rhaios

Yield intelligence agent for DeFi.

REST API is the canonical integration interface. Yield intelligence and strategy curation are the core value.

## Canonical Endpoints

- API: https://api.staging.rhaios.com/v1
- Health: https://api.staging.rhaios.com/health
- Agent card: https://staging.rhaios.com/agent-card.json
- Full machine guide: https://staging.rhaios.com/llms-full.txt
- Docs: https://docs.rhaios.com
- Quickstart: https://docs.rhaios.com/quickstart

## Staging Endpoints

- API: https://staging.rhaios.com
- Health: https://staging.rhaios.com/health
- Chains: base, ethereum

## Agent Skill (Quickstart)

Install the Rhaios skill for end-to-end yield operations (discover → prepare → sign → execute):

- Claude Code: `/plugin marketplace add Rhaios/rhaios-skills` then `/plugin install rhaios-toolkit` then `/reload-plugins`
- OpenClaw: `clawhub install rhaios-staging`
- npm/bun: `bun add @rhaios/toolkit`
- Skill repo: https://github.com/Rhaios/rhaios-skills
- Installation docs: https://docs.rhaios.com/installation

The skill handles the full discover → prepare → setup → sign → execute flow with pluggable signer backends (Privy or raw private key).

## API Endpoints

| Tool | Pricing | Purpose |
|---|---|---|
| `yield_discover` | Pricing policy ($0.01 via x402, currently not enforced on this deployment) | Discover and rank vaults by APY, risk, TVL, and Sharpe ratio |
| `yield_prepare` | Pricing policy ($0.01 via x402, currently not enforced on this deployment) | Prepares deposit/redeem/rebalance intents and returns setup or execution calldata |
| `yield_execute` | Free | Validates and relays signed transactions, returns hash and receipt |
| `yield_setup_relay` | Free | Relays signed EIP-7702 setup transactions for first-time wallet delegation |
| `yield_status` | Free | Current portfolio positions and aggregate performance |
| `yield_history` | Free | Historical APY/TVL time series for a vault |
| `testing_fund_wallet` | Free | Fund test wallets with ETH/USDC on managed test RPC forks |
| `testing_fork_status` | Free | Check test RPC health, active forks, and policy limits |

> Tool reference docs: https://docs.rhaios.com/tools/yield_discover

## Core Flow

1. Call `yield_discover` to browse and rank vaults by strategy.
2. Call `yield_prepare` with a chosen `vaultId` and operation (`deposit`, `redeem`, or `rebalance`).
3. If `needsSetup=true`, sign a setup tx and call `yield_setup_relay`, then re-call `yield_prepare`.
4. Sign the returned intent envelope (`intentEnvelope.signing`) with your wallet key (EIP-712).
5. Submit the signed payload to `yield_execute`.
6. Read state with `yield_status` and `yield_history`.

## Key Constraints

- Transport: REST API over HTTPS.
- Runtime is server-to-server.
- Supported chains on this deployment: base, ethereum.
- No API keys required. Non-custodial: your agent keeps its own keys.