From b215bff0c231affad2144c95294c688522bb5841 Mon Sep 17 00:00:00 2001 From: cheny0 <67916832+cheny0@users.noreply.github.com> Date: Tue, 19 May 2026 16:11:39 +0800 Subject: [PATCH 1/6] Ready for review --- .../start-a-logos-blockchain-node-via-ui.md | 120 ++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 docs/blockchain/start-a-logos-blockchain-node-via-ui.md diff --git a/docs/blockchain/start-a-logos-blockchain-node-via-ui.md b/docs/blockchain/start-a-logos-blockchain-node-via-ui.md new file mode 100644 index 0000000..3433378 --- /dev/null +++ b/docs/blockchain/start-a-logos-blockchain-node-via-ui.md @@ -0,0 +1,120 @@ +--- +title: Start a Logos blockchain node via the app UI +doc_type: procedure +product: blockchain +topics: blockchain +steps_layout: sectioned +authors: cheny0 +owner: logos +doc_version: 1 +slug: start-a-logos-blockchain-node-via-ui +--- + +# Start a Logos blockchain node via the app UI + +#### Run a node that participates in consensus via a graphical interface. + +> [!NOTE] +> +> - **Permissions**: Node operator +> - **Product**: Logos Blockchain testnet v0.1 + +The Logos Blockchain is the blockchain module of the Logos technology stack, providing a privacy-preserving and censorship-resistant framework for decentralized network states. You can run a Logos Blochain node [using the CLI](./run-a-logos-blockchain-node-on-public-testnet-from-cli.md) or the graphical interface. + +> [!NOTE] +> +> For testnet v0.1, you must manually edit the config file and restart the node to add new keys. + +Before you start, make sure you have the following: + +- A supported OS: Linux x86_64 or macOS +- [Nix](https://github.com/NixOS/nix-installer) installed with flakes enabled. + +## What to expect + +- You have a Logos blockchain node running and connected to peers. +- Your wallet holds testnet funds requested from the faucet. +- Your node is eligible to participate in the consensus lottery after the UTXO ages for approximately two hours. + +## Step 1: Run the Logos Core App + +1. Clone the repository: + + ```sh + git clone https://github.com/logos-blockchain/logos-blockchain-ui.git + cd logos-blockchain-ui + ``` + +1. Build the standalone app: + + ```sh + nix build '.#app' + ``` + + - If flakes are not enabled globally, run `nix build --extra-experimental-features 'nix-command flakes' '.#app'` instead. + +1. Run the app: + + ```sh + ./result/bin/logos-blockchain-ui-app + ``` + +## Step 2: Generate and load a node config + +1. In the app, click **Generate Config**. + +1. In the [Logos blockchain release notes](https://github.com/logos-blockchain/logos-blockchain/releases), search for "testnet bootstrap peers" and copy the initial trusted peer set. + +1. In the app, paste the peer set information in the **Initial peers** and click **Generate Config** on the bottom. + +1. Click **Load Config** and select the generated config file. + +1. Click **Start Node**. A green indicator shows the node is running, and the wallet appears with a balance of `0`. + +## Step 3: Request testnet funds from the faucet + +1. From the wallet section of the UI, copy one of your keys. + +1. Go to the [devnet faucet](https://devnet.blockchain.logos.co/node/0/faucet), paste your key, and click **Request Funds**. + + > **Note:** + > + > The transaction can take up to a minute to confirm and appear in your wallet. + +## Step 4: Verify the node is healthy + +1. Check that the blockchain height is increasing: + + ```sh + curl localhost:8080/cryptarchia/info + ``` + + Example response: + + ```json + {"lib":"3d0c...4e6d","tip":"f44d...e2f5","slot":70899,"height":120,"mode":"Bootstrapping"} + ``` + + Expect `height` to increase at an average rate of one block every 10 seconds. The timing is probabilistic, so some variance is normal. + +1. Check that the node is connected to peers: + + ```sh + curl localhost:8080/network/info + ``` + + Example response: + + ```json + {"listen_addresses":["/ip4/127.0.0.1/udp/3001/quic-v1"],"peer_id":"12D3...fuS2","n_peers":16,"n_connections":19,"n_pending_connections":0} + ``` + + Confirm that `n_peers` is greater than `0`. + +Once the node is funded and the UTXO has aged for approximately two hours, the node automatically participates in the consensus lottery and starts producing blocks. + +## Troubleshooting starting a node + +### The wallet balance does not update after a faucet request + +Only one faucet transaction can be included per block, so transactions may be dropped during periods of high demand. Retry the request from the faucet. From 794034f9e90202375535bc9369a753739546627a Mon Sep 17 00:00:00 2001 From: cheny0 <67916832+cheny0@users.noreply.github.com> Date: Tue, 19 May 2026 17:50:23 +0800 Subject: [PATCH 2/6] Update --- .../start-a-logos-blockchain-node-via-ui.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/blockchain/start-a-logos-blockchain-node-via-ui.md b/docs/blockchain/start-a-logos-blockchain-node-via-ui.md index 3433378..22ec7ac 100644 --- a/docs/blockchain/start-a-logos-blockchain-node-via-ui.md +++ b/docs/blockchain/start-a-logos-blockchain-node-via-ui.md @@ -1,16 +1,16 @@ --- -title: Start a Logos blockchain node via the app UI +title: Start a Logos Blockchain node via the app UI doc_type: procedure product: blockchain topics: blockchain steps_layout: sectioned -authors: cheny0 +authors: davidrusu, cheny0 owner: logos doc_version: 1 slug: start-a-logos-blockchain-node-via-ui --- -# Start a Logos blockchain node via the app UI +# Start a Logos Blockchain node via the app UI #### Run a node that participates in consensus via a graphical interface. @@ -19,7 +19,7 @@ slug: start-a-logos-blockchain-node-via-ui > - **Permissions**: Node operator > - **Product**: Logos Blockchain testnet v0.1 -The Logos Blockchain is the blockchain module of the Logos technology stack, providing a privacy-preserving and censorship-resistant framework for decentralized network states. You can run a Logos Blochain node [using the CLI](./run-a-logos-blockchain-node-on-public-testnet-from-cli.md) or the graphical interface. +The Logos Blockchain is the blockchain module of the Logos technology stack, providing a privacy-preserving and censorship-resistant framework for decentralized network states. You can run a Logos Blockchain node [using the CLI](./run-a-logos-blockchain-node-on-public-testnet-from-cli.md) or the graphical interface. > [!NOTE] > @@ -32,11 +32,11 @@ Before you start, make sure you have the following: ## What to expect -- You have a Logos blockchain node running and connected to peers. +- You have a Logos Blockchain node running and connected to peers. - Your wallet holds testnet funds requested from the faucet. - Your node is eligible to participate in the consensus lottery after the UTXO ages for approximately two hours. -## Step 1: Run the Logos Core App +## Step 1: Run the Logos Blockchain app 1. Clone the repository: @@ -63,7 +63,7 @@ Before you start, make sure you have the following: 1. In the app, click **Generate Config**. -1. In the [Logos blockchain release notes](https://github.com/logos-blockchain/logos-blockchain/releases), search for "testnet bootstrap peers" and copy the initial trusted peer set. +1. In the [Logos Blockchain release notes](https://github.com/logos-blockchain/logos-blockchain/releases), search for "testnet bootstrap peers" and copy the initial trusted peer set. 1. In the app, paste the peer set information in the **Initial peers** and click **Generate Config** on the bottom. From f77b53663996dce4ef00318eee23ed3a3b2b3bef Mon Sep 17 00:00:00 2001 From: cheny0 <67916832+cheny0@users.noreply.github.com> Date: Tue, 19 May 2026 17:52:28 +0800 Subject: [PATCH 3/6] Update --- ...ia-ui.md => start-a-logos-blockchain-node-via-the-app-ui.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename docs/blockchain/{start-a-logos-blockchain-node-via-ui.md => start-a-logos-blockchain-node-via-the-app-ui.md} (98%) diff --git a/docs/blockchain/start-a-logos-blockchain-node-via-ui.md b/docs/blockchain/start-a-logos-blockchain-node-via-the-app-ui.md similarity index 98% rename from docs/blockchain/start-a-logos-blockchain-node-via-ui.md rename to docs/blockchain/start-a-logos-blockchain-node-via-the-app-ui.md index 22ec7ac..db8aaf3 100644 --- a/docs/blockchain/start-a-logos-blockchain-node-via-ui.md +++ b/docs/blockchain/start-a-logos-blockchain-node-via-the-app-ui.md @@ -7,7 +7,7 @@ steps_layout: sectioned authors: davidrusu, cheny0 owner: logos doc_version: 1 -slug: start-a-logos-blockchain-node-via-ui +slug: start-a-logos-blockchain-node-via-the-app-ui --- # Start a Logos Blockchain node via the app UI From eaedebf7fc8cfbf78a12e420fcb2fd6739646620 Mon Sep 17 00:00:00 2001 From: kashepavadan Date: Thu, 4 Jun 2026 17:21:19 -0400 Subject: [PATCH 4/6] moved file to reflect new structure --- .../start-a-logos-blockchain-node-via-the-app-ui.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/blockchain/{ => get-started}/start-a-logos-blockchain-node-via-the-app-ui.md (100%) diff --git a/docs/blockchain/start-a-logos-blockchain-node-via-the-app-ui.md b/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md similarity index 100% rename from docs/blockchain/start-a-logos-blockchain-node-via-the-app-ui.md rename to docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md From 51baaaa9793b08284a12c85bce3dfcea66d8a719 Mon Sep 17 00:00:00 2001 From: kashepavadan Date: Mon, 15 Jun 2026 16:18:00 -0400 Subject: [PATCH 5/6] fix summary and callouts --- docs/blockchain/SUMMARY.md | 1 + .../start-a-logos-blockchain-node-via-the-app-ui.md | 13 +++++-------- 2 files changed, 6 insertions(+), 8 deletions(-) diff --git a/docs/blockchain/SUMMARY.md b/docs/blockchain/SUMMARY.md index 7176feb..620e6a0 100644 --- a/docs/blockchain/SUMMARY.md +++ b/docs/blockchain/SUMMARY.md @@ -4,6 +4,7 @@ ## Get started +- [Start a Logos Blockchain node via the app UI](./get-started/start-a-logos-blockchain-node-via-the-app-ui.md) - [Run a Logos Blockchain node on the public testnet from the CLI](get-started/run-a-logos-blockchain-node-from-cli.md) - [Introduction to the Logos Blockchain](get-started/introduction-to-the-logos-blockchain.md) diff --git a/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md b/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md index db8aaf3..387d25c 100644 --- a/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md +++ b/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md @@ -14,16 +14,13 @@ slug: start-a-logos-blockchain-node-via-the-app-ui #### Run a node that participates in consensus via a graphical interface. -> [!NOTE] -> -> - **Permissions**: Node operator -> - **Product**: Logos Blockchain testnet v0.1 - The Logos Blockchain is the blockchain module of the Logos technology stack, providing a privacy-preserving and censorship-resistant framework for decentralized network states. You can run a Logos Blockchain node [using the CLI](./run-a-logos-blockchain-node-on-public-testnet-from-cli.md) or the graphical interface. -> [!NOTE] -> -> For testnet v0.1, you must manually edit the config file and restart the node to add new keys. +{% hint style="info" %} + +For testnet v0.1, you must manually edit the config file and restart the node to add new keys. + +{% endhint %} Before you start, make sure you have the following: From a1988828c1e53503d3f295d406aac1a09cdf0487 Mon Sep 17 00:00:00 2001 From: kashepavadan Date: Tue, 16 Jun 2026 11:23:54 -0400 Subject: [PATCH 6/6] review fixes --- .../start-a-logos-blockchain-node-via-the-app-ui.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md b/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md index 387d25c..fa8b91a 100644 --- a/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md +++ b/docs/blockchain/get-started/start-a-logos-blockchain-node-via-the-app-ui.md @@ -29,9 +29,11 @@ Before you start, make sure you have the following: ## What to expect -- You have a Logos Blockchain node running and connected to peers. -- Your wallet holds testnet funds requested from the faucet. -- Your node is eligible to participate in the consensus lottery after the UTXO ages for approximately two hours. +By the end of this tutorial: + +- You will have a Logos Blockchain node running and connected to peers. +- Your wallet will hold testnet funds requested from the faucet. +- Your node will be eligible to participate in the consensus lottery after the UTXO ages for approximately two hours. ## Step 1: Run the Logos Blockchain app