All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Error and exit on: 0 uptime voters, 0 eligible nodes, distribution mismatch, or missing epoch data during summing
- Pass network parameter to
sumStakingRewardsCLI for testnet paths
[v1.5.0] - 2026-04-10
- GitLab CI job for
prepare-initial-data(mainnet), replacing GitHub Actions workflow RPC_URL_{NETWORK}environment variable override for RPC endpoint (e.g.RPC_URL_FLARE,RPC_URL_COSTON2); automatically setsmaxRequestsPerSecondtoInfinity- Skip-if-processed check in CI to avoid re-running already completed epochs
- GitHub Actions workflows (
.github/) — fully replaced by GitLab CI
[v1.4.0] - 2026-04-09
- Single-stage testnet reward calculation (
pnpm calculate-testnet-rewards) — checks uptime and rewards all eligible validators without minimal conditions check - Automated reward pipeline (
pnpm auto-testnet-rewards) — auto-detects epoch, calculates rewards, sums every 4 epochs, and distributes on-chain via ValidatorRewardManager - GitLab CI scheduled pipeline for automated testnet rewards with git push
- Uptime threshold 0 bypasses uptime check (all validators eligible)
- Coston2 deploy config with FlareSystemsManager and EntityManager contracts
- Testnet output files in
generated-files/{network}/reward-epoch-{N}/
[v1.3.0] - 2026-04-06
- Enabled
strict,exactOptionalPropertyTypesin tsconfig - Removed deprecated
baseUrlandmoduleResolutionoptions from tsconfig - Made
rewardEpoch,uptimeVotingThreshold,rewardAmountEpochWei,apiPathproperly optional in ConfigurationService - Added runtime guards in entry points for required configuration values
- Removed unused
numUnrewardedEpochsanddefaultFeePPMproperties from ConfigurationService - Added
@types/globand@types/json2csvdev dependencies for strict type checking - Refactored
findIndex+ indexed access patterns to.find()with narrowing to reduce non-null assertions
[v1.2.0] - 2026-03-13
- Test suite with Mocha, Chai, Sinon, and nyc coverage
- Tests for utils (big-number-serialization, hash, utils, config-utils, rewards) and services (ConfigurationService, EventProcessorService)
- Build stage in GitLab CI pipeline
- Extracted pure reward calculation functions from CalculatingRewardsService to
src/utils/rewards.ts
[v1.1.0] - 2026-03-12
- Migrated from yarn to pnpm
- Updated tsconfig.json to es2024 with handbook-recommended settings
- Added ESLint and Prettier with Flare shared configs
- Cleaned up unused dependencies and bumped outdated ones
- Added GitLab CI pipeline with lint and format checks
- Added SECURITY.md, CHANGELOG.md, CODEOWNERS
[v1.0.0] - 2026-03-10
Initial versioned release. Rewards calculation scripts for Flare network staking.
For reward data generated with earlier unversioned code, see the version-1
(epochs 126-243) and version-2 (epochs 244-264) branches.