Skip to content

Commit 71b44ea

Browse files
committed
chore: Added todo's to README and use link references
1 parent bd7ddab commit 71b44ea

File tree

1 file changed

+36
-13
lines changed

1 file changed

+36
-13
lines changed

README.md

Lines changed: 36 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,23 @@
55
[![Release Binaries](https://github.com/ditatompel/xmr-remote-nodes/actions/workflows/release.yml/badge.svg)](https://github.com/ditatompel/xmr-remote-nodes/actions/workflows/release.yml)
66
[![Go Report Card](https://goreportcard.com/badge/github.com/ditatompel/xmr-remote-nodes)](https://goreportcard.com/report/github.com/ditatompel/xmr-remote-nodes)
77

8-
Source code of [https://xmr.ditatompel.com](https://xmr.ditatompel.com), a website that helps you monitor your favourite Monero remote nodes.
8+
Source code of [https://xmr.ditatompel.com](https://xmr.ditatompel.com),
9+
a website that helps you monitor your favourite Monero remote nodes.
910

10-
> :warning: :construction: This project is still freaking 0.x.x :construction:,
11+
> :warning: :construction: This project is not mature enough :construction:,
1112
> If you want to use it on your server, please use it with caution.
1213
1314
## How does it work?
1415

15-
Apart from CPU architecture type, you can build two types of binaries from this project: a **server** and a **client**.
16+
Apart from CPU architecture type, you can build two types of binaries from
17+
this project: a **server** and a **client**.
1618

17-
The **clients** is used to fetch node information given by the server. First, it will ask the server which node to fetch. Then, it will fetch the information and report back to the server.
19+
The **clients** is used to fetch node information given by the server. First,
20+
it will ask the server which node to fetch. Then, it will fetch the information
21+
and report back to the server.
1822

19-
The **server** serves an embedded Svelte static site for the Web UI. It also serves the `/api` endpoint that is used by the clients and the Web UI itself.
23+
The **server** serves an embedded Svelte static site for the Web UI. It also
24+
serves the `/api` endpoint that is used by the clients and the Web UI itself.
2025

2126
## Requirements
2227

@@ -32,38 +37,56 @@ To build the executable binaries, you need:
3237
### Server requirements
3338

3439
- MySQL/MariaDB
35-
- [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) (optional). Place it to `./assets/geoip`, see [./internal/geo/ip.go](./internal/geo/ip.go).
40+
- [GeoIP Database][geoip_doc] (optional). Place it to `./assets/geoip`,
41+
see [./internal/geo/ip.go](./internal/geo/ip.go).
3642

3743
## Installation
3844

3945
### For initial server setup:
4046

41-
1. Download [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) and place it to `./assets/geoip`. (see [./internal/geo/ip.go](./internal/geo/ip.go)).
47+
1. Download [GeoIP Database][geoip_doc] and place it to `./assets/geoip`.
48+
(see [./internal/geo/ip.go](./internal/geo/ip.go)).
4249
2. Pepare your MySQL/MariaDB.
4350
3. Copy `.env.example` to `.env` and edit it to match with server environment.
44-
4. Build the binary with `make server` (or `make build` to build both **server** and **client** binaries).
51+
4. Build the binary with `make server` (or `make build` to build both
52+
**server** and **client** binaries).
4553
5. Run the service with `./bin/xmr-nodes-server-linux-<YOUR_CPU_ARCH> serve`.
4654

47-
Systemd example: [./deployment/init/xmr-nodes-server.service](./deployment/init/xmr-nodes-server.service).
55+
Systemd example: [xmr-nodes-server.service][server_systemd_service].
4856

4957
### For initial prober setup:
5058

5159
1. Create API key for prober
5260
2. Copy `.env.example` to `.env` and edit it to match with prober environment.
53-
3. Build the binary with `make client` (or `make build` to build both **server** and **client** binaries).
61+
3. Build the binary with `make client` (or `make build` to build both
62+
**server** and **client** binaries).
5463
4. Run the service with `./bin/xmr-nodes-client-linux-<YOUR_CPU_ARCH> probe`.
5564

56-
Systemd example: [xmr-nodes-prober.service](./deployment/init/xmr-nodes-prober.service) and [xmr-nodes-prober.timer](./deployment/init/xmr-nodes-prober.timer).
65+
Systemd example: [xmr-nodes-prober.service][prober_systemd_service] and
66+
[xmr-nodes-prober.timer][prober_systemd_timer].
5767

5868
## Development and Deployment
5969

6070
See the [Makefile](./Makefile).
6171

72+
## ToDo's
73+
74+
- [] Accept IPv6 nodes.
75+
- [] Use `a-h/templ` and `HTMX` instead of `Svelte`.
76+
- [] Use Go standard `net/http` instead of `fiber`.
77+
6278
## Similar Projects
6379

64-
- [lalanza808/monero.fail](https://github.com/lalanza808/monero.fail)
65-
- [cake-tech/upptime-monerocom](https://github.com/cake-tech/upptime-monerocom)
80+
- [lalanza808/monero.fail][monerofail_gh]
81+
- [cake-tech/upptime-monerocom][uptime_monerocom_gh]
6682

6783
## License
6884

6985
This project is licensed under [GLWTPL](./LICENSE).
86+
87+
[geoip_doc]: https://dev.maxmind.com/geoip/geoip2/geolite2/ "GeoIP documentation"
88+
[server_systemd_service]: ./deployment/init/xmr-nodes-server.service "systemd service example for server"
89+
[prober_systemd_service]: ./deployment/init/xmr-nodes-prober.service "systemd service example for prober"
90+
[prober_systemd_timer]: ./deployment/init/xmr-nodes-prober.timer "systemd timer example for prober"
91+
[monerofail_gh]: https://github.com/lalanza808/monero.fail "Lalanza808's monero.fail GitHub repository"
92+
[uptime_monerocom_gh]: https://github.com/cake-tech/upptime-monerocom "monero.com uptime GitHub repository"

0 commit comments

Comments
 (0)