TESTNET

🌐 Relayer API

REST endpoints, fee structure, and self-hosting guide

Endpoints
MethodEndpointDescription
POST/relay/withdrawSubmit withdrawal proof for relay
POST/relay/partialSubmit partial withdrawal
POST/relay/transferSubmit shielded transfer
GET/statusRelayer health, balance, and queue
GET/feesCurrent fee schedule per pool
GET/root/:poolLatest Merkle root for pool
Fee Structure
0.01 ETH
5%
Net: 0.0095 ETH
0.1 ETH
3%
Net: 0.097 ETH
1 ETH
3%
Net: 0.97 ETH
10 ETH
2%
Net: 9.8 ETH
Anti-frontrunning: Withdrawal proofs include a relayer binding hash: H(relayer_address, fee). This prevents relayers from modifying the fee or front-running the TX.
Self-Host a Relayer
git clone https://github.com/zkxgenai/zksentinel-relayer # coming soon cd zksentinel-relayer cp .env.example .env # Set PRIVATE_KEY, RPC_URL, FEE_PERCENT docker-compose up -d # Relayer runs on port 3000, auto-registers with ASP