mirror of
https://github.com/sonr-io/sonr.git
synced 2026-09-17 07:26:25 +00:00
82 lines
1.4 KiB
Plaintext
82 lines
1.4 KiB
Plaintext
---
|
|
title: Query Vaults
|
|
description: List secure vaults with optional owner filtering
|
|
seo:
|
|
title: "DWN Vault Listing"
|
|
---
|
|
|
|
:::info
|
|
Users typically have one primary vault, but may have multiple for different security contexts.
|
|
:::
|
|
|
|
## Query Patterns
|
|
|
|
### List My Vaults
|
|
```bash
|
|
?owner=did:sonr:alice
|
|
```
|
|
|
|
### List All Vaults (Governance)
|
|
```bash
|
|
# No filter - requires admin permissions
|
|
?pagination.limit=100
|
|
```
|
|
|
|
## Vault Management
|
|
|
|
:::tip
|
|
Create separate vaults for different security levels (personal, business, high-security).
|
|
:::
|
|
|
|
### Vault Strategy
|
|
|
|
#### Primary Vault
|
|
- Daily operations
|
|
- Standard security
|
|
- Regular key rotation
|
|
|
|
#### High-Security Vault
|
|
- Sensitive operations
|
|
- Enhanced encryption
|
|
- Frequent rotation
|
|
|
|
#### Archive Vault
|
|
- Long-term storage
|
|
- Infrequent access
|
|
- Extended rotation
|
|
|
|
## Vault Creation
|
|
|
|
### Prerequisites
|
|
- `vaultCreationEnabled` must be true
|
|
- Sufficient gas for creation
|
|
- Valid DID or account
|
|
|
|
### Creation Process
|
|
```bash
|
|
# Create new vault
|
|
snrd tx dwn vault-create --from alice
|
|
|
|
# Verify creation
|
|
snrd query dwn vaults --owner did:sonr:alice
|
|
```
|
|
|
|
:::warning
|
|
Vault creation may be disabled by governance. Check module parameters first.
|
|
:::
|
|
|
|
## Pagination
|
|
|
|
### Efficient Queries
|
|
```bash
|
|
# First page
|
|
?owner=did:sonr:alice&pagination.limit=10
|
|
|
|
# Next page
|
|
?owner=did:sonr:alice&pagination.key=<next_key>
|
|
```
|
|
|
|
:::note
|
|
Most users have 1-3 vaults. Pagination is mainly for system-wide queries.
|
|
:::
|