Sign in

v1

latestOpenAPI 3.0.02026-07-22134640.3 KB
Solver Registration

Register Solver

Register a new solver. Solvers provide quotes and execute intents on behalf of users. This endpoint requires authentication via request signature headers.

post/api/v1/solverRegistry/registerSolver

Headers

x-beam-sigstring

Request signature header

x-beam-sig-expirestring

Request signature expiry header

x-beam-sig-addressstring

Request signature address header

Request body

intentExecutionTypesstring[] required

Array of intent execution types that this solver supports

supportsNativeTransfersboolean

Whether the solver supports native token transfers (ETH, MATIC, etc.) without wrapping

quotesUrlstring required

V1 endpoint URL for retrieving quotes from the solver

reverseQuotesUrlstring

V1 endpoint URL for retrieving reverse quotes (specify output, get input quotes)

quotesV2Urlstring

V2 endpoint URL for retrieving quotes from the solver with enhanced parameters

reverseQuotesV2Urlstring

V2 endpoint URL for retrieving reverse quotes with enhanced parameters

receiveSignedIntentUrlstring required

V1 endpoint URL where the solver receives signed intents for execution

receiveSignedIntentV2Urlstring

V2 endpoint URL where the solver receives signed intents with enhanced parameters

gaslessIntentTransactionDataUrlstring

Endpoint URL for retrieving transaction data for gasless intent execution

useSolverDataFormatboolean

Whether to use solver-specific data format (true) or generic format (false)

Example request

{
  "intentExecutionTypes": [
    "SELF_PUBLISH",
    "GASLESS"
  ],
  "supportsNativeTransfers": true,
  "quotesUrl": "https://solver.example.com/api/v1/quotes",
  "reverseQuotesUrl": "https://solver.example.com/api/v1/quotes/reverse",
  "quotesV2Url": "https://solver.example.com/api/v2/quotes",
  "reverseQuotesV2Url": "https://solver.example.com/api/v2/quotes/reverse",
  "receiveSignedIntentUrl": "https://solver.example.com/api/v1/intents",
  "receiveSignedIntentV2Url": "https://solver.example.com/api/v2/intents",
  "gaslessIntentTransactionDataUrl": "https://solver.example.com/api/v1/gasless/transaction-data",
  "useSolverDataFormat": true
}

Response

Solver successfully registered

EcoAPIResponse required