vsecoder/dchain
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
v0.0.1
dchain/deploy/single/systemd
History
vsecoder 7e7393e4f8 chore: initial commit for v0.0.1 
DChain single-node blockchain + React Native messenger client.

Core:
- PBFT consensus with multi-sig validator admission + equivocation slashing
- BadgerDB + schema migration scaffold (CurrentSchemaVersion=0)
- libp2p gossipsub (tx/v1, blocks/v1, relay/v1, version/v1)
- Native Go contracts (username_registry) alongside WASM (wazero)
- WebSocket gateway with topic-based fanout + Ed25519-nonce auth
- Relay mailbox with NaCl envelope encryption (X25519 + Ed25519)
- Prometheus /metrics, per-IP rate limit, body-size cap

Deployment:
- Single-node compose (deploy/single/) with Caddy TLS + optional Prometheus
- 3-node dev compose (docker-compose.yml) with mocked internet topology
- 3-validator prod compose (deploy/prod/) for federation
- Auto-update from Gitea via /api/update-check + systemd timer
- Build-time version injection (ldflags → node --version)
- UI / Swagger toggle flags (DCHAIN_DISABLE_UI, DCHAIN_DISABLE_SWAGGER)

Client (client-app/):
- Expo / React Native / NativeWind
- E2E NaCl encryption, typing indicator, contact requests
- Auto-discovery of canonical contracts, chain_id aware, WS reconnect on node switch

Documentation:
- README.md, CHANGELOG.md, CONTEXT.md
- deploy/single/README.md with 6 operator scenarios
- deploy/UPDATE_STRATEGY.md with 4-layer forward-compat design
- docs/contracts/*.md per contract
2026-04-17 14:16:44 +03:00
..
dchain-update.service
chore: initial commit for v0.0.1
2026-04-17 14:16:44 +03:00
dchain-update.timer
chore: initial commit for v0.0.1
2026-04-17 14:16:44 +03:00
README.md
chore: initial commit for v0.0.1
2026-04-17 14:16:44 +03:00

README.md

Systemd units for DChain auto-update

Two files, one-time setup.

Install

Assumes the repo is checked out at /opt/dchain. Adjust WorkingDirectory= and EnvironmentFile= in dchain-update.service if you put it elsewhere.

sudo cp dchain-update.{service,timer} /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now dchain-update.timer

Verify

# When does the timer next fire?
systemctl list-timers dchain-update.timer

# What did the last run do?
journalctl -u dchain-update.service -n 100 --no-pager

# Run one update immediately, without waiting for the timer
sudo systemctl start dchain-update.service

How it behaves

  • Every hour (± up to 15 min jitter) the timer triggers the service.
  • The service runs update.sh once, which:
    • fetches origin/main
    • if HEAD didn't move: exits 0, nothing touched
    • if HEAD moved: fast-forwards, rebuilds image, smoke-tests the new binary, restarts the container, polls health
  • Downtime per update is ~5-8 seconds (Badger reopen + HTTP listener warm-up).
  • Failures write to journal; add OnFailure= if you want Pushover/email.

Disable auto-update

If you want to pin a version and review changes manually:

sudo systemctl disable --now dchain-update.timer

You can still invoke update.sh by hand when you've reviewed and fast-forwarded your working tree.

Why hourly + jitter

A whole federation restarting in the same 60-second window would drop PBFT quorum below 2/3 for that window. With 1-hour cadence and 15-min jitter, the max probability of two validators being down simultaneously is about (15s / 15min)² × N_validators², which stays safely below the quorum floor for any realistic N.