Skip to main content

​
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 , and start competing for .

​
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

1
Understand the protocol: read intents, solvers, Fisherman auction rounds, certificates, and solution ranking.
2
Implement the service: expose /quote, /solve, /settle, and /notify.
3
Register on-chain: post the required minimum stake and publish your solver address and service URL.
4
Return valid quotes and solutions: satisfy user minimums, deadlines, epochs, and validation rules.
5
Wire settlement: submit winning settlements on Sui with the contracts SDK or direct Sui calls.
6
Test failure paths: invalid requests, expired deadlines, wrong epochs, and incorrect payouts should fail safely.

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

Solver API

Implement the endpoint contract.

Execute settlement

Build the winning on-chain transaction.
Last modified on June 23, 2026