Agent Runtime Interop
Rhaios is a vertical yield layer. It focuses on yield strategy, execution preparation, and yield-specific status/history reads. Many agent platforms are horizontal runtime layers. They usually handle session lifecycle, general compute, wallet orchestration, and cross-tool workflows.Transport vs value
- MCP is the transport: how runtimes discover and call Rhaios tools.
- Rhaios is the execution engine: deterministic strategy selection, execution plan construction, validation, and relay for yield operations.
Responsibility split
| Layer | Owns |
|---|---|
| Agent runtime (horizontal) | Session management, orchestration, retries, wallet UX, payment plumbing |
| Rhaios (vertical) | Yield strategy (yield_prepare), execution relay (yield_execute), portfolio/status reads (yield_status, yield_history) |
Recommended integration pattern
- Runtime opens and manages MCP session to Rhaios (
/mcp). - Runtime sends
yield_preparefor deposit/redeem/rebalance. - Runtime wallet layer signs payload locally.
- Runtime submits signed payload with
yield_execute. - Runtime reads
yield_status/yield_historyfor monitoring and agent memory.
Security boundary
Rhaios is non-custodial:- Rhaios does not hold signing keys.
- Rhaios does not sign transactions.
- Rhaios does not take custody of funds.
Failure modes to handle in runtime layer
- Payment failures (
402) foryield_prepare. - Session lifecycle issues (
mcp-session-idmissing/expired). - Transaction validation failures in
yield_execute. - RPC/transient relay failures requiring controlled retries.
Practical guidance
- Treat
yield_prepareresponses as short-lived execution plans. - Pass
intentEnvelope.merkleRootasintentIdintoyield_executefor explicit correlation. - Keep user-facing retry policy in the runtime layer, not in prompt logic.
- Use
/healthfor operational checks before large batches.