RIrise
Orders

Register builder

Changed on

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

post/v1/builders

Request

Request body

accountstring

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

slugstring

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.

namestring

Display name, 1-50 characters.

noncestring

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

deadlineinteger

Unix timestamp after which the signature is rejected.

signaturestring

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

Response

A successful response.

builder_idinteger

Builder ID assigned on-chain by FeeManager.registerBuilderCode().

slugstring
namestring
tx_hashstring
block_numberstring uint64

Changes