Register builder

Registers a builder code for the signing account. The server calls FeeManager.registerBuilderCode(account) and stores the supplied slug/name against the assigned builder_id. Gas sponsored by API service.

fee_recipient is always the signing account — it is derived, never accepted from the client. Up to 10 builders per account; a request past that cap is rejected without sending a transaction.

Prerequisites:

  1. GET /v1/auth/nonce — one-time nonce (5 min TTL, shared with the Login flow)
  2. GET /v1/auth/eip712-domain — EIP-712 domain (name, version, chainId, verifyingContract = Authorization contract)

Typed data:

RegisterBuilder(address account,string slug,string name,uint256 nonce,uint32 deadline)

Sign as standard EIP-712 typed data (e.g. ethers signTypedData) with nonce = the hex nonce parsed as a uint256.

Signature: 64-byte EIP-2098 compact (r + yParityAndS) or 65-byte (r+s+v, auto-converted).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request to register a builder code for the signing account.
There is no fee_recipient field: the on-chain fee recipient is always the signing
account, so accepting one from the client could only ever be ignored or wrong.

Request to register a builder code for the signing account.
There is no fee_recipient field: the on-chain fee recipient is always the signing
account, so accepting one from the client could only ever be ignored or wrong.

string

Account registering the builder; must be the EIP-712 signer and an on-chain RISEx account.

string

User-facing builder code. 3-32 chars, lowercase [a-z0-9-_], no leading/trailing or
consecutive separators. The "builder-" prefix is reserved for placeholder slugs.

string

Display name, 1-50 characters.

string

One-time nonce from GET /v1/auth/nonce (hex).

int64

Unix timestamp after which the signature is rejected.

string

EIP-712 RegisterBuilder signature; 64-byte compact or 65-byte, hex-encoded.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json