πŸš€ Ropsten ETH2.0
Testing ETH2.0 Integration on Ropsten Testnet
Testing bloXroute services on Ropsten requires a free introductory plan - everyone can test the integration at no cost. Join our network and share your feedback with us!

Cloud-API Endpoints

ropsten.api.blxrbdn.com (Endpoint for sending transactions)
Location
IP Address
United States - Virginia
34.227.48.94
England - London
18.130.239.18
wss://<REGION>.ropsten.blxrbdn.com/ws (Endpoint for streaming transactions)
Location
Endpoint
United States - Virginia
wss://virginia.ropsten.blxrbdn.com/ws
England - London
wss://uk.ropsten.blxrbdn.com/ws

Go Gateway

Sample startup argument is available below. Please see Go Gateway page for more information about connecting gateway to Ethereum execution client.
docker run --name bxgateway-go -d \
-v <LOG_FILE_PATH>:/app/bloxroute/logs \
-v <SSL_CERT_PATH>:/app/bloxroute/ssl \
-p 1801:1801 -p 28333:28333 bloxroute/bloxroute-gateway-go \
--blockchain-network Ropsten \
--ws --port 1801 \
--enodes enode://<BLOCKCHAIN_NODE_PUBLIC_KEY>@<NODE_IP>:<NODE_PORT>

Sending Transactions

Sample blxr_tx request is available below. Please see Sending Transactions page for more information.
Cloud-API HTTPS Post
Cloud-API wscat WS
Gateway wscat WS
curl https://ropsten.api.blxrbdn.com \
--insecure \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
-d '{"id": "1", "method": "blxr_tx", "params": {"transaction": "f86b0184...e0b58219", "blockchain_network": "Ropsten"}}'
​
wscat -c wss://ropsten.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check
> {"jsonrpc": "2.0", "id": 1, "method": "blxr_tx", "params": {"transaction": "f86b0184...e0b58219", "blockchain_network": "Ropsten"}}
< ......
​
wscat -c ws://127.0.0.1:28333/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {"jsonrpc": "2.0", "id": 1, "method": "blxr_tx", "params": {"transaction": "f86b0184...e0b58219", "blockchain_network": "Ropsten"}}
< ......
​

Streaming Transactions

Sample newTxs streaming request is available below. Please see newTxs and pendingTxs page for more information.
Cloud-API wscat WS
Gateway wscat WS
wscat -c wss://virginia.ropsten.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check
> {"jsonrpc": "2.0", "id": 1, "method": "subscribe", "params": ["newTxs", {"include": ["tx_hash"], "blockchain_network": "Ropsten"}]}
< ......
​
wscat -c ws://127.0.0.1:28333/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {"jsonrpc": "2.0", "id": 1, "method": "subscribe", "params": ["newTxs", {"include": ["tx_hash"], "blockchain_network": "Ropsten"}]}
< ......
​

Streaming Blocks

Sample bdnBlocks streaming request is available below. Please see bdnBlocks page from more information.
Cloud-API wscat WS
Gateway wscat WS
wscat -c wss://virginia.ropsten.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check
> {"jsonrpc": "2.0", "id": 1, "method": "subscribe", "params": ["bdnBlocks", {"include": ["hash"], "blockchain_network": "Ropsten"}]}
< ......
​
wscat -c ws://127.0.0.1:28333/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {"jsonrpc": "2.0", "id": 1, "method": "subscribe", "params": ["bdnBlocks", {"include": ["hash"], "blockchain_network": "Ropsten"}]}
< ......
​

MEV Services - Bundle Submission

