┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                            LUX IDENTITY ARCHITECTURE                                    │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                         │
│  DID METHODS                                                                            │
│  ┌─────────────────────────────────────────────────────────────────────────────────┐   │
│  │  did:lux:<identifier>           - Lux Network DID                               │   │
│  │  did:lux:mainnet:<address>      - Mainnet-specific DID                          │   │
│  │  did:lux:testnet:<address>      - Testnet-specific DID                          │   │
│  │  did:ai:<username>           - AI username DID                            │   │
│  │  did:ai:eth:<address>        - AI Ethereum address DID                    │   │
│  └─────────────────────────────────────────────────────────────────────────────────┘   │
│                                        │                                                │
│  ┌─────────────────────────────────────┼───────────────────────────────────────────┐   │
│  │                                     ▼                                            │   │
│  │  ┌─────────────────┐    ┌─────────────────────┐    ┌─────────────────────┐      │   │
│  │  │   DIDRegistry   │    │     DIDDocument     │    │  VerificationMethod │      │   │
│  │  │                 │    │                     │    │                     │      │   │
│  │  │ Create/Update   │───▶│ Controller list     │───▶│ Ed25519/secp256k1   │      │   │
│  │  │ Resolve/Revoke  │    │ Also-known-as       │    │ X25519/BLS          │      │   │
│  │  └─────────────────┘    └─────────────────────┘    └─────────────────────┘      │   │
│  │                                     │                                            │   │
│  │                                     ▼                                            │   │
│  │  ┌─────────────────┐    ┌─────────────────────┐    ┌─────────────────────┐      │   │
│  │  │  DIDResolver    │    │      Services       │    │ PremiumDIDRegistry  │      │   │
│  │  │                 │    │                     │    │                     │      │   │
│  │  │ Cross-chain     │    │ LinkedDomains       │    │ Username auctions   │      │   │
│  │  │ resolution      │    │ CredentialRegistry  │    │ Premium names       │      │   │
│  │  └─────────────────┘    └─────────────────────┘    └─────────────────────┘      │   │
│  └──────────────────────────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────────────────────────┘

import "@luxfi/contracts/identity/DIDRegistry.sol";

DIDRegistry registry = DIDRegistry(DID_REGISTRY_ADDRESS);

// Create DID for msg.sender
// DID format: did:lux:<address>
registry.createDID();

// Create DID with custom identifier
registry.createDIDWithId("my-custom-id");

// Add verification method
registry.addVerificationMethod(
    didHash,
    VerificationMethod({
        id: "did:lux:0x123...#key-1",
        methodType: VerificationMethodType.EcdsaSecp256k1VerificationKey2019,
        controller: "did:lux:0x123...",
        publicKeyMultibase: "zQ3shokFTS3brHcDQrn82RUDfQ23HnBE...",
        publicKeyJwk: ""
    })
);

// Add service endpoint
registry.addService(
    didHash,
    Service({
        id: "did:lux:0x123...#website",
        serviceType: ServiceType.LinkedDomains,
        serviceEndpoint: "https://example.com"
    })
);

import "@luxfi/contracts/identity/DIDResolver.sol";

DIDResolver resolver = DIDResolver(DID_RESOLVER_ADDRESS);

// Resolve DID document
(DIDDocument memory doc, bool found) = resolver.resolve("did:lux:0x123...");

if (found) {
    address controller = doc.controller;
    uint256 updated = doc.updated;
    bool active = doc.active;
}

// Get verification methods
VerificationMethod[] memory methods = resolver.getVerificationMethods(didHash);

// Get services
Service[] memory services = resolver.getServices(didHash);

import "@luxfi/contracts/identity/PremiumDIDRegistry.sol";

PremiumDIDRegistry premium = PremiumDIDRegistry(PREMIUM_REGISTRY_ADDRESS);

// Check availability
bool available = premium.isAvailable("alice");

// Start auction for premium name
premium.startAuction{value: minBid}("alice");

// Place bid
premium.placeBid{value: bidAmount}("alice");

// Claim after auction ends
premium.claimPremiumDID("alice");
// Creates: did:ai:alice

struct DIDDocument {
    string id;                    // did:lux:<identifier>
    address controller;           // Primary controller address
    address[] alsoController;     // Additional controllers
    uint256 created;              // Creation timestamp
    uint256 updated;              // Last update timestamp
    bool active;                  // Active/deactivated status
}

event DIDCreated(bytes32 indexed didHash, string did, address indexed controller);
event DIDUpdated(bytes32 indexed didHash, address indexed updater);
event DIDDeactivated(bytes32 indexed didHash);
event VerificationMethodAdded(bytes32 indexed didHash, string methodId);
event ServiceAdded(bytes32 indexed didHash, string serviceId);
event ControllerChanged(bytes32 indexed didHash, address indexed newController);