Repository navigation
v5.22.0
Nuthatch 5.22.0 is for a firm that has to show its own onchain figures to someone else: an answer
as of a block or a time, recipes for an issuer's own token, and an evidence bundle that another
machine re-executes to the same rows. There is no storage migration. No sealed segment and no
registry hash moves. A nest that holds a label set gets a new NID and data identity once, because
label sets are no longer part of what a nest is, and one factory configuration that silently lost
events is now refused at load.
Upgrade guidance
Replace the binary and restart. A 5.21 store is used as it is.
- A nest with a label set imported: its NID and data identity move once, since
labels/and
labels.manifest.jsonno longer count toward either (#2946). A single-nest directory starts as
before. A runtime whose mount record was written with labels present logsidentity driftfor it
and keeps serving thedata/<nid>the record names. A nest that publishes writes a full copy under
the new data identity on its nextpublish sync; the old prefix can be deleted once it lands.
The operators guide's
data lifecycle
section has the detail. - A nest whose
[[factories]]give one announcing event'schild_paramtwo templates: it is
refused at load, naming both (#2958). It loaded before, but a child takes one template, so the
second template's tables stayed empty. Declare one template whose ABI holds both contracts' events. - A
/sqlclient that rejects unknown provenance keys: an answer may now carrylabels_sha256
when it readlabels, andsegments_sha256when it was asked at a block. - Every other nest: nothing to do.
As of a block or a time
/at?time=Tplaces a unix time against the nest's own stamped blocks: the last block at or
before it, the next one after, and whether that is final, which it is once the next block is
sealed (#2941). On EURC, 1,000 random times
from deployment to the tip were all placed with no indexed event betweenblockand
next_block, so the nest's state at the time is its state atblock./sqltakesat_blockorat_timeand answers from the rows at or below that block, sealed
and hot (#2942). Label sets bind as imported now (#2962).
For an issuer's own token
nuthatch recipe add frozen,outstandingandmint_burn_dailyfor a FiatToken-style
contract (#2943).outstandingis total supply less frozen balances and the balances of addresses
labelledtreasury. Asked at 2022-12-31 23:59 PT on EURC, it gives 24,905,662.05 against the
24,905,662 of Circle's December 2022 report.nuthatch recipe add fiat_thresholdlists transfers above a fiat amount at their UTC day's
rate, from an offchain table, to recipients in none of the given label sets (#2945). A day with no
rate lists its transfers as unpriced rather than leaving them out.examples/mica-art22computes the four MiCA Art 22(1) figures over EURC, each deduction of the
EBA's RTS as its own view (#2947). It is a worked example, not regulatory advice.
Evidence bundles
nuthatch evidence make "<SELECT>" --at-block N | --at-time Tasks a running nest for one
answer as of a sealed block and writes a bundle: the chain, NID, registry hash, statement, rows, a
hash of the rows in canonical order, the label set's hash when the rows readlabels, and a hash of
the final segments they were read from (#2944, #2961).--keysigns it with a pack key. It refuses
an unsealed block, and one whose segments include a provisional tail.nuthatch evidence verify b.json --url <nest>asks a nest of the same NID the same statement
at the same block and saysmatch, or names the field that differs.--dirre-hashes the
verifier's own segment files first, whichservedoes not, and names any that changed.- Label sets are not part of a nest (#2946). They seal no byte, the mirror does not copy them,
and deleting one leaves every chain table and the NID as they were.
How it was checked
A bundle made on one machine's EURC nest verified on another against a clone seeded from the public
mirror, run with serve and no RPC. A fresh full index of the same nest sealed the same 13,133 final
segments through block 26,000,000, byte for byte. nuthatch-org/eurc-nest
is that nest, and its README is the walkthrough.
Also
actix-httpmoves to 3.22.0 for RUSTSEC-2026-0552, 0553 and 0554. The threezipadvisories of
the same day are reader bugs, and dbsp only writes archives (#2969).