preserve_unreplaced_greylist_rows

Documentation for eth_defi.vault.historical.preserve_unreplaced_greylist_rows function.

preserve_unreplaced_greylist_rows(history, replacements)

Retain saved greylisted vault observations without duplicating successful updates.

The atomic exporter calls this after collecting verified replacement keys. Keeping an old row does not advance its source timestamp or claim freshness. The caller passes only this chain’s greylisted rows in the replaced range, so memory use is bounded by the reviewed targets rather than the full file.

Parameters
  • history (pyarrow.lib.Table) – Saved price table with lower-case string address and integer block_number columns; other columns and metadata are retained.

  • replacements (set[tuple[str, int]]) – (lower_case_address, source_block_number) keys of complete successful new observations for the current chain.

Returns

Original rows whose source keys were not successfully replaced.

Return type

pyarrow.lib.Table