Configuration
Configure the TypeScript mDL SDK for your environment and requirements.
Configuration Options
The OwlEyesMDL constructor accepts a configuration object with the following options:
| Option | Type | Default | Description |
|---|---|---|---|
apiKey | string | Required | Your Owl Eyes API key |
environment | 'sandbox' | 'production' | 'sandbox' | API environment |
trustAnchorSource | TrustAnchorSource | 'aamva_vical' | Trust anchor registry source |
timeout | number | 30000 | Default timeout in milliseconds |
retryConfig | RetryConfig | See below | Retry configuration |
logging | LoggingConfig | See below | Logging configuration |
Full Configuration Example
config.tstypescript
Loading...
Trust Anchor Sources
Trust anchors are the root certificates used to validate mDL issuer certificates. The SDK supports multiple trust anchor sources:
| Source | Description | Coverage |
|---|---|---|
'aamva_vical' | AAMVA Vehicle Identification Certificate Authority List | United States and Canada |
'eu_trust_list' | European Union Trust List (eIDAS 2.0) | European Union member states |
'combined' | Both AAMVA VICAL and EU Trust List | Global coverage |
custom | Custom trust anchor URL | Your organization's trust anchors |
Recommendation: Use
'aamva_vical' for US/Canada deployments,'eu_trust_list' for EU deployments, or 'combined' for international applications.Environment Variables
We recommend storing sensitive configuration in environment variables:
.env.localbash
Loading...
config.tstypescript
Loading...
Initialization
After creating the verifier instance, call init() to initialize the SDK. This preloads trust anchors and validates your API key:
init.tstypescript
Loading...
Important: Always call
init() and await its completion before creating sessions or performing verifications.