Please check MEV Services page for the request parameters Pre-Merge. bloXroute supports a list of additional parameters Post-Merge:
Parameter
Description
frontrunning
[Optional, default: True] A boolean flag indicating if the MEV bundle executes frontrunning strategy (e.g. generalized frontrunning, sandwiching). Some block builders and validators may not want to accept frontrunning bundles, which may experience a lower hash power.
effective_gas_price
[Optional, default: 0] An integer representing current bundle's effective gas price in wei.
coinbase_profit
[Optional, default: 0] An integer representing current bundle's coinbase profit in wei.
mev_builders
[Optional, default: bloxroute builder] A dictionary of MEV builders that should receive the bundle. For each MEV builder, a signature is required. Possible MEV builders are bloxroute , flashbots and all . For bloxroute builder and all builder, please provide empty string as signature. For flashbots builder, please provide the signature used in X-Flashbots-Signature header.
bloXroute may use frontrunning , effective_gas_price, and coinbase_profit parameters to select bundles. Searchers who submit requests with inaccurate values would be penalized. Please contact bloXroute support first before starting using the three new parameters.
Cloud-API HTTPS POST
Cloud-API wscat WS
Gateway wscat WS
curl https://ropsten.api.blxrbdn.com \
--insecure \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
-d '{
"id": "1",
"method": "blxr_submit_bundle",
"params": {
"transaction": ["ab..ab", "cd..cd"],
"block_number": "0xba10d0",
"min_timestamp": 1616511391,
"max_timestamp": 1617806320,
"reverting_hashes": ["0xd8..ce", "0x50..d3"],
"blockchain_network": "Ropsten",
"frontrunning": false,
"effective_gas_price": 30592000000,
"coinbase_profit": 192503000000000000,
"mev_builders": {
"bloxroute": "",
"flashbots": "<signature>",
"all": ""
}
}
}'
wscat -c wss://ropsten.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check
> {
"jsonrpc": "2.0",
"id": "1",
"method": "blxr_submit_bundle",
"params": {
"transaction": ["ab..ab", "cd..cd"],
"block_number": "0xba10d0",
"min_timestamp": 1616511391,
"max_timestamp": 1617806320,
"reverting_hashes": ["0xd8..ce", "0x50..d3"],
"blockchain_network": "Ropsten",
"frontrunning": false,
"effective_gas_price": 30592000000,
"coinbase_profit": 192503000000000000,
"mev_builders": {
"bloxroute": "",
"flashbots": "<signature>",
"all": ""
}
}
}
​
wscat -c ws://127.0.0.1:28333/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {
"jsonrpc": "2.0",
"id": "1",
"method": "blxr_mev_searcher",
"params": {
"mev_method": "eth_sendBundle",
"frontrunning": false,
"effective_gas_price": 30592000000,
"coinbase_profit": 192503000000000000,
"mev_builders": {
"bloxroute": "",
"flashbots": "<signature>",
"all": ""
},
"blockchain_network": "Ropsten",
"payload": [{
"txs" : ["0xf8708344c...818765aaa"],
"blockNumber" : "0xb73dcd",
"minTimestamp": 1616511391,
"maxTimestamp": 1617806320,
"revertingTxHashes": ["0xd8..ce", "0x50..d3"]
}]
}
}
​

Sending Private Transactions

Sample blxr_private_tx request is available below. This request may include the four additional parameters used in MEV bundle submission. Searchers who submit requests with inaccurate values would be penalized. Please contact bloXroute support first before starting using new parameters frontrunning , effective_gas_price, and coinbase_profit.
Please see Frontrunning Protection page for more information.
Cloud-API HTTPS Post
Cloud-API wscat WS
curl https://ropsten.api.blxrbdn.com \
--insecure \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
-d '{
"id": "1",
"method": "blxr_private_tx",
"params": {
"transaction": "f86b0184...e0b58219",
"blockchain_network": "Ropsten",
"frontrunning": false,
"effective_gas_price": 30592000000,
"coinbase_profit": 192503000000000000,
"mev_builders": {
"bloxroute": "",
"flashbots": "<signature>",
"all": ""
}
}
}'
​
wscat -c wss://ropsten.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check
> {
"jsonrpc": "2.0",
"id": 1,
"method": "blxr_private_tx",
"params": {
"transaction": "f86b0184...e0b58219",
"blockchain_network": "Ropsten",
"frontrunning": false,
"effective_gas_price": 30592000000,
"coinbase_profit": 192503000000000000,
"mev_builders": {
"bloxroute": "",
"flashbots": "<signature>",
"all": ""
}
}
}