You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/run-node/5-flare-entity.mdx
-12Lines changed: 0 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -175,15 +175,13 @@ You can proceed directly to [Fund FSP addresses](#fund-fsp-addresses).
175
175
On mainnet, or if you prefer not to use the automated script on testnets, you must manually register the required FSP addresses by interacting directly with the [`EntityManager`](/network/fsp/solidity-reference/IEntityManager) contract.
176
176
177
177
1. Ensure you have generated the following five addresses and **securely stored their private keys**. Understand their roles:
178
-
179
178
-`Identity`: The central identity address. **Crucially, keep the private key secure (e.g., cold storage on mainnet).** This address initiates proposals and signs registrations.
180
179
-`Submit`: Used for sending FTSO commit/reveal transactions.
181
180
-`SubmitSignatures`: Used for sending FTSO result signatures (often separate from `Submit` to manage transaction nonces).
182
181
-`SigningPolicy`: Used for signing FTSO data during voting and for reward epoch configurations.
183
182
-`Delegation`: Public address for receiving WNat (e.g., WFLR, WC2FLR) delegations to increase vote power and collect rewards.
184
183
185
184
2. For each address role (`Submit`, `SubmitSignatures`, `SigningPolicy`, `Delegation`), perform the two-step propose-confirm process using the `EntityManager` contract (see [FSP Reference](/network/fsp/solidity-reference)):
186
-
187
185
-**Step A (Propose):** Call the relevant `propose<Role>Address` method from your `Identity` address.
188
186
Provide the address you want to register for that role as the argument.
189
187
-**Step B (Confirm):** Call the corresponding `confirm<Role>AddressRegistration` method from the address you are actually registering (e.g., call `confirmSubmitAddressRegistration` using the `Submit` address's private key).
@@ -228,10 +226,8 @@ This key pair is used for the FTSOv2 Fast Updates protocol.
228
226
```
229
227
230
228
2. Register public key:
231
-
232
229
- If you used the **Automated Registration** script on a testnet (Method 1 above), this step is already completed, skip to [Register validator node](#register-validator-node).
233
230
- If you used **Manual Registration** (Method 2) or need to register manually:
234
-
235
231
1. Create a signature proving your `Identity` address owns the generated sortition private key. Use the `keygen` command again, providing the `PrivateKey` (from Step 1) and your `Identity` address.
236
232
237
233
```bash
@@ -375,7 +371,6 @@ The [fdc-suite-deployment](https://github.com/flare-foundation/fdc-suite-deploym
375
371
376
372
3. To configure node authentication, navigate into the specific node's directory (e.g., `nodes-mainnet/btc`) within the cloned repo and generate credentials where required.
377
373
**Keep generated credentials secure** as they will be needed for the Verifier configuration.
378
-
379
374
-**Bitcoin (BTC) / Dogecoin (DOGE):**
380
375
381
376
```bash
@@ -414,9 +409,7 @@ Configuration for the indexer and verifier services is managed centrally via the
414
409
```
415
410
416
411
Now, carefully edit the `.env` file, providing values for all variables relevant to the FDC components you are deploying. Pay close attention to:
417
-
418
412
-**RPC Node Connection Details (`*_URL`, `*_RPC_USERNAME`, `*_RPC_PASSWORD` / `*_RPC_AUTH`)**: Provide the full URL and credentials for connecting to each required blockchain node.
419
-
420
413
- If using nodes deployed via `fdc-suite-deployment` on the _same host_, you can often use `172.17.0.1` (Docker's default bridge IP) as the hostname in the URL (e.g., `http://admin:<PASSWORD>@172.17.0.1:8332/` for BTC, using the password generated earlier).
421
414
- If using _external_ nodes (your own or third-party), use their publicly accessible RPC endpoint URL and associated credentials.
422
415
@@ -625,7 +618,6 @@ With prerequisites met, registrations complete, and FDC/FTSO components configur
625
618
626
619
3. Carefully edit the `.env` file, providing the correct values gathered during the previous setup stages.
627
620
While reviewing `env.example` for _all_ possible settings is recommended (defaults may not suit all environments), ensure these key variables are correctly set based on your Registration, FDC, and FTSO setup:
628
-
629
621
-**RPC**
630
622
-`NODE_RPC_URL`: Your RPC Node or a [private RPC provider](/network/developer-tools#rpcs).
631
623
-`NODE_API_KEY` (optional): If your RPC provider requires it.
@@ -646,7 +638,6 @@ With prerequisites met, registrations complete, and FDC/FTSO components configur
646
638
647
639
This file contains **highly sensitive** private keys and API keys.
648
640
Compromise of these keys can lead to loss of funds, unauthorized actions, and a compromised entity.
649
-
650
641
- Set strict file permissions (e.g., `chmod 600 .env`) so only the owner can read/write.
651
642
- Ensure it's **never** committed to Git or any version control system.
652
643
- Limit access to the server and user account running the deployment.
@@ -660,7 +651,6 @@ With prerequisites met, registrations complete, and FDC/FTSO components configur
660
651
```
661
652
662
653
5. (Optional) By default, the `c-chain-indexer` requires 10 million blocks (≈20 days) of node history.
663
-
664
654
- To shorten this window, edit [`template-configs/c-chain-indexer.template.toml`](https://github.com/flare-foundation/flare-systems-deployment/blob/main/template-configs/c-chain-indexer.template.toml) to a value closer to the head of your node.
665
655
-**Do not** go below 350,000 blocks (≈7 days / 2 reward epochs), or the FTSO client may fail.
666
656
@@ -691,7 +681,6 @@ Once your services are up, follow these steps to confirm everything is running s
691
681
```
692
682
693
683
Ensure these key containers appear in the list and have `Up` status:
694
-
695
684
-`system-client`
696
685
-`c-chain-indexer`
697
686
-`fast-updates-client` (if enabled)
@@ -952,7 +941,6 @@ Consistent monitoring is key to maintaining performance and reward eligibility.
952
941
- Check minimal conditions status via the [Flare Systems Explorer](https://flare-systems-explorer.flare.network/providers?tab=minimalConditions) or the backend API detailed previously in the FAQ.
953
942
954
943
- Monitor the logs of your running Docker containers (`docker compose logs <service_name>`) for errors and key operational messages:
955
-
956
944
-**Registration:** Look for `RegisterVoter success` messages in the `system-client` logs around the start of reward epochs.
0 commit comments