DID API

GET /did/:did

Resolve a did:sol identifier to an agent record and DID Document.

GET /did/:did/document

W3C DID Document only. Returns Content-Type: application/did+ld+json.

Example Responses

GET /did/:did

Response
{
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "agent": {
    "pda": "BKq8rN4EwJQG3R9FnLhSGqJ2tNkh8cVRxvNApj7hbfQM",
    "owner": "7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "name": "CommerceBot",
    "tier": "standard",
    "status": "active",
    "reputation_score": 720,
    "agent_card_url": "https://commercebot.example/.well-known/agent.json"
  },
  "didDocument": {
    "@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/suites/ed25519-2020/v1"],
    "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "controller": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "verificationMethod": [{ "id": "...#key-1", "type": "Ed25519VerificationKey2020" }],
    "authentication": ["...#key-1"],
    "assertionMethod": ["...#key-1"],
    "service": [
      { "id": "...#agent-card", "type": "A2AAgentCard", "serviceEndpoint": "https://commercebot.example/.well-known/agent.json", "description": "A2A Agent Card for capability discovery" },
      { "id": "...#vouch-registry", "type": "VouchRegistry", "serviceEndpoint": "solana:5i73FN7Ycgnh9dr2Yzf3oFiTCKhu85JPpTUbZ84VPtu4:BKq8rN4EwJQG3R9FnLhSGqJ2tNkh8cVRxvNApj7hbfQM", "description": "On-chain Vouch identity PDA" }
    ]
  }
}

GET /did/:did/document

Response (application/did+ld+json)
{
  "@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/suites/ed25519-2020/v1"],
  "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "controller": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "verificationMethod": [{
    "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1",
    "type": "Ed25519VerificationKey2020",
    "controller": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "publicKeyBase58": "7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr"
  }],
  "authentication": ["did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1"],
  "assertionMethod": ["did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1"],
  "service": [
    {
      "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#agent-card",
      "type": "A2AAgentCard",
      "serviceEndpoint": "https://commercebot.example/.well-known/agent.json",
      "description": "A2A Agent Card for capability discovery"
    },
    {
      "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#vouch-registry",
      "type": "VouchRegistry",
      "serviceEndpoint": "solana:5i73FN7Ycgnh9dr2Yzf3oFiTCKhu85JPpTUbZ84VPtu4:BKq8rN4EwJQG3R9FnLhSGqJ2tNkh8cVRxvNApj7hbfQM",
      "description": "On-chain Vouch identity PDA"
    }
  ]
}