Mint/Burn Flow Changelog

Impact Notes

• USDai mint/burn tracking now runs on Arbitrum as the canonical native issuance chain instead of Ethereum bridge-transfer noise
• Aggregate and per-coin APIs now read only configured `(stablecoinId, chainId)` pairs so stale historical rows on non-canonical chains do not contaminate public flow metrics
• Cron metadata, coverage helpers, status reconciliation, daily digest, and DEWS mint/burn inputs now honor chain-aware mint/burn scope
• Admin backfill auto-selection and explicit config replay now work across the configured issuance-chain set instead of Ethereum-only

Impact Notes

• LayerZero OFT transfers now mark both the mint-side and burn-side event rows as `flowType='bridge_transfer'` so they drop out of counted economic-flow aggregates
• USDai's Ethereum tracker now recognizes the documented USDai OAdapter / LayerZero packet flow instead of treating equal-sized bridge mints and burns as issuance activity
• Bridge classification now runs after all parsed rows are assembled for the config chunk, so mint-side bridge rows are visible to the classifier
• Replay and backfill persistence now updates `flow_type` on existing rows, allowing post-deploy repair of previously ingested bridge-transfer noise

Impact Notes

• Historical price repair now values events from event-day `supply_history` instead of current `price_cache` snapshots
• NULL-price healing and atomic-roundtrip sweeping now use deterministic ordered backlog queries
• The daily digest now shares the same report-card-cache FTQ classification semantics as `/api/mint-burn-flows`
• Per-coin coverage now exposes `adapterKinds`, `startBlockSource`, and `startBlockConfidence` so blanket start-block defaults are visible in the API

Impact Notes

• Added 40 additional Ethereum transfer-based configs for previously uncovered tracked assets
• Extended flow coverage now includes more long-tail fiat, non-USD, commodity, and yield-bearing assets where shared metadata already exposes an Ethereum contract
• Coverage scope increased from 84 contract configs / 83 stablecoin IDs to 124 contract configs / 123 stablecoin IDs while preserving the existing critical-lane set

Impact Notes

• Pressure Shift baseline now excludes the current UTC day and uses the last 30 fully closed daily buckets
• Aggregate `/api/mint-burn-flows?hours=N` now keeps coin-level 24h fields fixed to the canonical 24h window while only the hourly series respects `hours`
• Aggregate flow API now exposes `scope`, `sync`, `windowHours`, and per-coin `coverage` metadata
• The `/flows` page now labels the feature as Ethereum-only and visually marks partial-history or lagging coverage states
• Flow freshness headers now follow successful sync timestamps instead of latest event timestamps, avoiding false staleness during quiet periods

Impact Notes

• Partial event-definition coverage no longer advances sync state past uncovered log ranges
• Missing block timestamps now cap advancement at the earliest unresolved block instead of silently skipping rows forever
• The event API now exposes `flowType` and supports `scope=counted` for rows that participate in aggregates
• Detail-page flow history now excludes bridge burns, review-required burns, and atomic roundtrips by default
• Unpriced event rows now render native token amounts instead of false dollar values
• `minAmount` filtering is now strictly USD-only when `amountUsd` is available

Impact Notes

• Transactions containing both mint and burn for the same token (flash loans, atomic arb) are now flagged as atomic_roundtrip and excluded from all flow aggregates
• Events synced without USD price are now automatically backfilled within 48h by the sync cron
• Coins with less than $50K absolute 24h flow now return NR instead of a potentially misleading pressure shift score
• New observability counters in cron metadata: atomicRoundtripsDetected, nullPricesHealed

Impact Notes

• Per-coin flow UI now separates raw 24h net flow from baseline-relative pressure shift
• API now exposes canonical `pressureShiftScore` and interpretation fields while retaining `flowIntensity` as a deprecated alias
• Frontend printer and shredder visuals now key off actual net flow direction instead of score sign
• Methodology and product copy now distinguish current direction from pressure-versus-baseline context

Impact Notes

• Removed synthetic neutral intensity fallback for sparse no-activity windows
• No-activity windows now return `flowIntensity = null` (NR) instead of `0`
• Bank Run Gauge now excludes those NR windows from the market-cap-weighted composite
• Frontend flow-intensity UI now displays NR explicitly for null values

Impact Notes

• Flow Intensity Score now emits signed values via `clamp(-100, 100, z * 50)`
• Gauge score now uses signed -100 to +100 output with neutral baseline at 0
• Band thresholds were remapped around zero while retaining existing band labels
• Frontend midpoint conversion shim was removed; UI now consumes canonical signed API values directly

Impact Notes

• Added run-state rotation plus per-chain quotas so coverage remains balanced under budget pressure
• Added degraded/error escalation from sustained low coverage or repeated API failures
• Introduced authenticated chunked backfill endpoint (`/api/backfill-mint-burn`) reusing ingestion parsing and aggregation

Impact Notes

• reUSD `Deposited` events now decode with 18 decimals instead of 6
• Removed artificial inflation in reUSD mint flow and related aggregates
• Added regression test validating a known on-chain `Deposited` payload decodes to 10 tokens

Impact Notes

• Event valuation now prefers daily historical prices from `supply_history` at event day
• Price provenance persisted per event (`price_used`, `price_timestamp`, `price_source`)
• Row-drop accounting added for malformed/dust logs to improve data quality observability

Impact Notes

• Replaced Etherscan log ingestion with Alchemy `eth_getLogs`
• Block timestamps now resolved in batch via `eth_getBlockByNumber`, with retry-on-missing semantics
• Scan ranges and safety margins calibrated per chain (including Optimism support)

Impact Notes

• Added reUSD mint and redemption event tracking on Ethereum, Arbitrum, Base, and Avalanche
• Added nth-data-slot amount decoding for non-standard event payload layouts
• Aggregate flow loop now deduplicates by stablecoin ID to prevent duplicated rows and weighted overcounts

Impact Notes

• Safe/risky FTQ buckets now derive from report-card scores (safe >= 65, risky < 50, neutral ignored)
• Static safe-haven sets are now fallback-only for unavailable or stale report-card cache
• Largest-event attribution aligned to requested window semantics in aggregate mode

Impact Notes

• Added `startBlock` per config for near-history initialization instead of scanning from genesis
• USDT now tracks `Issue` and `Redeem` events that do not emit standard `Transfer` mints/burns
• Gauge now computes from available non-null FIS inputs instead of returning null when any coin lacks sufficient history

Impact Notes

• Introduced phase-1 contract coverage for 10 tracked stablecoins
• Shipped FIS formula, seven-band Bank Run Gauge mapping, and flight-to-quality detection thresholds
• Deployed incremental sync cron with `/api/mint-burn-flows` and `/api/mint-burn-events`