docs: update introduction and add "Running Own Node" section and "Core Concepts" page (#8)

* chore: create "Running Own Node" section in sidebar

* docs: move core conceps to a separate page and improve introduction

Author: yoxira

.vitepress/config.mts

@@ -29,9 +29,15 @@ export default defineConfig({
         text: 'Getting Started',
         items: [
           { text: 'Introduction', link: '/' },
-          { text: 'Installation', link: '/installation' },
-          { text: 'Configuration', link: '/configuration' },
-          { text: 'Testnet', link: '/testnet' },
+          { text: 'Core Concepts', link: '/core-concepts' },
+        ],
+      },
+      {
+        text: 'Running Own Node',
+        items: [
+          { text: 'Installation', link: '/own-node/installation' },
+          { text: 'Configuration', link: '/own-node/configuration' },
+          { text: 'Testnet', link: '/own-node/testnet' },
         ],
       },
       {

api/websocket.md

@@ -18,7 +18,7 @@ To maintain reliability, use WebSocket for real-time updates and REST API to per
 
 ## Enabling WebSocket
 
-To enable WebSocket on a node, enable it in the [configuration file](/configuration.md#websocket-client-configuration):
+To enable WebSocket on a node, enable it in the [configuration file](/own-node/configuration.md#websocket-client-configuration):
 
 ```json
 {

core-concepts.md

@@ -0,0 +1,44 @@
+# Core Concepts
+
+Basic concepts of the ADAMANT blockchain you need to know if you're interacting with the blockchain or just running a node.
+
+## Native Token
+
+**ADM** is the native token of the ADAMANT blockchain. It’s used to pay transaction fees and can be transferred between accounts. For consistency and precision, ADM amounts and **fees** are stored as strings in transactions and measured in 1/10<sup>8</sup> ADM (1 ADM = 100,000,000).
+
+## Transaction Fees
+
+Every transaction in ADAMANT requires a fee, paid in ADM. Fees help prevent spam and support the network. Fees are intentionally very low, making ADAMANT affordable for active messaging.
+
+Most transaction types have a fixed fee, but **Message** and **Key-Value Store** (KVS) transaction fees scale with content length.
+
+You can get blockchain fees using the [`/api/blocks/getFees`](/api-endpoints/blockchain.md#get-blockchain-fees) API endpoint.
+
+## Timestamps
+
+A **timestamp** in ADAMANT shows how many seconds have passed since the creation of the blockchain — the **blockchain epoch**, set at September 2, 2017, 17:00:00 GMT+0.
+
+For example, to convert time to ADAMANT's timestamp using TypeScript:
+
+```ts
+const EPOCH = Date.UTC(2017, 8, 2, 17, 0, 0, 0);
+
+/**
+ * Converts provided timestamp into ADAMANT's epoch timestamp
+ * @param time - timestamp in ms
+ */
+const getEpochTime = (time: number = Date.now()) =>
+  Math.floor((time - EPOCH) / 1000);
+```
+
+You can get blockchain's epoch time using [`/blocks/getEpochTime`](/api-endpoints/blockchain.md#get-blockchain-epoch) endpoint. Additionally, consider using [`/blocks/getStatus`](/api-endpoints/blockchain.md#get-adamant-blockchain-network-info) or [`/node/status`](/api-endpoints/blockchain.md#get-blockchain-and-network-status) endpoints to get more blockchain and network information in a single request.
+
+## Milestones
+
+Milestones define block rewards for delegates and are triggered at specific block heights.
+
+You can use REST API to:
+
+- [Get blockchain reward](/api-endpoints/blockchain.md#get-blockchain-reward)
+- [Get current milestone number](/api-endpoints/blockchain.md#get-blockchain-milestone)
+- [Retrieve both reward and milestone info in one call](/api-endpoints/blockchain.md#get-blockchain-and-network-status)

index.md

@@ -1,55 +1,34 @@
 # Introduction
 
-ADAMANT is a **decentralized** messenger driven by DPoS blockchain. Anyone can run a node, and users can interact with the network through REST and WebSocket APIs.
+ADAMANT is a **decentralized** messenger powered by a Delegated Proof of Stake (DPoS) blockchain. Anyone can run a node and interact with the network via REST and WebSocket APIs.
 
-Unlike traditional messengers, everything in ADAMANT is a blockchain transaction — messages, votes, transfers, and other actions are all recorded on the blockchain.
+You don’t have to run your own node to use the ADAMANT Messenger. It’s safe to use public nodes — all messages and transactions are **encrypted and signed locally** before being sent.
 
-## Native Token
+## Join the Decentralization
 
-**ADM** is the native token of the ADAMANT blockchain. It’s used to pay transaction fees and can be transferred between accounts. For consistency and precision, ADM amounts and **fees** are stored as strings in transactions and measured in 1/10<sup>8</sup> ADM (1 ADM = 100,000,000).
+### Run own node
 
-## Transaction Fees
-
-Every transaction in ADAMANT requires a fee, paid in ADM. Fees help prevent spam and support the network. Fees are intentionally very low, making ADAMANT affordable for active messaging.
-
-Most transaction types have a fixed fee, but **Message** and **Key-Value Store** (KVS) transaction fees scale with content length.
-
-You can get blockchain fees using the [`/api/blocks/getFees`](/api-endpoints/blockchain.md#get-blockchain-fees) API endpoint.
-
-## Timestamps
-
-A **timestamp** in ADAMANT shows how many seconds have passed since the creation of the blockchain — the **blockchain epoch**, set at September 2, 2017, 17:00:00 GMT+0.
-
-For example, to convert time to ADAMANT's timestamp using TypeScript:
-
-```ts
-const EPOCH = Date.UTC(2017, 8, 2, 17, 0, 0, 0);
+While you can connect to any ADAMANT node with an enabled API, it is recommended to [run your own node](https://news.adamant.im/how-to-run-your-adamant-node-on-ubuntu-990e391e8fcc) for the following reasons:
 
-/**
- * Converts provided timestamp into ADAMANT's epoch timestamp
- * @param time - timestamp in ms
- */
-const getEpochTime = (time: number = Date.now()) =>
-  Math.floor((time - EPOCH) / 1000);
-```
+- **Support decentralization** – More nodes means stronger network
+- **Robust performance** – Requests are processed faster through your own node.
+- **High reliability** – You maintain full control over the API’s availability
 
-You can get blockchain's epoch time using [`/blocks/getEpochTime`](/api-endpoints/blockchain.md#get-blockchain-epoch) endpoint. Additionally, consider using [`/blocks/getStatus`](/api-endpoints/blockchain.md#get-adamant-blockchain-network-info) or [`/node/status`](/api-endpoints/blockchain.md#get-blockchain-and-network-status) endpoints to get more blockchain and network information in a single request.
+To get started, check out the [Installation](/own-node/installation.md) and [Configuration](/own-node/configuration.md) guides — they cover everything you need to install, sync, and run a node.
 
-## Milestones
+You can also run a [Testnet node](/own-node/testnet.md) to experiment and try out different things in a safe environment.
 
-Milestones define block rewards for delegates and are triggered at specific block heights.
+::: tip
+If you're building a service with a near-100% uptime requirement, implement a health check in your application — similar to [adamant-api-jsclient](https://github.com/Adamant-im/adamant-api-jsclient/blob/07016c89b57863ac379ebfcbf6cf464a0639d3b1/src/api/index.ts#L183) or [the ADAMANT PWA](https://github.com/Adamant-im/adamant-im/blob/f5c7b7ce95fb5df3785a3458abc4e0b132c18791/src/lib/nodes/abstract.client.ts). While connecting to public nodes is possible, running three or more separate ADAMANT nodes is significantly more reliable.
+:::
 
-You can use REST API to:
+### Become a delegate
 
-- [Get blockchain reward](/api-endpoints/blockchain.md#get-blockchain-reward)
-- [Get current milestone number](/api-endpoints/blockchain.md#get-blockchain-milestone)
-- [Retrieve both reward and milestone info in one call](/api-endpoints/blockchain.md#get-blockchain-and-network-status)
+ADAMANT uses a **Delegated Proof of Stake (DPoS)** consensus. By running a node and meeting the criteria, you can [register as a delegate](https://news.adamant.im/how-to-become-an-adamant-delegate-745f01d032f), forge blocks, and earn rewards while contributing to network security.
 
 ## Public Nodes
 
-ADAMANT uses a secure API. Transactions cannot be performed by transmitting a passphrase to the node. Instead, all actions require signed transactions, meaning there’s no difference in security whether you use a local or remote node.
-
-To use ADAMANT, you don't need to run your own node — you can connect to any public node, such as:
+To use ADAMANT, you can connect to any public node, such as:
 
 ```csv
 https://lake.adamant.im
@@ -61,19 +40,29 @@ https://tauri.adm.im
 
 However, **we still recommend running your own node** for reliability and performance and to help support decentralized messaging.
 
-## Running own node
+## Interacting with the nodes
 
-While you can connect to any ADAMANT node with an enabled API, it is recommended to [run your own node](https://news.adamant.im/how-to-run-your-adamant-node-on-ubuntu-990e391e8fcc) for the following reasons:
+If you're building a tool or app on the ADAMANT blockchain, you can use the REST API to interact with the network.
 
-- **Support decentralization** – More nodes means stronger network
-- **Robust performance** – Requests are processed faster through your own node.
-- **High reliability** – You maintain full control over the API’s availability
+For real-time applications — such as messengers, or bots — the WebSocket API provides instant updates and optimal performance.
 
-If you're building a service with a near-100% uptime requirement, implement a health check in your application — similar to [adamant-api-jsclient](https://github.com/Adamant-im/adamant-api-jsclient/blob/07016c89b57863ac379ebfcbf6cf464a0639d3b1/src/api/index.ts#L183) or [the ADAMANT PWA](https://github.com/Adamant-im/adamant-im/blob/f5c7b7ce95fb5df3785a3458abc4e0b132c18791/src/lib/nodes/abstract.client.ts). While connecting to public nodes is possible, running three or more separate ADAMANT nodes is significantly more reliable.
+### Choosing a node
+
+You can connect to **any public node** in the ADAMANT network.
 
-For messengers or bot applications, consider using a [Socket connection](/api/websocket.md) for optimal performance.
+To ensure you're on the correct network, check the node’s `nethash`. For the **mainnet**, the `nethash` is:
+
+```
+bd330166898377fb28743ceef5e43a5d9d0a3efd9b3451fb7bc53530bb0a6d64
+```
+
+You can check a node's `nethash` in its config or using the [`/api/blocks/getNethash`](/api-endpoints/blockchain.md#get-blockchain-nethash) endpoint. For example:
+
+```url
+https://endless.adamant.im/api/blocks/getNethash
+```
 
-## ADAMANT Frameworks
+### Community Libraries & Tools
 
 This list includes some libraries and frameworks to interact with ADAMANT nodes **developed by the ADAMANT community**.