Tutorials
The tutorials in this section walk through complete TrustWeave workflows, showing how typed options, DSLs, and Result-based responses fit together in runnable Kotlin.
Tutorial Series
Beginner Tutorial Series
Beginner Tutorial Series - Start here if you’re new to TrustWeave or decentralized identity:
- Tutorial 1: Your First DID - Create and understand DIDs (15-20 min)
- Tutorial 2: Issuing Your First Credential - Issue and verify credentials (20-25 min)
- Tutorial 3: Managing Credentials with Wallets - Store and organize credentials (25-30 min)
- Tutorial 4: Building a Complete Workflow - End-to-end issuer-holder-verifier flow (30-35 min)
- Tutorial 5: Adding Blockchain Anchoring - Anchor data for tamper evidence (25-30 min)
This series provides a structured learning path from zero to building production-ready applications.
Advanced Tutorials
DID Operations
DID Operations Tutorial - Comprehensive guide to DID operations:
- Creating DIDs with different methods
- Resolving DIDs
- Updating and deactivating DIDs
- Working with multiple DID methods
- Advanced DID operations
Wallet API
Wallet API Tutorial - Complete guide to using wallets:
- Creating wallets with different providers
- Storing and organizing credentials
- Querying credentials
- Creating presentations
- Lifecycle management
Credential Issuance
Credential Issuance Tutorial - Deep dive into credential issuance:
- Issuance workflows
- Credential types and structures
- Proof generation
- Best practices
Prerequisites
Before diving in:
- Install TrustWeave by following the installation guide.
- Be comfortable with Kotlin coroutines and the
Result-returning facade APIs. - For beginners: Start with the Beginner Tutorial Series.
- For experienced developers: Jump to specific advanced tutorials.
Learning Path
For New Developers
Step 1: Complete Quick Start (5 minutes)
- Quick Start Guide - Verify installation and run first example
Step 2: Beginner Tutorial Series (2+ hours) Start with Beginner Tutorial Series and complete all 5 tutorials in order:
- Tutorial 1: Your First DID (15-20 min)
- Create and understand DIDs
- Basic error handling
- Tutorial 2: Issuing Your First Credential (20-25 min)
- Issue and verify credentials
- Credential structure
- Tutorial 3: Managing Credentials with Wallets (25-30 min)
- Store and organize credentials
- Wallet features
- Tutorial 4: Building a Complete Workflow (30-35 min)
- End-to-end issuer-holder-verifier flow
- Presentations
- Tutorial 5: Adding Blockchain Anchoring (25-30 min)
- Anchor data to blockchain
- Read anchored data
Step 3: Build Real Applications
- Common Patterns - Production-ready patterns
- Your First Application - Complete example
Step 4: Deepen Knowledge
- Core Concepts - Deep dives
- Advanced Tutorials - Specific topics
- API Reference - Complete API docs
For Experienced Developers
Quick Path:
- Review Quick Start Guide for API overview
- Jump to specific tutorials based on your use case:
- DID Operations: DID Operations Tutorial
- Wallets: Wallet API Tutorial
- Credential Issuance: Credential Issuance Tutorial
- Reference API Reference as needed
Production Ready:
- Review Common Patterns for TrustWeave-specific patterns
- Study Scenarios for your use case
- Consult Error Handling for production patterns
Next Steps
After completing tutorials:
Ready to build?
- Use Case Scenarios - 25+ real-world examples with complete code
- Common Patterns - Production-ready patterns
- Your First Application - Complete example
Want to go deeper?
- Core Concepts - Deep dives into DIDs, credentials, wallets
- API Reference - Complete API documentation
- Advanced Topics - Key rotation, verification policies, custom adapters
Need to complete a specific task?
- How-To Guides - Task-oriented guides for common operations
Production deployment?
- Production Deployment - Best practices
- Error Handling - Error handling patterns
- Verification Policies - Verification strategies