- Go 60.8%
- templ 33.9%
- Makefile 1.8%
- CSS 1.6%
- Nginx 1.3%
- Other 0.6%
97a4145890Merge pull request #233 This merge action was created automatically. Reviewed-by: ditatompel <ditatompel@users.noreply.github.com> |
||
|---|---|---|
| .github | ||
| cmd | ||
| deployment | ||
| internal | ||
| utils | ||
| .air.toml | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| .golangci.yaml | ||
| bun.lockb | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| Makefile | ||
| package.json | ||
| README.md | ||
| server.go | ||
| tailwind.config.js | ||
| VERSION | ||
XMR Remote Nodes
Source code of https://xmr.ditatompel.com, a website that helps you monitor your favourite Monero remote nodes.
⚠️ 🚧 This project is not mature enough 🚧, If you want to use it on your server, please use it with caution.
How does it work?
Apart from CPU architecture type, you can build two types of binaries from this project: a server and a client.
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.
The server serves the Web UI and the /api endpoint that is used by the
clients.
Requirements
To build the executable binaries, you need:
- Go >= 1.25
- Bun >= 1.1.26
- a-h/templ v0.3.1020
Note
:
- If you want to contribute to the code, please use exact templ version (v0.3.1020).
Server & Prober requirements
- Linux Machines (AMD64 or ARM64)
Server requirements
- MySQL/MariaDB
- GeoIP Database (optional). Place it to
./assets/geoip, see ./internal/ip/geo/geoip.go.
Installation
For initial server setup:
- Download GeoIP Database and place it to
./assets/geoip. (see ./internal/ip/geo/geoip.go). - Pepare your MySQL/MariaDB.
- Copy
.env.exampleto.envand edit it to match with server environment. - Build the binary with
make server(ormake buildto build both server and client binaries). - Run the service with
./bin/xmr-nodes-server-linux-<YOUR_CPU_ARCH> serve.
Systemd example: xmr-nodes-server.service.
For initial prober setup:
- Create API key for prober
- Copy
.env.exampleto.envand edit it to match with prober environment. - Build the binary with
make client(ormake buildto build both server and client binaries). - Run the service with
./bin/xmr-nodes-client-linux-<YOUR_CPU_ARCH> probe.
Systemd example: xmr-nodes-prober.service and xmr-nodes-prober.timer.
Development and Deployment
- Clone or fork this repository.
- Prepare the assets:
make prepare, - Run
air serve(live reload using air-verse/air).
See the Makefile.
ToDo's
- ✅ Accept IPv6 nodes.
- ✅ Use
a-h/templandHTMXinstead ofSvelte. - ✅ Accept I2P nodes.
- ✅ Support Tor hidden service (beta, inform via HTTP header).
- ✅ Integrate with Rucknium's Monero Network Scan
- ✅ Implement ban by IP address using Boog900's Monero Ban List
- Use Go standard
net/httpinstead offiber.
Acknowledgement
The creators and contributors of these projects have provided valuable resources, which I am grateful for:
- jtgrassie/monero-pool
- Rucknium/xmrnetscan
- Boog900/monero-ban-list
- Boog900/p2p-proxy-checker
- rclone/rclone
Similar Projects
Donation
The servers costs are currently covered by myself. If you find this project
useful, please consider making a donation to help cover the ongoing expenses.
Your contribution will go towards ensuring the continued availability of the
website and my stagenet and testnet public remote nodes.
XMR Donation address:
82ez97EPriX6tnkL5fSv7u93aZV2gHWeMUc9hS3a8Dd6NxGWPZWhruGTFnNyJ4z1yWQMHgtA81i9h9vq7HWoKZLk9EzWryD
Thank you!
View Only Wallet Details
Primary Address:
48D1TAcsq4vMoRu8CNaDsPgvUR7SQ1B6TCXfBsJXAbPb7TjeNZbMhAMKatSA64XRTzFckyMcaF19U8Ejr9wy8iwnTCAUU8x
View Key:
f26d16b3ab8265a8ddd9db99f69cafeee9081555e67eb03a34778f0391962803
Restore height:
3457614 (2025-07-18)
View only old wallet address can be found in PR #201.
License
This project is licensed under BSD-3-Clause license.