Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nexroute.io/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks an onboarded partner through their first submission.

​
Prerequisites

  • A dedicated Capture endpoint URL (provided by nexroute during onboarding)
  • Source IPs allowlisted on that endpoint (coordinated during onboarding; see Authentication)

​
Submit a transaction

The endpoint speaks JSON-RPC 2.0 over HTTPS and WebSocket. The only supported method is eth_sendRawTransaction; any other method returns -32601 method not found. 
curl -X POST <YOUR_CAPTURE_ENDPOINT> \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_sendRawTransaction",
    "params": ["<RAW_SIGNED_TX>"]
  }'
The single param is the hex-encoded raw signed transaction (0x-prefixed). The signature is the user’s; nexroute does not modify the payload.

​
Response

The endpoint returns a JSON-RPC envelope echoing the request id. The result field contains the transaction hash (0x-prefixed, 32 bytes). 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6b6f1c8f5d2c4a9d3e1f8b7c6a5d4e3f2c1b0a9d8e7f6a5b4c3d2e1f0a9b8c7d"
}
A non-error response confirms acceptance; nexroute is committed to delivery from this point. Use the hash to track inclusion in any block explorer.

​
Errors

Errors follow standard JSON-RPC conventions:
CodeCause
-32601Method other than eth_sendRawTransaction
-32000Malformed transaction (RLP decode failure, invalid signature)
-32603Internal error during forwarding (rare; nexroute always retries before surfacing)
A non-error response means the transaction has been accepted into the routing pipeline. Subsequent inclusion is monitored automatically.

​
Health check

A simple liveness probe is exposed at GET /health: 
curl <YOUR_CAPTURE_ENDPOINT>/health

{ "status": "ok" }
Returns HTTP 200 when the endpoint is accepting submissions. Useful for upstream load balancers and your own monitoring.

​
Next steps