|
2 | 2 |
|
3 | 3 | This file details changes made to TrueBlocks over time. All version prior to version 3.0.0 are now no longer supported. |
4 | 4 |
|
5 | | -## v6.0.0 - Coming soon... |
| 5 | +## v6.1.0 - Summary (2025/11/01) |
| 6 | + |
| 7 | +**Note:** The repository `VERSION` file contains `6.1.0`, but this `CHANGES.md` does not contain detailed release notes for `v6.0.x` or `v6.1.0` — only a placeholder for `v6.0.0`. Below is a concise, facts-backed summary of the nearest documented release (v5.0.0) and guidance for producing an exact, commit-level changelog between `v5.0.0` and `v6.1.0`. |
| 8 | + |
| 9 | +Summary of the most relevant, user-facing changes from `v5.0.0` (Lancaster, 2025-03-28): |
| 10 | + |
| 11 | +- Major focus: fully automated ETH and ERC20 token balance reconciliation. |
| 12 | +- New and improved `chifra export` features: `--assets`, `--transfers`, `--nfts`, and a much improved `--statements` (massive performance increase via a new Statements cache). |
| 13 | +- SDK bump and hardening: SDK moved to v5 in that release (note guidance to import `github.com/TrueBlocks/trueblocks-sdk/v6`). Improved JSON parsing and better test coverage. |
| 14 | +- Data model breaking changes: Statement and Transfer types changed (many added/renamed/removed fields). Important examples: |
| 15 | + - `Statement` adds reconciliation fields (`correctAmountIn`, `correctAmountOut`, `correctBegBalIn`, etc.), renames `assetAddr`→`asset`, `assetSymbol`→`symbol`, and changes `SpotPrice` from `float64` to `big.Float` (breaking). |
| 16 | + - `Transfer` has many new fields (amountOut, internalOut, gasOut, transaction, log, blockNumber, transactionIndex, logIndex, holder, asset, decimals, sender, recipient, amountIn, internalIn, minerBaseRewardIn, minerNephewRewardIn, minerTxFeeIn, minerUncleRewardIn, prefundIn, selfDestructIn, ...). |
| 17 | + - `Log` gains `isNFT`. |
| 18 | +- System changes: `base` package hardening (nil handling), removal of `base.Min`/`base.Max`, renaming `base.Ether`→`base.Float`; Go bumped to 1.23.1; CI/lint updates; cache UX improvements; auto-codegen improvements; TrueBlocks Key deprecated/removed. |
| 19 | +- CLI changes and deprecations: many `chifra monitors` watch-related options removed; `chifra daemon` options deprecated in favor of `khedra`; `chifra slurp` key option removed; `chifra tokens --by_acct` bug fixed; `--accounting` deprecated for `chifra export`. |
| 20 | +- Testing: ~90 new tests around `chifra export` plus better fuzzing and many unit tests. |
| 21 | + |
| 22 | +If you want a precise, commit/PR-based changelog between the tag nearest `v5.0.0` and the current `v6.1.0`, run the following (from the repo root). These commands will list tags and then show merged commit messages between the two tags: |
| 23 | + |
| 24 | +```fish |
| 25 | +git tag --sort=v:refname |
| 26 | +git log --merges --pretty=format:'%h %s' v5.0.0..v6.1.0 |
| 27 | +git log --pretty=format:'%h %s' v5.0.0..v6.1.0 |
| 28 | +``` |
| 29 | + |
| 30 | +Or to produce a compact summary of merged PR titles (if the repo uses merge commits for PRs): |
| 31 | + |
| 32 | +```fish |
| 33 | +git log --merges --pretty=format:'%h %s' v5.0.0..v6.1.0 |
| 34 | +``` |
| 35 | + |
| 36 | +If you'd like, I can run those git commands now and append a generated summary (grouped by features, breaking changes, fixes) into this file. Otherwise, keep reading below for the original `v5.0.0` release notes. |
6 | 37 |
|
7 | 38 | ## v5.0.0 - All About Them Recons - Lancaster (2025/03/28) |
8 | 39 |
|
|
0 commit comments