POST /v1/yield/prepare

Pricing policy — $0.01 per call via x402 when payment enforcement is enabled. Current pre-prod deployment keeps x402 disabled. When enforced, attach the X-PAYMENT header.

Prepare yield intents with execution calldata. Handles deposits, redemptions, and rebalances. Operations:

deposit (default): Discover best vault, score, and return deposit calldata. For unconfigured EOAs, includes EIP-7702 setup.
redeem: Build calldata for withdrawing from a vault position.
rebalance: Move funds from one vault to a better one. Always returns the recommended vault strategy with APY, risk, and TVL data.

Parameters

enum

Operation type: deposit into vault, redeem from vault, or rebalance between vaultsAllowed values: deposit, redeem, rebalanceDefault: "deposit"

string

Asset to deposit (e.g., “USDC”). Required for deposit.

string

Amount to deposit in human-readable form (e.g., “10000”). Required for deposit.

enum

Target chainAllowed values: active chain keys from rhaios-config.yaml for the deployment. Current pre-prod profile supports ethereum and base.Default: "base"

string

required

Agent’s EOA address

string

required

Target vault ID from yield_discover. Required for all operations.

string

Number of shares to redeem (as string for BigInt). Provide shares or percentage, not both.

number

Percentage of position to redeem. Provide shares or percentage, not both.

Example

curl -X POST https://api.staging.rhaios.com/v1/yield/prepare \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "deposit",
    "asset": "USDC",
    "amount": "1000",
    "agentAddress": "0x...",
    "vaultId": "42"
  }'

With x402 payment (when enforced):

curl -X POST https://api.staging.rhaios.com/v1/yield/prepare \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-proof>" \
  -d '{
    "operation": "deposit",
    "asset": "USDC",
    "amount": "1000",
    "agentAddress": "0x...",
    "vaultId": "42"
  }'

Response

The response varies based on whether your wallet needs first-time EIP-7702 setup.

Deposit — wallet already configured (`needsSetup: false`)

{
  "operation": "deposit",
  "intentId": "f3ab8fb8-4adb-4f0f-bcff-f38165d55f58",
  "needsSetup": false,
  "strategy": {
    "vaultName": "Aave V3 USDC",
    "expectedAPY": 0.162,
    "riskScore": "low",
    "protocol": "Aave V3",
    "chain": "base",
    "tvl": 45000000
  },
  "execution": {
    "intentEnvelope": {
      "version": "1",
      "intentId": "f3ab8fb8-4adb-4f0f-bcff-f38165d55f58",
      "chainId": 8453,
      "entryPoint": "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
      "sender": "0x...",
      "userOps": [{ "userOperation": { "sender": "0x...", "nonce": "0x1", "callData": "0x...", "signature": "0x1234" } }],
      "destinationExecutions": [],
      "expiry": 1739932000,
      "validAfter": 1739931100,
      "merkleRoot": "0x...",
      "proofs": [[]],
      "signing": { "domain": {}, "types": {}, "primaryType": "IntentEnvelope", "message": {} }
    },
    "to": "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
    "calldata": "0x...",
    "estimatedGas": "300000"
  }
}

Deposit — first-time wallet, full setup (`needsSetup: true`, `setupType: "full"`)

{
  "operation": "deposit",
  "intentId": "a1b2c3d4-...",
  "needsSetup": true,
  "strategy": {
    "vaultName": "Aave V3 USDC",
    "expectedAPY": 0.162,
    "riskScore": "low"
  },
  "setup": {
    "setupType": "full",
    "description": "First-time EIP-7702 delegation + module initialization",
    "authorization": {
      "contractAddress": "0x...",
      "chainId": 8453
    },
    "initCalldata": "0x...",
    "to": "0x..."
  },
  "setupTicket": {
    "version": 1,
    "walletAddress": "0x...",
    "chainId": 8453,
    "implementation": "0x...",
    "initCalldataHash": "0x...",
    "setupType": "full",
    "expiresAt": "2025-03-01T00:00:00.000Z"
  }
}

Deposit — module re-initialization (`needsSetup: true`, `setupType: "modules"`)

When delegation already exists but modules failed to initialize (e.g., initializeAccount() reverted silently in a prior setup attempt):

{
  "operation": "deposit",
  "intentId": "e5f6g7h8-...",
  "needsSetup": true,
  "strategy": {
    "vaultName": "Aave V3 USDC",
    "expectedAPY": 0.162,
    "riskScore": "low"
  },
  "setup": {
    "setupType": "modules",
    "description": "Module initialization only. Delegation already active — send as regular transaction (type 2), not Type-4.",
    "authorization": null,
    "initCalldata": "0x...",
    "to": "0x..."
  },
  "setupTicket": {
    "version": 1,
    "walletAddress": "0x...",
    "chainId": 8453,
    "implementation": "0x...",
    "initCalldataHash": "0x...",
    "setupType": "modules",
    "expiresAt": "2025-03-01T00:00:00.000Z"
  }
}

When needsSetup is true, sign and submit the setup transaction first, then call POST /v1/yield/prepare again to get the execution payload. For setupType: "full", sign a Type-4 (EIP-7702) transaction with authorization_list. For setupType: "modules", sign a regular Type-2 (EIP-1559) self-call transaction.

Redeem

{
  "operation": "redeem",
  "intentId": "2db20fca-a844-442c-9267-624f47b2f1f7",
  "needsSetup": false,
  "execution": {
    "intentEnvelope": { "version": "1", "chainId": 8453, "userOps": [{ "userOperation": { "sender": "0x...", "callData": "0x..." } }], "merkleRoot": "0x...", "proofs": [[]] },
    "to": "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
    "calldata": "0x...",
    "estimatedGas": "250000"
  }
}

Yield Endpoints

Testing Endpoints

POST /v1/yield/prepare

POST /v1/yield/prepare

Parameters

Example

Response

Deposit — wallet already configured (`needsSetup: false`)

Deposit — first-time wallet, full setup (`needsSetup: true`, `setupType: "full"`)

Deposit — module re-initialization (`needsSetup: true`, `setupType: "modules"`)

Redeem

​POST /v1/yield/prepare

​Parameters

​Example

​Response

​Deposit — wallet already configured (needsSetup: false)

​Deposit — first-time wallet, full setup (needsSetup: true, setupType: "full")

​Deposit — module re-initialization (needsSetup: true, setupType: "modules")

​Redeem

POST /v1/yield/prepare

Parameters

Example

Response

Deposit — wallet already configured (`needsSetup: false`)

Deposit — first-time wallet, full setup (`needsSetup: true`, `setupType: "full"`)

Deposit — module re-initialization (`needsSetup: true`, `setupType: "modules"`)

Redeem