Skip to content

What Signal does ​

Signal is the gateway beside your beacon node. It receives blocks from the Optimum mesh and hands them to your consensus client, so your validators receive blocks sooner. That is what improves attestation performance.

When Signal is not on your sidebar ​

Signal is switched on by Optimum. Until it is, the sidebar has no Signal entry: the screens below are not reachable, /dashboard/operators/<your-id>/signal returns you to your organisation's home, and Verify the connection answers This check is not available right now.

That switch covers every account. It is not a fault in yours, and no URL gets around it. Ask support. Everything on these pages describes the screens as they appear once Signal is on.

Once a gateway is enrolled, Signal opens on a home. The line under the heading is Your validators receive blocks sooner, which improves attestation performance. A gateway you run joins Optimum's mesh, which often carries a block before public gossip reaches you. The banner says Signal is active when a gateway was seen recently, and it counts gateways online and indices assigned. Under it, four cards: Blocks received earlier, Attestation accuracy, Gateways online (seen in the last ten minutes), and Indices assigned. Set up another gateway starts the connect steps. Gateways & keys is where you mint enrollment keys and consumer tokens.

Signal home. Signal is active, with the four cards, Set up another gateway, and Gateways & keys.

The pill on that home is Active when a gateway was seen recently, Idle when none was, and Unknown when the status could not be read. View gains opens the attestation report once weekly reports are running.

An account that does not run validators does not get those four cards. The banner counts gateways online, and the only card is Gateways online. Block timing and attestation accuracy are measured against that account's own validators, so they are not on this home.

Connect ​

Set up another gateway uses these steps. Invited accounts connect their first gateway in onboarding, under Connect your first gateway, with the same commands.

StepOn the screenWhat you do
1 Connect1a Name the gateway. 1b Start the gateway. 1c Point your client at the gateway. 1d Verify the connection.Name it, start the container, peer the client, then check it.
2 Register keysValidator indicesOpen Activate validators and submit indices.
3 MeasureWeekly gainsThe home, once a gateway is connected and enough indices are on record.

1a asks for a Gateway name. It has to be unique in your organization. Console suggests one numbered after the gateways you already have. That name is what the command writes as OPT_GATEWAY_ID. A name already in use is refused on any other host. Use the existing name only on that gateway's own host, to update it. A gateway that has already enrolled keeps the name stored with its credential, under $HOME/optimum-gateway/mump2p.

1b asks Where does this gateway send data? My consensus client is the gateway beside a beacon node. A feed for my consumers is the stream-only gateway, with no consensus client. An account that does not run validators starts on A feed for my consumers. Copy the command for the mode you picked. The stream-only command is what A feed for my consumers generates.

A feed gateway measures no validators, so its steps are 1 Connect and 2 Measure. Its connect steps are 1a Name the gateway, 1b Start the gateway, and 1c Verify the connection.

The pill while you are on these steps is the check: Not checked, Checking, Connected, Not connected, Unknown, or Check failed.

1d is the check to trust. It reads what Optimum sees from outside your host. The curl /health command on that step answers one thing the check cannot: whether your consensus client is peered. Its first word is often degraded until that is done. See When the check fails.

Why enrollment keys ​

A gateway does not need a secret of its own handed to it. You give every host the same enrollment key (OPT_JOIN_KEY, ojk_…). On first start, each gateway creates its own keypair, enrols with Optimum, and keeps the credential it gets back in $HOME/optimum-gateway/mump2p. From then on it uses that credential, not the enrollment key.

That is what makes a fleet manageable:

  • One key for many hosts. Each host gets its own name in 1a, and that name is in the command, so you change 1a before you copy the command for the next host. A repeat of a name is refused with HTTP 409.
  • Nothing to rotate on the hosts. The key only lets new gateways in. When it expires or you revoke it, gateways that already enrolled keep running.
  • A short window if it leaks. The key's lifetime is how long a copied command can still add gateways to your organisation.
  • The network and cluster come from the key. A gateway cannot pick its own.

Each key admits up to 1,000 gateways, and your organisation is capped at 1,000 live gateway credentials. A gateway that keeps its credential across restarts spends nothing. Losing the identity directory spends another enrollment.

Which key lifetime ​

Where you get itLastsUse it for
Onboarding, Connect your first gateway14 daysAn invited account's first gateway, when the person onboarding is not the person on the host.
Signal, Create an enrollment key that lasts a day1 dayA command you are about to paste. It goes straight into the command.
Gateways & keys → Enrollment keys, Generate enrollment keyYou choose in Valid for (days), up to 365A rollout across many hosts or over several weeks.

Every key is shown once. Export it as OPT_JOIN_KEY before running the command, unless Console already put it in. The key list shows enrollments used and the expiry date.

Revoking an enrollment key stops new gateways only. To cut off one gateway that already enrolled, revoke that gateway's own key under Gateways & keys → Gateway. Self-serve accounts do not have that tab; ask support.

Next: Network, then Connect your gateway.