> ## 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.

# Join as a Solver

> Set up a solver service and connect to Reiy Protocol.

# Join as a Solver

To become a solver, run an HTTP service that implements the Reiy solver API, register on-chain with the required minimum <Tooltip tip="A deposit a solver keeps to stay eligible to compete.">stake</Tooltip>, and start competing for <Tooltip tip="The on-chain step where the winning solver delivers your tokens and fees are split.">settlement</Tooltip>.

## What you need

* An HTTP server exposing the solver API endpoints.
* A Sui wallet that can submit transactions.
* Stake for on-chain solver registration.
* Reliable liquidity access through inventory, venues, aggregators, or other routing logic.

## Steps

<Steps>
  <Step>
    **Understand the protocol**: read intents, solvers, Fisherman auction rounds, certificates, and solution ranking.
  </Step>

  <Step>
    **Implement the service**: expose `/quote`, `/solve`, `/settle`, and `/notify`.
  </Step>

  <Step>
    **Register on-chain**: post the required minimum stake and publish your solver address and service URL.
  </Step>

  <Step>
    **Return valid quotes and solutions**: satisfy user minimums, deadlines, epochs, and validation rules.
  </Step>

  <Step>
    **Wire settlement**: submit winning settlements on Sui with the contracts SDK or direct Sui calls.
  </Step>

  <Step>
    **Test failure paths**: invalid requests, expired deadlines, wrong epochs, and incorrect payouts should fail safely.
  </Step>
</Steps>

## Good practices

* Keep quote responses fast.
* Validate everything before submitting transactions.
* Use idempotency keys for retries.
* Log request IDs, auction IDs, certificate IDs, and transaction digests.
* Release reserved liquidity on lost, timeout, or invalid-solution notifications.

<CardGroup cols={2}>
  <Card title="Solver API" href="/reiy-protocol/reference/apis/solver-api">
    Implement the endpoint contract.
  </Card>

  <Card title="Execute settlement" href="/reiy-protocol/tutorials/solvers/execute-settlement">
    Build the winning on-chain transaction.
  </Card>
</CardGroup>


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