connection guide

as a proposer connecting itself is easy. you'll need one of the popular beacon side-cars that enable higher paying blocks to be sourced from specialized block builders.

commonly used are:

• mev-boost - https://github.com/flashbots/mev-boost

• vouch - https://github.com/attestantio/vouch

• commit-boost - https://www.commit-boost.org/

each provides own docs for how to configure. each will at one point instruct to add URLs of the relays you'd like to source blocks from. this is where you may add us.

when selecting a URL to choices are required.

1. which network is the proposer on?

2. does this proposer require every block offered has been filtered for OFAC transactions. for details on how we handle OFAC see here: ofac.

# hoodi - unfiltered
https://0xb1559beef7b5ba3127485bbbb090362d[e-mail]

# hoodi - filtered
https://0xb1559beef7b5ba3127485bbbb090362d[e-mail]

# mainnet - unfiltered
https://0xa1559ace749633b997cb3fdacffb890a[e-mail]

# mainnet - filtered
https://0xa1559ace749633b997cb3fdacffb890a[e-mail]

faq

should i add filtered vs non-filtered?

several parties, usually US staking operators, have asked us to, in their slots, only accept blocks from builders which have been filtered for transactions containing addresses on the US OFAC sanctions list. what violation or compliance look like for you we cannot help you with. this is not legal advice. if you require filtering, the filtered URL is available.

is there a benefit to adding both filtered and non-filtered URLs?

no, please don't. the URL is treated as a stated preference. a config value if you will. your block building sidecar will periodically send a registration to our relay. adding both URLs means we see the same proposer pubkey requesting both, conflicting, preferences. as we cannot follow both, our relay will assume unfiltered was the intended preference.

how many relays should i add, i see there are a handful available?

this is ultimately up to the operator. we'll offer our highest bid for a given slot and they'll offer theirs. your sidecar will automatically select the highest. we recommend adding several so we are forced to offer our best bids. several public dashboards exist like relayscan.io or rated.network to show how many slots different relays have the highest bid.

the sidecar i'm setting up offers options to configure timeouts to improve bid value, what is a good value to set?

this is a complicated topic. our relay does a lot of clever stuff to try and work with whatever value you set. offering the highest bid possible within your deadline, without missing any slots. if you're eager to find the best possible values and get the highest possible bids, we don't have a comprehensive guide at the moment. come talk to us: https://t.me/ultrasoundrelay.

why the long pubkey in the URL?

your client will use this information to verify any bids it receives are signed with that pubkey, i.e. came from the same party that wrote these docs.

i have a different question

https://t.me/ultrasoundrelay