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:

  1. Tutorial 1: Your First DID - Create and understand DIDs (15-20 min)
  2. Tutorial 2: Issuing Your First Credential - Issue and verify credentials (20-25 min)
  3. Tutorial 3: Managing Credentials with Wallets - Store and organize credentials (25-30 min)
  4. Tutorial 4: Building a Complete Workflow - End-to-end issuer-holder-verifier flow (30-35 min)
  5. 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](../getting-started/quick-start.md) - 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:

  1. Tutorial 1: Your First DID (15-20 min)
    • Create and understand DIDs
    • Basic error handling
  2. Tutorial 2: Issuing Your First Credential (20-25 min)
    • Issue and verify credentials
    • Credential structure
  3. Tutorial 3: Managing Credentials with Wallets (25-30 min)
    • Store and organize credentials
    • Wallet features
  4. Tutorial 4: Building a Complete Workflow (30-35 min)
    • End-to-end issuer-holder-verifier flow
    • Presentations
  5. Tutorial 5: Adding Blockchain Anchoring (25-30 min)
    • Anchor data to blockchain
    • Read anchored data

Step 3: Build Real Applications

  • Common Patterns](../getting-started/common-patterns.md) - Production-ready patterns
  • Your First Application](../getting-started/your-first-application.md) - Complete example

Step 4: Deepen Knowledge

  • Core Concepts](../core-concepts/README.md) - Deep dives
  • Advanced Tutorials](#advanced-tutorials) - Specific topics
  • API Reference](../api-reference/core-api.md) - Complete API docs

For Experienced Developers

Quick Path:

  1. Review Quick Start Guide for API overview
  2. Jump to specific tutorials based on your use case:
  3. Reference API Reference as needed

Production Ready:

  1. Review Common Patterns for TrustWeave-specific patterns
  2. Study Scenarios for your use case
  3. Consult Error Handling for production patterns

Next Steps

After completing tutorials:

Ready to build?

  • Use Case Scenarios](../scenarios/README.md) - 25+ real-world examples with complete code
  • Common Patterns](../getting-started/common-patterns.md) - Production-ready patterns
  • Your First Application](../getting-started/your-first-application.md) - Complete example

Want to go deeper?

  • Core Concepts](../core-concepts/README.md) - Deep dives into DIDs, credentials, wallets
  • API Reference](../api-reference/README.md) - Complete API documentation
  • Advanced Topics](../advanced/README.md) - Key rotation, verification policies, custom adapters

Need to complete a specific task?

  • How-To Guides](../how-to/README.md) - Task-oriented guides for common operations

Production deployment?

  • Production Deployment](../getting-started/production-deployment.md) - Best practices
  • Error Handling](../advanced/error-handling.md) - Error handling patterns
  • Verification Policies](../advanced/verification-policies.md) - Verification strategies
This site uses Just the Docs, a documentation theme for Jekyll.