Approve builder fee

Approve a builder's maximum per-order fee ceiling. User signs the approval off-chain; server submits via Router.approveBuilderFee(). Gas sponsored by API service.

Set max_fee_bps=0 to revoke a previously granted approval.

Permit: Client signs an EIP-712 VerifyWitness permit; the server recovers the signer off-chain and matches it to permit.signer (server holds no keys).

Prerequisites:

  1. GET /v1/auth/eip712-domain — EIP-712 domain (name, version, chainId, verifyingContract = Authorization contract)
  2. GET /v1/nonce-state/{account}nonce_anchor and current_bitmap_index (pass it as permit.nonce_bitmap_index; if 208 the anchor is full — use nonce_anchor+1 with bitmap index 0)
  3. GET /v1/system/configrouter address (RISExUniversalRouter), used as the target field below

Action hash:

actionHash = keccak256(abi.encode(
  keccak256("RISE_APPROVE_BUILDER_FEE_V1"),  // bytes32 action selector
  uint16(builder_id),
  uint16(max_fee_bps)))

Permit digest (EIP-712):

VerifyWitness(address account,address target,bytes32 hash,uint48 nonceAnchor,uint8 nonceBitmap,uint32 deadline)

Sign as standard EIP-712 typed data (e.g. ethers signTypedData) with hash = actionHash, target = RISExUniversalRouter address (NOT the account, NOT the domain verifyingContract), nonceBitmap = permit.nonce_bitmap_index.

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 approve a builder's max per-order fee ceiling.
The signature binding builder_id + max_fee_bps lives in permit.signature (the permit's
action hash already covers both values) — there is no separate signer/signature pair.

Request to approve a builder's max per-order fee ceiling.
The signature binding builder_id + max_fee_bps lives in permit.signature (the permit's
action hash already covers both values) — there is no separate signer/signature pair.

int64

Builder ID (uint16)

int64

Max builder fee in parts per million (denominator 1e6, uint16). 100 = 1 bps. 0 = revoke.

permit
object

Permit parameters for v3 authenticated operations.
Client signs EIP-712 VerifyWitness; server builds byte-packed permit suffix.
Uses bitmap nonces for replay protection.

Responses

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