1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
# Monzero website
Website for `monzero.org`, including the PHP-backed block explorer at
`/explorer/`. It contains no build-time dependencies.
## Preview locally
```bash
cd website
php -S 127.0.0.1:8080
```
Open `http://127.0.0.1:8080` for the website and
`http://127.0.0.1:8080/explorer/` for the explorer.
## VPS deployment
Copy this directory's contents to `/var/www/monzero`, install
`nginx-monzero.conf` as `/etc/nginx/sites-available/monzero`, enable the site,
test Nginx, and reload it. The included Nginx route proxies only the homepage's
`/get_info` request to the restricted local RPC service.
On IONOS web hosting, upload the complete contents of this directory to the
domain's assigned document root. PHP must be enabled so `/explorer/api.php` can
proxy the allowlisted, read-only requests to the restricted public node.
## Anonymous miner statistics
The miner table uses an opt-in heartbeat endpoint. It never accepts or returns
a wallet address, hostname, IP address, serial number, or hardware identifier.
Each reporter creates a random UUID; PHP pseudonymizes it with a server-side
HMAC secret before storage and exposes only the first eight pseudonym digits.
Configure these secrets in the PHP environment (use independent random values):
```text
MONZERO_STATS_SECRET=<at least 32 random characters, server only>
MONZERO_STATS_INGEST_TOKEN=<at least 24 random characters, team reporters>
MONZERO_STATS_FILE=/an/apache-writable/private/path/miner-stats.json
```
For shared hosting without environment-variable controls, create
`.monzero-miner-stats.php` one directory above the document root:
```php
<?php
return [
'MONZERO_STATS_SECRET' => 'server-only-random-value',
'MONZERO_STATS_INGEST_TOKEN' => 'team-reporter-random-value',
'MONZERO_STATS_FILE' => __DIR__ . '/.monzero-miner-stats.json',
];
```
Generate suitable values with `openssl rand -hex 32`. Do not place the HMAC
secret in a download or reporter. Give only the ingest token to miners who opt
in, then run the reporter alongside their already-running local daemon:
```bash
MONZERO_STATS_TOKEN='team-ingest-token' \
python3 utils/monzero-miner-reporter.py --interval 60
```
The table counts a miner as active for three minutes after its last heartbeat.
Hash rate and blocks found are self-reported. Block counts are derived from the
local daemon log and are not consensus-verified leaderboard claims.
|
