Register an Existing stVault

If you have created a stVault outside of the SVM (e.g. directly through the Lido contracts or via another interface), you can register it with the SVM to manage it from your dashboard.

Before registration can succeed, the vault must meet a set of on-chain eligibility criteria. If you are using the API directly, each failed check returns an encoded transaction that you can submit to fix the issue. If you are using the SVM frontend, the registration will fail with an error message — you will need to submit the corrective transactions independently (e.g. via Etherscan or your own tooling) and retry registration once the vault is compliant.

1. Eligibility Criteria

A stVault created outside of the SVM is eligible for registration if it meets all of the following criteria:

Node Operator

• The vault's node operator must be a supported node operator recognized by the SVM. The node operator is read from the staking vault contract and matched against the SVM's operator registry.
• The node operator must be allowed for your account. Not all users have access to all supported operators — contact Northstake if your operator is not available.

Vault Configuration

• The PDG policy must be set to 2 on the dashboard contract. If the policy is incorrect, the API will return the transaction needed to update it.
• The vault must be connected to the Vault Hub. Vaults that are disconnected or in the process of disconnecting cannot be registered. If the vault is not connected, the API will return the transaction to connect it (requires sending 1 ETH).

Required Roles

The SVM's smart contract controller address must be granted the following three roles on the dashboard contract:

• NODE_OPERATOR_PROVE_UNKNOWN_VALIDATOR_ROLE
• NODE_OPERATOR_MANAGER_ROLE
• NODE_OPERATOR_FEE_EXEMPT_ROLE

If any role is missing, the API will return a 400 response with the encoded grantRole transaction you need to submit.

Vault Type

• Only dedicated vaults can be registered by standard users. Pool vaults (STV and STV stETH) require a Pro SVM account.

2. Provide Vault Information

To register an existing vault:

• Enter a Vault Name.
• Input either the on-chain staking vault address or its connected dashboard address. The API accepts both — if you provide a staking vault address, the dashboard is resolved automatically via the Vault Hub.
• Click Next to proceed.

3. Review and Confirm

Review the vault details retrieved from the contract.

Since the vault already exists on-chain:

• No new contract will be deployed.
• Registration only links the vault to your dashboard for monitoring and operational actions.

4. Dashboard Access

Once confirmed, the vault will appear in your dashboard where you can:

• View metrics
• Manage permissions (if you are an admin)
• Perform supported vault actions