Skip to main content

Architecture

Rhaios uses a non-custodial architecture where your agent’s EOA gains smart wallet capabilities through EIP-7702 delegation. Rhaios never holds keys or funds.

Why this is agent-safe for money movement

Autonomous agents need trustworthy intelligence and deterministic boundaries for financial actions. Rhaios enforces that boundary by returning structured execution plans, requiring caller-side signatures, and validating signed payloads before relay. The result is an execution path that is safer than free-form API scripting for value transfer:
  • Typed endpoint inputs and outputs
  • Explicit prepare -> sign -> execute transitions
  • Non-custodial signing boundary in the runtime wallet layer
  • Inspectable post-execution state via status/history endpoints

EIP-7702 delegation

EIP-7702 lets an EOA temporarily delegate its execution to a smart contract implementation. Your agent’s EOA delegates to a Nexus smart account, gaining access to:
  • Batch operations — approve + deposit in a single transaction
  • Module system — execution module for batched yield operations
  • Gas abstraction — pay gas in USDC instead of ETH
The delegation is set by signing an authorization and including it in a Type 4 transaction. Your agent’s key never leaves its control.

Flow

First-time setup

When POST /v1/yield/prepare detects that an agent’s EOA has no EIP-7702 delegation, it returns setup-only details for a direct EIP-7702 type-4 transaction. That setup transaction:
  1. Delegates the EOA to the Nexus smart account implementation
  2. Initializes the account with the default validator (signature verification) and execution module (yield operations)
After setup confirms on-chain, call POST /v1/yield/prepare again for the deposit/redeem/rebalance UserOperation payload.

Smart account modules

ModuleRole
ValidatorDefault validator — verifies the agent’s signatures on all operations
ExecutorExecutes yield operations (approve, deposit, redeem)

Preflight simulation

When preflight simulation is enabled, POST /v1/yield/execute creates an ephemeral test RPC at the latest block, simulates the signed transaction, and only submits to the bundler if simulation succeeds. The ephemeral fork is destroyed after each simulation regardless of outcome. This prevents failed transactions from reaching the chain and wasting gas. Simulation failures are surfaced as errors — there is no “observe-only” mode that would allow a failed simulation to proceed.

Execution Infrastructure

Rhaios builds on audited open-source contracts for on-chain execution: Rhaios is the yield intelligence and strategy layer on top of this execution infrastructure — vault discovery, risk scoring, strategy selection, and execution plan construction.

What Rhaios does and does not do

Rhaios doesRhaios does not
Find and score yield vaultsHold your agent’s private key
Build unsigned transaction calldataCustody funds
Simulate before submitting (when enabled)Sign transactions on your behalf
Submit signed transactions to the chainControl your smart wallet
Track positions and yield