> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.adid.dev/llms.txt.
> For full documentation content, see https://docs.adid.dev/llms-full.txt.

# DID Lifecycle States

**Used in:** §3.1 DID overview, §12.4 DID Operations
**Audience:** Holder, Backend Developer, SC Developer
**IA ID:** D2

```mermaid
stateDiagram-v2
  [*] --> Created: createDID(did, didDocument)
  Created --> Active: indexed by API and chain
  Active --> Active: updateDID / setAttribute / addDelegate
  Active --> KeyRotated: rotateKey
  KeyRotated --> Active
  Active --> Deactivated: deactivateDID
  Deactivated --> [*]

  note right of Active
    Resolvable via:
    GET /api/v1/dids/{did}
    GET /api/v1/dids/resolve/{did}
  end note
  note right of Deactivated
    Document still resolvable
    but flagged deactivated=true
    per W3C DID Core
  end note
```

**Reading guide:** This is the canonical state diagram for the DID's logical lifecycle. The `KeyRotated` state is transient — the DID stays Active but the verificationMethod set has been replaced.

***