record_metadata_failure

Documentation for eth_defi.vault.rpc_scan_state.record_metadata_failure function.

record_metadata_failure(pending, observations, address, features, classifier_version, now, category)

Bound candidate retries and move persistent negatives out of the queue.

Unsupported versions and deterministic contract failures are checked weekly. Transient failures receive up to three daily attempts before weekly checks. New classification or explicit force still makes negatives immediately due.

Initial discovery and queue recovery share this transition. The bounded queue avoids repeatedly constructing a known unsupported adapter on every chain tick, while a negative observation with an expiry permits recovery after a contract upgrade or provider repair without replaying event history.

Parameters
  • pending (dict) – Mutable resumable candidate queue.

  • observations (dict) – Mutable metadata status catalogue.

  • address (eth_typing.evm.HexAddress) – Lower-case vault address.

  • features (list[str]) – Sorted current protocol features.

  • classifier_version (str) – Current feature implementation hash.

  • now (datetime.datetime) – Naive UTC failure time.

  • category (str) – Redacted failure category, never provider error text.

Returns

None.

Return type

None