Admin: Backfill & Maintenance

The Admin page provides data backfill utilities for Erebor’s historical analytics. Use these when vault data is missing from the analytics database: after onboarding a vault with existing onchain history, or after a data pipeline incident.

Backfill operations are long-running (up to 120s per request). The API client timeout is overridden accordingly. Requires registry_maintainer permission.

Backfill Types

APY Backfill

Recomputes and stores APY snapshots for a vault over a specified date range. Max 90 days.

POST /api/v1/admin/backfill/apy
{ "chain_id": 8453, "vault_address": "0x...", "days": 30 }

Response:

{
  "snapshots_updated": 28,
  "snapshots_failed": 2,
  "snapshots_skipped": 0,
  "errors": ["2025-01-03: missing PPS data for this date"]
}

TVL Backfill

Recomputes and stores TVL snapshots. Max 90 days.

POST /api/v1/admin/backfill/tvl
{ "chain_id": 8453, "vault_address": "0x...", "days": 30 }

Response:

{
  "days_backfilled": 29,
  "days_failed": 1,
  "days_requested": 30,
  "errors": ["2025-01-15: RPC error fetching block"]
}

Events Backfill

Re-indexes deposit, withdrawal, and other onchain events. Max 365 days.

POST /api/v1/admin/backfill/events
{ "chain_id": 8453, "vault_address": "0x...", "days": 90 }

Response:

{
  "deposits_found": 142,
  "withdrawals_found": 38,
  "events_created": 178,
  "events_skipped_duplicate": 2
}

Using the UI

Select backfill type (APY, TVL, or Events)
Select chain and vault
Choose days (presets: 7, 30, 90; Events adds 365)
Click Run Backfill and wait for results (up to 120s)
Review the results summary (updated/failed/skipped counts)

Backfills can spike database load. Run during off-peak hours. Do not run concurrent backfills for the same vault.

API Reference

Endpoint	Method	Timeout	Description
`/api/v1/admin/backfill/apy`	POST	120s	APY snapshots (max 90 days)
`/api/v1/admin/backfill/tvl`	POST	120s	TVL snapshots (max 90 days)
`/api/v1/admin/backfill/events`	POST	120s	On-chain events (max 365 days)

⌘I

Getting Started

Vault Setup

Vault Operations

Strategy Authoring

Access & Settings

Registry & Admin

Safety & Incident Response

API Reference

Automation

Admin: Backfill & Maintenance

Backfill Types

APY Backfill

TVL Backfill

Events Backfill

Using the UI

API Reference

​Backfill Types

​APY Backfill

​TVL Backfill

​Events Backfill

​Using the UI

​API Reference

Backfill Types

APY Backfill

TVL Backfill

Events Backfill

Using the UI

API Reference