v0.3.0
v0.3.0
Highlights
- Reader role — new context-scoped read-only role for observing keys, contexts, and DIDs without write access. Every endpoint is now classified as read, write, or manage.
- Integration module (
vta_sdk::integration) — one-callstartup()for services that manage their DID and secrets through a VTA, with offline resilience via a pluggableSecretCachetrait. - Integration guide — new docs/integration-guide.md for 3rd-party developers.
- GitHub Actions CI — automated check, test, clippy, and fmt on every push and PR.
Role Hierarchy
Super Admin > Admin > Initiator > Application > Reader > Monitor
| Action | Minimum Role |
|---|---|
| Read keys, contexts, DIDs, config | Reader |
| Sign, cache write/delete | Application |
| ACL management, credentials | Initiator |
| Key create/delete/import, seeds, audit | Admin |
| Config update, context CRUD, backup, restart | Super Admin |
| Metrics and health only | Monitor |
What's Changed
Features
- Reader role with read/write action classification
- VTA SDK integration module with
startup(),SecretCache, andauthenticate() - Key labels used as verification method IDs in
fetch_did_secrets_bundle() - Lightweight DIDComm auth (
auth_light) without ATM/TDK runtime VtaClient::from_credential()with automatic token refreshKeyspacesstruct andDIDCommSendParamsfor cleaner operation signatures
Security
- 17 DIDComm handlers fixed with explicit role checks matching REST counterparts
- Sign and cache write endpoints tightened to require Application+
- Backup export route uses SuperAdminAuth extractor
- VTC key material zeroization with proper error propagation
- Session backend errors now logged instead of silently swallowed
Architecture
- Shared
SeedStoretrait extracted tovti-common - Workspace dependencies consolidated (
ed25519-dalek,dialoguer,chrono) - HTTP client reuse in
auth_lightfor connection pooling WebvhClientrefactored withsend()/with_auth()helpers- Zero clippy warnings across the entire workspace
Testing & CI
- 263 tests (up from ~230), zero failures
- GitHub Actions CI with parallel check, test, clippy (
-D warnings), fmt jobs - Operation-level unit tests for
create_key,sign_payload,rotate_seed
Documentation
- Integration guide for 3rd-party developers
- Updated security architecture with role hierarchy and action categories
- Comprehensive changelog
Full Changelog: v0.2.1...v0.3.0