> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reiy.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Fisherman

> The off-chain Execution Coordinator that orchestrates solver competition and signs settlement certificates.

# Fisherman

Fisherman is Reiy's Execution Coordinator. It is the off-chain service that turns a stream of on-chain <Tooltip tip="An on-chain order that escrows your sell tokens and records your terms.">intents</Tooltip> into competitive, settleable <Tooltip tip="A solver's proposed fills and payouts for a round, plus a score.">solutions</Tooltip>. It is the orchestration brain of the protocol, but it holds no funds and cannot override on-chain protections.

## What Fisherman does

Fisherman owns everything between intent submission and on-chain <Tooltip tip="The on-chain step where the winning solver delivers your tokens and fees are split.">settlement</Tooltip>:

* Reads on-chain intents and exposes them through an orderbook.
* Groups compatible open intents into <Tooltip tip="A batch of compatible open intents that solvers compete over.">auction rounds</Tooltip>.
* Asks registered <Tooltip tip="Execution providers that compete to fill intents and settle on-chain.">solvers</Tooltip> to quote and to solve each round, within bounded time windows.
* Validates every solver response: fills, floors, token pair, epoch, and expiry.
* Ranks valid solutions by <Tooltip tip="The number Fisherman ranks solutions by; the highest valid score wins.">score</Tooltip> and picks the winner.
* Signs a settlement <Tooltip tip="The signed authorization that lets the winning solver settle on-chain.">certificate</Tooltip> for the winner and hands off settlement.
* Reissues a certificate if the winner fails to settle before it expires.

## What Fisherman does not do

* It does not hold user funds. Escrow lives in the contracts.
* It does not build solver routes. Solvers source their own liquidity.
* It has no on-chain authority. Its signature only lets one solver attempt settlement, and the contracts still enforce every user protection independently.

## Round and certificate state

Fisherman tracks the lifecycle of each round and certificate. A round moves from collecting intents, to solving, to a chosen winner, to settling, to settled, with separate states for deadline misses and retries.

## Why a coordinator instead of an on-chain auction

Running quote collection, batching, and ranking off-chain keeps the on-chain surface small and cheap: the contracts only verify a signature and enforce floors. Windows, batch sizes, and retry policy can be tuned without redeploying contracts, while custody and user safety stay fully on-chain.

<CardGroup cols={2}>
  <Card title="Auction rounds and certificates" href="/reiy-protocol/concepts/how-it-works/auction-rounds-and-certificates">
    See how a round becomes signed settlement authority.
  </Card>

  <Card title="Fisherman API" href="/reiy-protocol/reference/apis/solver-api">
    The live coordinator API and OpenAPI spec.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.