Skip to main content
SuperVaults User Management — Primary, Secondary, and View Only manager role tabs This page controls vault access. Three tiers are managed here: primary manager (display only), secondary managers (on-chain delegates), and view-only users (off-chain read access). Primary manager access required. The full manager list is fetched from GET /api/v1/users?vault_address={}&chain_id={}&limit=100.

​
Tab 1: Primary Manager

Displays the primary manager’s wallet address and display name. Set at vault creation, immutable without governance-level contract interaction. This key is the root of trust for the vault.

​
Tab 2: Secondary Managers

On-chain delegates with full operational access (except vault settings and user management).

​
Adding

  1. Click Add Secondary Manager
  2. Enter wallet address
  3. Click Prepare — POST /api/v1/users/secondary-manager/prepare → calldata
  4. Sign the on-chain transaction

​
Removing

  1. Click Remove — POST /api/v1/users/secondary-manager/remove/prepare → calldata
  2. Sign the on-chain transaction

​
Updating Display Names

Click the pencil icon to update any user’s display name (off-chain, no gas): 
PATCH /api/v1/users/{wallet_address}/display-name
{ "display_name": "Alice (Operations)" }

​
Tab 3: View Only

Read-only dashboard access. No on-chain transaction required. 
# Add
POST /api/v1/users/view-only
{ "vault_address": "0x...", "chain_id": 8453, "wallet_address": "0x...", "display_name": "Risk Monitor" }

# Remove
DELETE /api/v1/users/view-only/{wallet_address}?vault_address={}&chain_id={}

​
API Reference

EndpointMethodDescription
/api/v1/usersGETAll users for vault
/api/v1/users/secondary-manager/preparePOSTPrepare add tx
/api/v1/users/secondary-manager/remove/preparePOSTPrepare remove tx
/api/v1/users/view-onlyPOSTAdd view-only
/api/v1/users/view-only/{wallet}DELETERemove view-only
/api/v1/users/{wallet}/display-namePATCHUpdate display name

​
User Object

{
  "user": {
    "id": "uuid",
    "wallet_address": "0x...",
    "display_name": "Alice"
  },
  "roles": [
    {
      "vault_address": "0x...",
      "chain_id": 8453,
      "role": "secondary_manager",
      "granted_by": "0xPrimary...",
      "granted_at": "2025-01-15T10:30:00Z"
    }
  ]
}
Add at least one secondary manager before going live. If you lose access to the primary key, secondary managers can continue vault operations.