ADAMANT Forging Pool v3.1.0: recommended update for reward and payout fixes

[dev-adamant-im]

ADAMANT Forging Pool v3.1.0 has been released.

This is a recommended update for pool operators because it fixes and hardens reward calculations and scheduled payout handling.

Release:
https://github.com/Adamant-im/pool/releases/tag/v3.1.0

Repository:
https://github.com/Adamant-im/pool

Why Upgrade

v3.1.0 focuses on payout safety, operator security, and long-term maintainability for ADAMANT forging pools.

The most important reason to upgrade is that the release improves the accounting paths used for reward calculations and payouts:

• pending rewards are normalized before payout accounting
• per-voter reward progress is persisted for forged blocks
• retry and crash paths are safer against duplicate reward updates
• payout, block parsing, and store behavior now have more focused tests
• logs and notifications are clearer for operational failure modes

Storage and Migration

Pool storage is now MongoDB-backed.

The release includes migration tooling for older LowDB-based pool data:

• scripts/migrate-lowdb-mongodb/
• migration tests
• MongoDB index setup
• updated configuration reference
• README migration guidance

Operators should back up existing pool data, test migration on a copy, and verify pending/received reward totals before switching production payouts to the upgraded pool.

Operator Security

v3.1.0 adds optional encrypted passphrase support.

Existing plain passphrase configs remain supported, but operators can now encrypt the delegate passphrase and unlock the running pool only when payouts should be enabled:

npm run adm-pool encrypt
npm run adm-pool unlock
npm run adm-pool lock
npm run adm-pool status

The control interface uses a local owner-only Unix socket. With an encrypted passphrase, the pool can start locked: block sync, the dashboard, and public API stay available, while payouts and ADM notifications remain paused until unlock.

Monitoring and Dashboard

The release adds:

• /api/health for secret-free external monitoring
• locked payout status for the dashboard
• voter and transaction filtering by address or name
• delegate/voter names under addresses when available
• numeric sorting fixes
• improved explorer links and dashboard layout

Runtime and Docs

v3.1.0 updates the runtime baseline to:

• Node.js 22.13.0+
• npm 10+

It also refreshes README, CONTRIBUTING, and repository guidance for setup, migration, monitoring, secret safety, and contribution workflow.

Recommended Upgrade Checklist

• Back up config and reward history
• Review MongoDB settings in config.default.jsonc
• Test LowDB-to-MongoDB migration on a copy of the data
• Verify pending and received reward totals after migration
• Review payout, donation, and maintenance wallet settings
• Build and smoke-test the dashboard
• Check /api/health
• Unlock payouts only after verifying startup logs and pool status

Tags

release v3.1.0 forging-pool delegates payouts MongoDB security monitoring