Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

approvedBuilders

Lists the builders a user has approved with approveBuilderFee, with the fee cap and timestamps of each approval. By default only ACTIVE approvals are returned; pass status: "REVOKED" or "ALL" to include revoked ones.

POST/infotype approvedBuilders

List every builder a user has approved and its fee cap (e.g. a builder-approval settings page).

Not this?
Request body
typestringrequired

Must be `approvedBuilders`.

"approvedBuilders"
userstring · addressrequired

Account that granted the approvals.

statusstringoptional

Filter by approval status. Case-insensitive. Defaults to `ACTIVE`.

"ACTIVE""REVOKED""ALL"
Request example
curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "type": "approvedBuilders",
  "user": "0x95761f4d19B906B3B09da3EeE0BF30B337f4dB88"
}'
Try it
POST https://rpc.txflow-testnet.xyz/info
Response 200
codeinteger

`0` on success.

dataobject
approvalsobject[]

One row per approved builder.

limitinteger

Maximum number of builders the user may keep approved at once.

totalinteger

Number of rows in `approvals`.

successboolean

`false` on error, with `code` set and the text in `message` instead of `data`.

Response example
{
  "success": true,
  "code": 0,
  "data": {
    "approvals": [
      {
        "builder": "0x2e4d75df2ee2653ea7a113cc1fa36d45e923061f",
        "maxFeeRate": 10,
        "status": "ACTIVE",
        "approvedAt": 1792575363976,
        "updatedAt": 1792575363976
      }
    ],
    "total": 1,
    "limit": 20
  }
}

maxFeeRate is an integer in tenths of a basis point: 10 is 0.01%, 50 is 0.05%. This is the same cap the user signed as a percentage string in approveBuilderFee.

limit is the number of builders the user may keep approved at once; compare it with total before asking the user to approve another builder.

Next steps