HTTP API
Relayer HTTP API
The relayer provides a comprehensive HTTP API for inspecting database contents and managing operations. Each endpoint below includes an interactive playground where you can test the API directly.
Update this to match your relayer’s actual endpoint when deployed.
Make sure to update the server URL to match your relayer instance before testing endpoints.
API Endpoints
The following endpoints are available for interacting with the relayer:Messages API
- Get Messages - Query messages by domain and nonce range in the database
- Insert Messages - Add new messages to the database
Operation Management
- List Operations - View pending messages in operation queues
- Retry Messages - Trigger retry of failed messages
Data Inspection
- Get Merkle Tree Insertions - Query merkle tree insertion in the database
- Insert Merkle Tree Insertions - Insert merkle tree insertion
IGP Management
- List IGP Rules - View current gas payment rules
- Add IGP Rule - Create new gas payment rules
- Remove IGP Rules - Delete existing gas payment rules
IGP endpoints are only available when gas enforcers are configured (
mod.rs:82-83).