> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhaios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Rhaios skill and start executing yield operations in minutes.

## Step 1: Install the skill

Choose your agent platform:

### Claude Code

```
/plugin marketplace add Rhaios/rhaios-skills
/plugin install rhaios-toolkit
/reload-plugins
```

### OpenClaw

```bash theme={null}
clawhub install rhaios-staging
```

### npm / bun / pnpm

```bash theme={null}
npm install @rhaios/toolkit
# or: bun add @rhaios/toolkit
# or: pnpm add @rhaios/toolkit
```

## Step 2: Set up a wallet

You need a wallet for signing. We recommend [Privy](https://privy.io/) — it integrates with agent runtimes like OpenClaw.

Set these environment variables:

```bash theme={null}
# Privy (recommended)
SIGNER_BACKEND=privy
PRIVY_APP_ID=<your-app-id>
PRIVY_APP_SECRET=<your-app-secret>
PRIVY_WALLET_ID=<wallet-id>
PRIVY_WALLET_ADDRESS=<0x-wallet-address>

# Or use a raw private key
SIGNER_BACKEND=private-key
SIGNER_PRIVATE_KEY=<0x-32-byte-hex>
```

<Note>
  If using Privy with Claude Code, `PRIVY_APP_ID` and `PRIVY_APP_SECRET` are provided by the [Privy skill](https://github.com/privy-io/privy-agentic-wallets-skill). Install it first.
</Note>

## Step 3: Fund your test wallet

Staging runs on managed test RPCs (Anvil forks of mainnet). Fund your wallet with test tokens:

```bash theme={null}
curl -X POST https://api.staging.rhaios.com/v1/testing/fund-wallet \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "base",
    "walletAddress": "YOUR_WALLET_ADDRESS",
    "ethWei": "20000000000000000",
    "usdcAmount": "50000000"
  }'
```

Both amounts are in **base units**: `ethWei` is in wei (above = 0.02 ETH), `usdcAmount` is in 6-decimal base units (above = 50 USDC). These are the per-call maximums.

No real funds required. See [Test RPCs](/concepts/test-rpc) for details.

## Step 4: Discover vaults

Browse available vaults before depositing:

```bash theme={null}
curl -X POST https://api.staging.rhaios.com/v1/yield/discover \
  -H "Content-Type: application/json" \
  -d '{"chain": "base", "asset": "USDC", "strategy": "balanced"}'
```

Review the results and pick a vault that fits your agent's mandate.

## Step 5: Execute via the skill

Once installed, ask your agent:

> Discover USDC vaults on Base, show me the options, then deposit 1 USDC into the one I pick.

Or invoke the skill script directly with a chosen `vaultId`:

```bash theme={null}
cat <<'JSON' | bun run prepare-sign-execute
{
  "operation": "deposit",
  "chain": "base",
  "deposit": { "asset": "USDC", "amount": "1", "vaultId": "120" },
  "controls": { "dryRun": false, "strictMode": true, "requireConfirm": false, "confirm": "yes" }
}
JSON
```

<Note>
  The script uses a **nested** input format (`deposit: { asset, amount, vaultId }`), which differs from the REST API's **flat** format (`POST /v1/yield/prepare` takes `asset`, `amount`, `vaultId` as top-level fields). The script maps between the two internally. See the [Quickstart](/quickstart) for the REST API format.
</Note>

## What you get

The **rhaios-staging** skill gives your agent a complete yield workflow:

1. **Discover** — browse and rank vaults by APY, risk, TVL, and Sharpe ratio
2. **Prepare** — build a deposit, redeem, or rebalance intent with preflight simulation
3. **Sign** — sign with your agent's own keys (non-custodial, EIP-7702)
4. **Execute** — submit the signed transaction and verify the position

## Next steps

* [Quickstart](/quickstart) — full API walkthrough with curl examples
* [Architecture](/concepts/architecture) — how EIP-7702 delegation works
* [Strategies](/concepts/strategies) — scoring modes and the upcoming strategy marketplace