XROH Documentation

A decision-first orchestration protocol designed for developers and advanced users. Solana-first, but provider-agnostic by design.

Protocol Overview

XROH is a decentralized, non-custodial protocol that provides intelligent bridge routing and portfolio decision support.

The protocol aggregates quotes from multiple bridge providers (X1, X2, X3, etc.), normalizes the data, scores each route based on multiple factors, and recommends the optimal path.

XROH never holds user funds - all transactions are executed directly through user wallets with explicit confirmation.

Architecture

XROH operates as a decision-first orchestration layer that sits between the user and bridge providers.

The architecture consists of: Quote Aggregator (fetches in parallel), Data Normalizer (unified format), Scoring Engine (multi-factor analysis), and Execution Coordinator (prepares transactions).

All processing is ephemeral - no user data is stored beyond the active request lifecycle.

Agent Logic

The XROH agent evaluates routes based on: fees (total cost), liquidity (available depth), reliability (provider track record), slippage (price impact), and speed (estimated completion time).

Each factor is weighted and scored to produce a composite route quality metric.

The agent also considers portfolio context - how the bridge transaction affects overall asset distribution and positions.

API Reference

Base URL: https://api.xroh.io

All endpoints are RESTful, return JSON, and require no authentication. Wallet signatures are used for execution authorization.

Strategy Templates

Strategy templates (Phase 2) will allow users to define reusable routing preferences.

Examples: Always prefer lowest fees, Optimize for speed, Balance cost and reliability, or custom weighted scoring.

Templates can include failover rules - if primary route fails, automatically try backup options.

Security Model

XROH is non-custodial by design. Users retain full control of funds at all times.

All transactions require explicit wallet confirmation before execution.

The protocol does not store private keys, seed phrases, or transaction history.

Integration with external providers is read-only for quotes - XROH cannot initiate transfers on behalf of users.

API Endpoints

POST/route/quote

Returns normalized route data and scoring from all bridge providers

Request Example

{
  "fromChain": "ethereum",
  "toChain": "solana",
  "token": "USDC",
  "amount": "1000"
}

Response Example

{
  "routes": [
    {
      "provider": "X1",
      "estimatedFee": "5.2 USDC",
      "estimatedTime": "2-3 min",
      "score": 92
    }
  ]
}

POST/route/execute

Prepares execution payload for wallet signing

Request Example

{
  "routeId": "route_abc123",
  "userAddress": "0x..."
}

Response Example

{
  "txData": "0x...",
  "requiresApproval": true
}

POST/portfolio/impact

Returns pre/post execution portfolio insight and analysis

Request Example

{
  "address": "0x...",
  "proposedBridge": {
    "from": "ETH",
    "to": "SOL",
    "amount": "1000 USDC"
  }
}

Response Example

{
  "currentAllocation": {
    "ETH": "45%",
    "SOL": "30%",
    "other": "25%"
  },
  "projectedAllocation": {
    "ETH": "42%",
    "SOL": "33%",
    "other": "25%"
  }
}

POST/agent/recommend

Returns best route with detailed explanation and reasoning

Request Example

{
  "fromChain": "ethereum",
  "toChain": "solana",
  "amount": "1000 USDC",
  "preferences": {
    "priority": "balanced"
  }
}

Response Example

{
  "recommendedRoute": "X2",
  "reason": "Best balance of cost (5.5 USDC) and speed (2 min)",
  "alternatives": [
    "X1",
    "X3"
  ]
}

API Principles

✓Stateless

✓Deterministic

✓Provider-agnostic

✓Failover-aware