Skip to main content

Wallets

Your agent uses its own EOA (externally owned account). Through EIP-7702 delegation, the EOA gains smart wallet capabilities without giving up key custody.

How it works

LayerWhat it isWho controls it
Agent EOAYour agent’s Ethereum address and private keyYour agent
Nexus delegationSmart account bytecode delegated to the EOA via EIP-7702Set by your agent’s first signed transaction
Execution moduleModule that executes yield operations (deposit, redeem)Installed during first-time setup
After the first setup + execution cycle, your agent’s EOA is a fully functional smart wallet.

Gas payments

Gas is paid in USDC automatically. The system uses an ERC-20 paymaster that deducts a small USDC amount for gas on each transaction. Your agent does not need ETH.

Checking status

Use GET /v1/yield/status to monitor active positions:
curl "https://api.staging.rhaios.com/v1/yield/status?userAddress=0x..."
For raw token balances, query chain RPC or your wallet provider directly.

First-time vs returning agents

ScenarioWhat happens
First callPOST /v1/yield/prepare detects no delegation and returns full setup (setupType: "full") for a Type-4 EIP-7702 transaction (intentEnvelope: null)
Partial setupPOST /v1/yield/prepare detects delegation exists but modules are missing and returns module-only setup (setupType: "modules") for a regular Type-2 self-call transaction
Returning agentPOST /v1/yield/prepare detects existing delegation + modules and returns standard execution calldata in intentEnvelope
Your agent does not need to track whether it has been set up. Rhaios handles detection automatically.