Skip to content

Commit 7c2d1f8

Browse files
Add license management unit (#23)
* Add license management unit * Update layout * Change Denode to Datakeeper Node * Revert "Change Denode to Datakeeper Node" This reverts commit e52df24. * Fix layout
1 parent ea4e641 commit 7c2d1f8

1 file changed

Lines changed: 98 additions & 49 deletions

File tree

readme.md

Lines changed: 98 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -29,42 +29,44 @@ This guide walks you through setting up and running a DeNet Node, enabling your
2929

3030
### Table of contents:
3131

32-
- [Denode](#denode)
33-
- [Installation](#installation)
34-
- [Requirements](#requirements)
35-
- [Step 0: License Verification](#step-0-verify-your-account-has-license)
36-
- [Step 1: Copy Private Key](#step-1-copy-your-private-key)
37-
- [Step 2: Download Datakeeper Node](#step-2-download-datakeeper-node)
38-
- [Step 3: Start Node](#step-3-start-denet-node)
39-
- [Windows](#windows)
40-
- [Linux](#linux)
41-
- [macOS](#macos)
42-
- [Step 4: Run DeNet Node](#step-4-run-denet-node)
43-
- [Step 5: Monitor Transactions](#step-5-monitor-transactions)
32+
- [Datakeeper Node](#denode)
33+
- [Installation](#installation)
34+
- [Requirements](#requirements)
35+
- [Step 0: License Verification](#step-0-verify-your-account-has-license)
36+
- [Step 1: Copy Private Key](#step-1-copy-your-private-key)
37+
- [Step 2: Download Datakeeper Node](#step-2-download-datakeeper-node)
38+
- [Step 3: Start Node](#step-3-start-denet-node)
39+
- [Windows](#windows)
40+
- [Linux](#linux)
41+
- [macOS](#macos)
42+
- [Step 4: Run DeNet Node](#step-4-run-denet-node)
43+
- [Step 5: Monitor Transactions](#step-5-monitor-transactions)
44+
- [License Management](#managing-license-addresses)
4445
- [Node Manager (GUI)](#denode-manager-gui)
45-
- [Installation](#installation-1)
46-
- [Step 0: Prepare Environment](#step-0-prepare-environment)
47-
- [Step 1: Download Node Manager](#step-1-download-application)
48-
- [Step 2: Install And Run](#step-2-install-and-run)
49-
- [Windows](#windows-1)
50-
- [Linux](#linux-1)
51-
- [macOS](#macos-1)
52-
53-
# Denode
46+
- [Installation](#installation-1)
47+
- [Step 0: Prepare Environment](#step-0-prepare-environment)
48+
- [Step 1: Download Node Manager](#step-1-download-application)
49+
- [Step 2: Install And Run](#step-2-install-and-run)
50+
- [Windows](#windows-1)
51+
- [Linux](#linux-1)
52+
- [macOS](#macos-1)
53+
- [Step 3: Open Application Interface in Browser](#step-3-open-application-interface-in-browser)
54+
55+
# Datakeeper Node
5456
## Installation
5557
## Requirements
5658

57-
- A wallet address (DeNet app/Metamask/any other wallet) holding a Datakeeper Node License.
58-
- Device with free disk space for storing DeNet user data.
59-
- Terminal access (Command Prompt/PowerShell on Windows, Terminal on macOS/Linux).
60-
- DeNet Node application downloaded.
61-
- PEAQ balance: tokens will be distributed to Datakeepers automatically and will be regularly credited for successfully completed transactions, if the node is running and does not disconnect from the network, no deposits will be required.
59+
- A wallet address (DeNet app/Metamask/any other wallet) holding a Datakeeper Node License.
60+
- Device with free disk space for storing DeNet user data.
61+
- Terminal access (Command Prompt/PowerShell on Windows, Terminal on macOS/Linux).
62+
- DeNet Node application downloaded.
63+
- PEAQ balance: tokens will be distributed to Datakeepers automatically and will be regularly credited for successfully completed transactions, if the node is running and does not disconnect from the network, no deposits will be required.
6264

6365
## Step 0: Verify your account has license
6466

65-
- Open https://peaq.subscan.io/account/YOUR_ADDRESS
66-
- Replace YOUR_ADDRESS with your wallet address.
67-
- The license(s) should be seen as a sNL ERC-721 token.
67+
- Open https://peaq.subscan.io/account/YOUR_ADDRESS
68+
- Replace YOUR_ADDRESS with your wallet address.
69+
- The license(s) should be seen as a sNL ERC-721 token.
6870

6971
![](assets/license.png)
7072

@@ -93,8 +95,8 @@ _If you use any other wallet, the steps may differ but should be similar to the
9395

9496
3. Copy application to another directory.
9597
**Example:**
96-
- macOS/Linux: copy denode executable to `~/denet/` directory
97-
- Windows: copy to `C:\denet\` directory
98+
- macOS/Linux: copy denode executable to `~/denet/` directory
99+
- Windows: copy to `C:\denet\` directory
98100

99101
## Step 3: Start DeNet Node
100102
Launch the node via a terminal.
@@ -104,9 +106,9 @@ Launch the node via a terminal.
104106
![](assets/win-cmd.png)
105107
2. Start the Application:
106108
- Navigate to the Application Folder
107-
![](assets/win-folder.png)
109+
![](assets/win-folder.png)
108110
- Run application executable
109-
![](assets/win-run.png)
111+
![](assets/win-run.png)
110112
### Linux
111113
1. Open Terminal: Use Ctrl + Alt + T or your terminal shortcut.
112114
Or SSH to your remote host.
@@ -118,7 +120,7 @@ cp denode-linux-amd64 ~/denet/denode
118120
cd ~/denet
119121
chmod +x denode
120122
```
121-
![](assets/linux-run.png)
123+
![](assets/linux-run.png)
122124

123125
### macOS
124126
1. Open "Terminal" via Spotlight or Applications
@@ -132,7 +134,7 @@ cd ~/denet
132134
chmod +x denode
133135
xattr -d com.apple.quarantine denode
134136
```
135-
![](assets/mac-run.png)
137+
![](assets/mac-run.png)
136138

137139
## Step 4: Run DeNet Node
138140
1. **Enter private key**: Paste the copied private key and press Enter.
@@ -154,13 +156,13 @@ xattr -d com.apple.quarantine denode
154156
- Or choose the RPC endpoint (Select RPC for peaq (ChainID: 3338)).
155157
9. **Verify Operation**:
156158
- Watch the terminal output. If no errors appear, your DeNet Node is running correctly.
157-
![](assets/successful-launch.png)
159+
![](assets/successful-launch.png)
158160

159161
## Step 5: Monitor Transactions
160162

161163
Track your node’s activity using the peaq Subscan web interface.
162164
1. Visit the peaq Subscan website (e.g., https://peaq.subscan.io/account/YOUR_ADDRESS).
163-
- Search for your node’s transactions using your Datakeeper address.
165+
- Search for your node’s transactions using your Datakeeper address.
164166
2. Check transaction statuses. Green check marks indicate successful transactions, confirming your node is working correctly.
165167
![](assets/successful-trxs.png)
166168
## Troubleshooting
@@ -172,15 +174,15 @@ Track your node’s activity using the peaq Subscan web interface.
172174
![](assets/port-error.png)
173175
- **Subscan Issues:** If transactions don’t appear, confirm your node is running and has enough gas tokens (> 0.03 $PEAQ).
174176
- **Not Opened macOS:**
175-
- Run the following command to allow `denode` executable:
176-
- `xattr -d com.apple.quarantine denode`
177-
![](assets/mac-error-01.png)
177+
- Run the following command to allow `denode` executable:
178+
- `xattr -d com.apple.quarantine denode`
179+
![](assets/mac-error-01.png)
178180
- **Permission denied**
179181
```bash
180182
user@desktop:~/denet$ ./denode
181183
-bash: ./denode: Permission denied
182184
```
183-
- Allow execution by running `chmod +x denode`
185+
- Allow execution by running `chmod +x denode`
184186
## Notes
185187
- Keep your terminal open to maintain the node’s operation. Closing it stops the node. Otherwise, set up the node as a background service (see [Advanced Settings: Systemd Service](#advanced-settings)).
186188
- Additional steps (e.g., advanced settings) will be added as needed — check for updates from DeNet.
@@ -191,7 +193,7 @@ A graphical user interface (GUI) for seamless node operation coming soon. Stay t
191193

192194
#### Systemd service (Linux)
193195
- It is recommended to run as non-root user.
194-
- Follow [Step 4](#step-4-run-denet-node) first.
196+
- Follow [Step 4](#step-4-run-denet-node) first.
195197
You should have config files in the path `/home/denet/.denode/`
196198
- We used **denet** user as an example, replace it with your username.
197199

@@ -229,17 +231,64 @@ Now your node will be running and start at boot.
229231
**View latest logs**
230232
`journalctl -u denode -r`
231233

234+
## Managing License Addresses
235+
236+
🔐 **Managing License Addresses in DeNet**
237+
238+
📌 **Roles for the License**
239+
- **License Owner** - The license holder with full management rights.
240+
- **Admin** - Can change the Manager, but cannot transfer the license.
241+
- **Manager** - Has a limited set of actions, with no rights in the smart contract.
242+
243+
🧭 **Steps for Managing Addresses**
244+
245+
🔗 **Connecting a Wallet**
246+
- Open the [web page manager](https://nodemanager.denet.app/) and connect:
247+
- Click the **Connect Wallet** button.
248+
- Choose a connection method:
249+
- Metamask
250+
- Wallet Connect
251+
- After connecting, your address will appear in the top right corner.
252+
253+
📋 **Viewing the List of Licenses**
254+
- After connecting the wallet:
255+
- Each license is displayed as a card with an ID (e.g., ID #2276) and a **Manage** button.
256+
257+
⚙️ **Managing a License**
258+
- Click **Manage** on the desired license. A window will open:
259+
- "You can change address here"
260+
- Two fields are available:
261+
- **New Admin Address** - For changing the administrator.
262+
- **New Manager Address** - For changing the manager.
263+
264+
🛠 **Changing Addresses**
265+
266+
▶️ **Changing the Admin**
267+
- Enter the new Ethereum address in the **New Admin Address** field.
268+
- Click the **Change Admin** button.
269+
- Confirm the transaction in your wallet.
270+
271+
▶️ **Changing the Manager**
272+
- Enter the new manager’s address in the **New Manager Address** field.
273+
- Click **Change Manager**.
274+
- Confirm the action in your wallet.
275+
276+
📌 **Notes**
277+
- All changes are processed through a smart contract, requiring gas fees.
278+
- Ensure the provided addresses are valid (Ethereum format).
279+
280+
232281
# Denode Manager GUI
233282
## Installation
234283

235284
## Step 0: Prepare environment
236285
1. Remove old credentials and configurations, they should be imported from scratch:
237-
### Linux/macOS
286+
### Linux/macOS
238287
```shell
239288
rm -rf ~/.denode
240289
```
241-
### Windows
242-
Use cmd or graphical user interface to remove the folder.
290+
### Windows
291+
Use cmd or graphical user interface to remove the folder.
243292
![](assets/win-rm-denode.png)
244293

245294
2. For **Linux/macOS**: Download installation and management scripts from the [scripts](https://github.com/DeNetPRO/Node) directory
@@ -249,24 +298,24 @@ Now your node will be running and start at boot.
249298
```
250299
## Step 1: Download Application
251300
1. Download archive for your system from https://github.com/DeNetPRO/Node/releases as well as for [denode](#step-2-download-datakeeper-node)
252-
### Windows
301+
### Windows
253302
```
254303
denode-manager-win-amd64.msi
255304
```
256-
### Linux
305+
### Linux
257306
```
258307
denode-manager-linux-amd64.zip
259308
denode-manager-linux-arm64.zip
260309
```
261-
### macOS
310+
### macOS
262311
```
263312
denode-manager-darwin-amd64.zip
264313
denode-manager-darwin-arm64.zip
265314
```
266315
## Step 2: Install And Run
267316
### macOS/Linux
268317
1. Open terminal as for [denode installation](#macos)
269-
2. Allow scripts execution on this device
318+
2. Allow scripts execution on this device
270319
```shell
271320
cd ~/Downloads
272321
chmod +x install.sh denode-manager.sh

0 commit comments

Comments
 (0)