Session Management
Manage mDL verification session lifecycle, state, and persistence.
Session Lifecycle
A verification session goes through the following states:
🆕
created
→
⏳
waiting
→
📱
device_engaged
→
⚙️
processing
→
✅
completed
Sessions can also end in these terminal states:
- expired - Session timeout reached
- cancelled - Session cancelled by verifier or holder
- failed - Verification failed (invalid credential, trust issue, etc.)
Session Properties
session-props.tstypescript
Loading...
Retrieving Sessions
Retrieve an existing session by ID or state parameter:
retrieve-sessions.tstypescript
Loading...
Session Events
session-events.tstypescript
Loading...
Session Timeout
session-timeout.tstypescript
Loading...
Cancelling Sessions
cancel-session.tstypescript
Loading...
Session Data Retention
Control how long session data is retained:
data-retention.tstypescript
Loading...
Privacy Note: Only retain session data if required by your use case. Clear data promptly to minimize privacy risks.
Polling for Results
For online verification or custom UI flows, poll for session updates:
polling.tstypescript
Loading...
Server-Side Session Management
server-sessions.tstypescript
Loading...