Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.superform.xyz/llms.txt

Use this file to discover all available pages before exploring further.

The Setup page turns a newly-created SuperVault into an operational and discoverable vault. Use it after Create Vault and after any major configuration reset. Use this page to move from created to available: fund upkeep, configure hooks, add yield sources, create strategies, and complete catalog listing.

Checklist rows

RowComplete whenPrimary action
Vault is createdVault exists onchain and is readable in dashboard data.Create Vault
Upkeep is stakedVault is active and can run operational automation.Fund Upkeep
Hooks are set upAt least one hook is configured in the active root config.Configure Hooks
Yield sources are set upAt least one yield source is whitelisted for this vault.Manage Yield Sources
Strategy is set upAt least one strategy exists for this vault.Open Strategy
Vault is live on SuperformVault is listed and available in the Superform catalog.List Vault
Statuses are complete, in_progress, needs_setup, or blocked.

Activation gate

Upkeep is the activation gate. Fund upkeep from Vault Settings → Upkeep to enable automation and discovery. The activation route can deep-link with panel=upkeep&activateVault=1 so the primary manager lands on the funding action. Current Erebor-facing activation fields used by the UI include:
FieldMeaning
activation.is_activeWhether the vault is eligible for keeper operations.
activation.is_discoverableWhether the vault is surfaced in discovery.
activation.statusactive or insufficient_upkeep.
activation.reasonOptional explanation when the vault is not active.
upkeep_info.balanceCurrent upkeep balance, in raw token units.
upkeep_info.threshold.required_balanceRequired balance for activation, in raw token units.
upkeep_info.threshold.shortfallAmount still needed to clear the gate. 0 means the threshold is satisfied.

Catalog evidence

The live-on-Superform row compares the managed vault against catalog data. Evidence includes visibility and availability, for example listed and available. If no matching catalog vault exists, the vault is onchain but not listed in the Superform catalog.

Troubleshooting

SymptomLikely causeNext step
Vault readable but not activeUpkeep shortfall.Fund upkeep.
Hooks count is zeroNo active root config.Draft, activate, generate, and propose a merkle root.
Yield sources count is zeroNothing is whitelisted.Add yield sources and oracles.
Strategy count is zeroNo strategy exists.Create a strategy after adding sources.
Not live on SuperformMissing or unavailable catalog listing.List the vault and set visibility/availability.

Operator rule

Route deposits only after the checklist shows that upkeep, hooks, yield sources, strategies, and listing availability are all complete.