Repository navigation
⚠️ Consensus release: pools and every 5.0.x node should upgrade
Avian Core 5.0.0 to 5.0.4 did not enforce a set of asset rules that Avian 4.x enforces, so a 5.0.x node accepts transactions and blocks that a 4.x node rejects. This release enforces them again, so that the two series accept and refuse the same blocks.
It also carries the asset transfer overflow fix that was tagged as v5.0.4 and never published with binaries. That rule has been in force since mainnet block 5,270,000.
Pools first, then everyone running 5.0.x. Nodes on the 4.x series need v4.2.1 for the overflow fix. v4.2.0 and earlier do not have it.
After upgrading
- No reindex, no resync and no manual step.
- At the first start the asset database is rebuilt from the blocks on disk. On mainnet that takes about a minute on Linux and around ten minutes on Windows, and the node does not answer RPC calls until it is done.
- The restored rules have no activation height. The whole mainnet chain up to block 5,411,445 was validated under them and no block was refused, so an upgraded node stays on the chain it is on.
Consensus
- 4.x asset rules restored. A coinbase carries no asset outputs, asset outputs carry 0 AVN, unique and qualifier transfer amounts are bounded, tags and freezes travel with the token that authorises them, and a restricted issuance carries its verifier string. Tag, freeze and verifier scripts, and asset scripts with an amount of zero, are unspendable again and stay out of the UTXO set. (#268)
- Asset transfer overflow fix, from v5.0.4: a transfer amount outside the money range, or a set of transfers whose total overflows, is refused. (#251)
Other changes
- Stratum v2 Template Provider:
aviand -sv2serves block templates over the Stratum v2 Template Distribution Protocol, with a small extension for Avian's two proof-of-work algorithms. It is off by default and binds to loopback. Seedoc/sv2.md. (#267) - Asset database: it now records a version and rebuilds itself when it was written by an older one. A rebuild, including
-reindexassets, now restores qualifier tags, address freezes, global freezes and verifier strings changed by a reissue, which 5.0.x lost. (#270) - Rewards: a snapshot requested with
requestsnapshotis taken when its height is reached.distributerewardfinishes a distribution it could not complete at once, and the newcanceldistributionwithdraws one. (#268, #270) - RPC:
createrawtransactionandcreatepsbtbuild the asset operations 4.x had, restricted asset outputs are described again in the decode calls, and-zmqpubrawmessageis back. (#268) - P2P: a fork below the maximum reorganization depth is still refused, but the peer that sent it is no longer disconnected. (#270)
- GUI: the wallet window stays usable while the chain catches up with large wallets open. (#268)
- Mining IPC: a template request through the multiprocess interface keeps its algorithm and coinbase script. (#266)
- RIP-25: groundwork for ML-DSA-44 post-quantum signatures. It is not deployed on mainnet and this release does not schedule it. (#259 to #264)
- Chain parameters: the mainnet sync hints move to block 5,412,000.
📄 Full release notes, with upgrade instructions and compatibility.
What's Changed
- consensus: fix asset transfer amount overflow (v5.0.4, activates block 5,270,000) by @cdonnachie in #251
- build: open 5.0.5 development cycle by @cdonnachie in #253
- test: localize the unit test suite to Avian and run it in CI by @cdonnachie in #254
- lint: make the lint suite pass on Avian by @cdonnachie in #256
- ci: split Build/Unit-tests, add Lint job, dedupe push/PR runs by @cdonnachie in #255
- ci: add fuzz build + generative smoke job by @cdonnachie in #257
- lint: remove dead lint_subtree function by @cdonnachie in #258
- RIP-25: ML-DSA-44 post-quantum signatures (witness v2) — Phase 0 consensus hardening by @cdonnachie in #259
- RIP-25 Phase 1: freeze spec + commit known-answer vectors by @cdonnachie in #260
- RIP-25 Phase 2: lock ML-DSA-44 witness robustness rules by @cdonnachie in #261
- RIP-25 Phase 3: ML-DSA-44 witness-v2 consensus vectors (tx_valid/tx_invalid) by @cdonnachie in #262
- RIP-25 Phase 3: fuzz the ML-DSA-44 verifier + nightly liboqs fuzz with persisted corpus by @cdonnachie in #263
- RIP-25 Phase 4: wallet post-quantum change routing + dead-key-path cleanup by @cdonnachie in #264
- ci: bound the ML-DSA fuzz corpus with periodic set-cover minimization by @cdonnachie in #265
- Fix/ipc blockcreateoptions dual pow by @cdonnachie in #266
- Restore the 4.x asset rules that 5.x does not enforce by @cdonnachie in #268
- lint: fix the circular dependencies reported since #268 by @cdonnachie in #269
- sv2: Stratum v2 Template Provider by @cdonnachie in #267
- Asset follow-ups: reorg check, reward change address, asset database version by @cdonnachie in #270
- release: v5.0.5 by @cdonnachie in #271
Full Changelog: v5.0.3...v5.0.5