[Journey] Join the Blend Network with your headless node

[kashepavadan]

What the user achieves

Blockchain node has joined Blend

Why it matters

Allows node to contribute to proposer privacy & receive rewards

Key components

n/a

Repository

logos-blockchain/logos-blockchain

Runtime target

testnet v0.2

Prerequisites

• running blockchain node
• making sure the the address used is publicly reachable

Commands and expected outputs

If you want to join as Blend core node, make sure you have a publicly reachable IP+Port combination, then follow these steps

1. Start the node and wait that it switches to "Online" mode (approx 1h)
2. Give money to the pk specified in `sdp.wallet.funding_pk`, via the faucet
3. Give money to the pk specified in `blend.core.zk.secret_key_kms_id`, via the faucet
4. Call the `/wallet/<pk>/balance` endpoint using the key at point 3 as `<pk>`
5. Get any of the notes returned by the endpoint
6. Dispatch a `POST` to `/blend/join` specifying the following payload `{"locator": <multiaddr>, "locked_note_id": <node_id>}` where `<multiaddr>`  is a publicly reachable multiaddress for the node (can be IP or DNS) and `<locked_note_id>` is the note retrieved at step 4
7. Verify the declaration was submitted by calling `/mantle/sdp/declarations`, retrying a few times until the tx is included in a block. When in a block, the active epoch should be two epochs in the future, as that's when it will become active

Success command

/mantle/sdp/declarations

Expected result

tx included in block

Configuration details

Failure modes and limits

No response

GitHub handle

@ntn-x2

Discord handle

@ntn-x2

Existing docs or specs

No response

Hardware requirements

No response

Estimated time to complete

No response

Security notes

No response