TOOL Integration Overview¶

Shared Concepts¶

Common Flow¶

TOOL (in the Searcher Network/v0 stage) accepts private or pre-merged orderflow, converts valid submissions into Commitments, lets searchers build on the allowed Commitment view inside the TOOL network, and routes valid enriched bundles according to callback and block-production policy.

flowchart TB
  subgraph Sources["Source integrator boundary"]
    direction TB
    SourceClients["OFP and PBS builder clients<br/>private txs and bundles"]
    SourceAuth["Source authentication<br/>callback eligibility"]
    Verifier["TEE verifier<br/>optional RA-TLS policy"]
  end

  subgraph ToolNetwork["TOOL network"]
    direction TB
    subgraph ToolTEE["TOOL node TEE environment"]
      direction TB
      Intake["Gateway and source intake<br/>eth_sendBundle / TOOL RPC"]
      Commitments["Commitment engine and feed<br/>origin tracking and timing"]
      Routing["Bundle API and routing policy<br/>simulate, submit, classify"]
      Native["Native block path<br/>subslot and relay delivery"]
      Intake -->|"form source commitments"| Commitments
      Commitments -->|"validated metadata"| Routing
      Routing -->|"accepted internal flow"| Native
    end

    subgraph SearcherTEE["Searcher context inside TOOL"]
      direction TB
      SearcherView["Allowed commitment view"]
      SearcherRuntime["Searcher / solver logic"]
      SearcherBundle["Native TOOL bundle<br/>source commitments + searcher txs"]
      SearcherView -->|"evaluate opportunities"| SearcherRuntime
      SearcherRuntime -->|"build and submit"| SearcherBundle
    end

    Commitments -->|"stream allowed commitments"| SearcherView
    SearcherBundle -->|"tool_simulateBundle / tool_sendBundle"| Routing
  end

  subgraph Delivery["Delivery contexts"]
    direction TB
    Callback["Callback service<br/>optional same-origin return path"]
    Relay["MEV-Boost relay path"]
    Validator["Validator"]
    Relay -->|"block proposal path"| Validator
  end

  SourceClients -->|"submit private txs / bundles"| Intake
  SourceAuth -.->|"authenticate source identity"| Routing
  Verifier -.->|"verify attested endpoint"| Intake
  Routing -->|"same-origin enriched bundle"| Callback
  Native -->|"payload delivery"| Relay

  style Sources fill:#f8fafc,stroke:#64748b,stroke-width:2px
  style ToolNetwork fill:#edf7f5,stroke:#0f8b6f,stroke-width:2px
  style ToolTEE fill:#eef2ff,stroke:#315fbe,stroke-width:2px
  style SearcherTEE fill:#fff7ed,stroke:#a56812,stroke-width:2px
  style Delivery fill:#fff1f2,stroke:#b03a5b,stroke-width:2px

API Orientation¶

Different roles use different parts of the API surface. This overview names the relevant surfaces so each role can find the right integration path; Reference is the source of truth for schemas, examples, endpoint shapes, and method-level validation behavior.

Shared Routing Rules¶

The initial external callback model is conservative:

flowchart TB
  subgraph SourceBoundary["Source / callback boundary"]
    direction TB
    Source["OFP or PBS builder"]
    Auth["Identity and callback policy"]
    CallbackEndpoint["Callback endpoint<br/>optional"]
  end

  subgraph ToolNetwork["TOOL network"]
    direction TB
    subgraph SearcherContext["Searcher context inside TOOL"]
      direction TB
      View["Allowed commitment view"]
      Strategy["Searcher logic"]
      Bundle["Native TOOL bundle"]
      View -->|"construct from allowed metadata"| Strategy
      Strategy -->|"builds on commitments"| Bundle
    end

    subgraph PolicyContext["TOOL node TEE policy context"]
      direction TB
      Store["Commitment store<br/>source, origin set, expiry"]
      Enriched["Enriched commitment<br/>source flow + searcher txs"]
      Policy["Routing policy<br/>origin and callback checks"]
      Decision{"Single callback-eligible source?"}
      CallbackPath["Callback return path"]
      NativePath["Native TOOL path"]
      Store -->|"attach origin metadata"| Enriched
      Bundle -->|"submit enriched bundle"| Enriched
      Enriched -->|"classify source set"| Policy
      Policy -->|"evaluate same-origin rule"| Decision
      Decision -->|"yes + authenticated callback"| CallbackPath
      Decision -->|"no callback or mixed private flow"| NativePath
    end

    Store -->|"publish allowed view"| View
  end

  subgraph Delivery["Delivery contexts"]
    direction TB
    CallbackDelivery["Source callback delivery"]
    RelayDelivery["MEV-Boost relay delivery"]
  end

  Source -->|"submit source orderflow"| Store
  Auth -.->|"register or verify callback settings"| Policy
  CallbackPath -->|"return source-owned private flow only"| CallbackDelivery
  CallbackDelivery -->|"deliver enriched bundle"| CallbackEndpoint
  NativePath -->|"keep commitment internal"| RelayDelivery

  style SourceBoundary fill:#f8fafc,stroke:#64748b,stroke-width:2px
  style ToolNetwork fill:#edf7f5,stroke:#0f8b6f,stroke-width:2px
  style SearcherContext fill:#fff7ed,stroke:#a56812,stroke-width:2px
  style PolicyContext fill:#eef2ff,stroke:#315fbe,stroke-width:2px
  style Delivery fill:#fff1f2,stroke:#b03a5b,stroke-width:2px

Shared Trust Model¶

Authentication and TEE verification are separate concerns.

Public Endpoints¶

Nuconstruct-hosted TOOL endpoints are available for mainnet searcher-network testing, Hoodi RPC access, and Hoodi validator relay integration.

rpc.tool.limo

https://rpc-hoodi.nuconstruct.xyz/
wss://rpc-hoodi.nuconstruct.xyz/ws

https://0xa0f46566247ceb1f259a7189d5ac8bf2f0f07c135f081b0b5a9f226ef864bf6362c74306fcd02a87b7941f6feac57dc7@relay-hoodi.nuconstruct.xyz

Onboarding¶

Technical Reference¶

Use Reference for method schemas, field definitions, and endpoint shapes. Use Technical Architecture after the relevant integration path is clear for deeper node behavior, subslots, commitment internals, peer networking, relay delivery, and low-level API nuances.