# IDA — Identity for the AI Age | Documentation ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.adid.dev/_mcp/server ## Docs - [What is IDA](https://docs.adid.dev/introduction/overview.md) - [Why Decentralized Identity](https://docs.adid.dev/introduction/why-decentralized-identity.md) - [Standards & Compliance](https://docs.adid.dev/introduction/standards.md) - [Platform Architecture](https://docs.adid.dev/introduction/architecture.md) - [ADI Blockchain Primer](https://docs.adid.dev/introduction/adi-blockchain.md) - [Quick Start](https://docs.adid.dev/getting-started/quickstart.md) - [Create an Account](https://docs.adid.dev/getting-started/create-account.md) - [Your First DID](https://docs.adid.dev/getting-started/first-did.md) - [Local Development Setup](https://docs.adid.dev/getting-started/development.md) - [Holders Overview](https://docs.adid.dev/holders/overview.md) - [Creating a DID](https://docs.adid.dev/holders/create-did.md) - [DID Document Schema](https://docs.adid.dev/holders/did-document.md) - [did:adi Method Specification](https://docs.adid.dev/holders/did-specification.md) - [DID Operations](https://docs.adid.dev/holders/operations.md) - [Key Types & Algorithms](https://docs.adid.dev/holders/cryptography.md) - [Rotate Key](https://docs.adid.dev/holders/rotate-key.md) - [Deactivate a DID](https://docs.adid.dev/holders/deactivate-did.md) - [DID Delegates](https://docs.adid.dev/holders/delegates.md) - [DID Attributes](https://docs.adid.dev/holders/attributes.md) - [Universal DID Resolver](https://docs.adid.dev/holders/resolver.md) - [VC Data Model](https://docs.adid.dev/holders/vc-data-model.md) - [Receive a Credential](https://docs.adid.dev/holders/receive-credential.md) - [Create a Verifiable Presentation](https://docs.adid.dev/holders/create-presentation.md) - [Check Revocation Status](https://docs.adid.dev/holders/check-status.md) - [Verification Flow](https://docs.adid.dev/holders/vc-verification.md) - [Zero-Knowledge Identity](https://docs.adid.dev/holders/zk-identity.md) - [Generate a ZK Proof](https://docs.adid.dev/holders/generate-zkp.md) - [Share & Anchor a ZK Proof](https://docs.adid.dev/holders/share-anchor-zkp.md) - [Trust Explorer](https://docs.adid.dev/holders/trust-explorer.md) - [Issuers Overview](https://docs.adid.dev/issuers/overview.md) - [Issuer Onboarding](https://docs.adid.dev/issuers/onboarding.md) - [Credential Schemas](https://docs.adid.dev/issuers/schemas.md) - [Schema Management](https://docs.adid.dev/issuers/schema-management.md) - [Create a Schema](https://docs.adid.dev/issuers/create-schema.md) - [Issuance Flow](https://docs.adid.dev/issuers/issuance.md) - [Single Issuance](https://docs.adid.dev/issuers/single-issuance.md) - [Bulk Issuance](https://docs.adid.dev/issuers/bulk-issuance.md) - [Revocation Management](https://docs.adid.dev/issuers/revocation-management.md) - [Batch Revocation](https://docs.adid.dev/issuers/batch-revocation.md) - [Issuer Analytics](https://docs.adid.dev/issuers/analytics.md) - [Verifiers Overview](https://docs.adid.dev/verifiers/overview.md) - [Verifier Onboarding](https://docs.adid.dev/verifiers/onboarding.md) - [Proof Request Builder](https://docs.adid.dev/verifiers/proof-request-builder.md) - [Verification Engine](https://docs.adid.dev/verifiers/verification-engine.md) - [Verification History](https://docs.adid.dev/verifiers/history.md) - [Trust Framework](https://docs.adid.dev/verifiers/trust-framework.md) - [Trusted Issuers Registry](https://docs.adid.dev/verifiers/trusted-issuers.md) - [AI Agent Identity - Overview](https://docs.adid.dev/agents/overview.md) - [Agent DID Specification](https://docs.adid.dev/agents/agent-did.md) - [Deploy an Agent](https://docs.adid.dev/agents/deploy.md) - [Agent Detail & Lifecycle](https://docs.adid.dev/agents/detail.md) - [Delegation Chains](https://docs.adid.dev/agents/delegation.md) - [Capability Tokens (IBCT)](https://docs.adid.dev/agents/ibct.md) - [Capability Tokens (IBCT)](https://docs.adid.dev/agents/capability-tokens.md) - [Agent Trust Registry](https://docs.adid.dev/agents/trust-registry.md) - [Agent Discovery & Cards](https://docs.adid.dev/agents/discovery.md) - [MCP-I Integration](https://docs.adid.dev/agents/mcp-integration.md) - [A2A Protocol Support](https://docs.adid.dev/agents/a2a-support.md) - [Agent Marketplace](https://docs.adid.dev/agents/marketplace.md) - [Agent Audit Log](https://docs.adid.dev/agents/audit-log.md) - [DIDComm v2 Overview](https://docs.adid.dev/didcomm/overview.md) - [Connections & Invitations](https://docs.adid.dev/didcomm/connections.md) - [Send & Receive Messages](https://docs.adid.dev/didcomm/send-receive.md) - [Messages & Threads](https://docs.adid.dev/didcomm/messages.md) - [DIDComm Service Endpoints](https://docs.adid.dev/didcomm/service-endpoints.md) - [DIDComm Encryption](https://docs.adid.dev/didcomm/encryption.md) - [Wallet Architecture (MPC)](https://docs.adid.dev/wallet/architecture.md) - [Wallet Onboarding](https://docs.adid.dev/wallet/onboarding.md) - [Holding Credentials](https://docs.adid.dev/wallet/credentials.md) - [ZK Proofs from Mobile](https://docs.adid.dev/wallet/zkp.md) - [Wallet Security](https://docs.adid.dev/wallet/security.md) - [Backup & Recovery](https://docs.adid.dev/wallet/recovery.md) - [Installing the SDK](https://docs.adid.dev/sdk/install.md) - [IDAClient](https://docs.adid.dev/sdk/client.md) - [SDK Reference](https://docs.adid.dev/sdk/reference.md) - [SDK — DID Operations](https://docs.adid.dev/sdk/did-ops.md) - [SDK — Credential Operations](https://docs.adid.dev/sdk/credential-ops.md) - [SDK — Agent Operations](https://docs.adid.dev/sdk/agent-ops.md) - [SDK — ZKP Operations](https://docs.adid.dev/sdk/zkp-ops.md) - [SDK — Crypto Helpers](https://docs.adid.dev/sdk/crypto.md) - [End-to-End Examples](https://docs.adid.dev/sdk/examples.md) - [Deployment Map](https://docs.adid.dev/contracts/deployment-map.md) - [DID Registry Smart Contract](https://docs.adid.dev/contracts/did-registry.md) - [Schema Registry Smart Contract](https://docs.adid.dev/contracts/schema-registry.md) - [Revocation Registry Smart Contract](https://docs.adid.dev/contracts/revocation-registry.md) - [Agent Trust Registry Smart Contract](https://docs.adid.dev/contracts/agent-trust-registry.md) - [ZKProofVerifier](https://docs.adid.dev/contracts/zk-proof-verifier.md) - [did:adi Method Specification](https://docs.adid.dev/standards/did-method.md) - [Key Types & Algorithms](https://docs.adid.dev/standards/cryptography.md) - [VC Data Model](https://docs.adid.dev/standards/vc-data-model.md) - [Bitstring Status List 2021](https://docs.adid.dev/standards/status-list-2021.md) - [RBAC Overview](https://docs.adid.dev/rbac/overview.md) - [Permission Matrix](https://docs.adid.dev/rbac/permission-matrix.md) - [Server-Side Enforcement](https://docs.adid.dev/rbac/server-enforcement.md) - [JWT Lifecycle](https://docs.adid.dev/rbac/jwt-lifecycle.md) - [API Key Management](https://docs.adid.dev/rbac/api-keys.md) - [CORS, Rate Limiting, Audit](https://docs.adid.dev/rbac/security-controls.md) - [System Requirements](https://docs.adid.dev/deployment/system-requirements.md) - [Docker Setup](https://docs.adid.dev/deployment/docker.md) - [Kubernetes Deployment](https://docs.adid.dev/deployment/kubernetes.md) - [Configuration](https://docs.adid.dev/deployment/configuration.md) - [Environment Variables](https://docs.adid.dev/deployment/env-vars.md) - [Migrations & Seed](https://docs.adid.dev/deployment/migrations-seed.md) - [Contract Deployment](https://docs.adid.dev/deployment/contract-deployment.md) - [Observability](https://docs.adid.dev/deployment/observability.md) - [Backups & Disaster Recovery](https://docs.adid.dev/deployment/backups-dr.md) - [Scaling Notes](https://docs.adid.dev/deployment/scaling-notes.md) - [Common Errors](https://docs.adid.dev/troubleshooting/common-errors.md) - [FAQ](https://docs.adid.dev/troubleshooting/faq.md) - [Glossary](https://docs.adid.dev/glossary.md) - [Architecture & Diagrams](https://docs.adid.dev/architecture/overview.md) - [System Architecture](https://docs.adid.dev/architecture/system-architecture.md) - [Component Layering (Clean Architecture)](https://docs.adid.dev/architecture/component-layering.md) - [DID Lifecycle States](https://docs.adid.dev/architecture/did-lifecycle.md) - [DID Create Sequence](https://docs.adid.dev/architecture/did-create-sequence.md) - [DID Resolve Sequence](https://docs.adid.dev/architecture/did-resolve-sequence.md) - [DID Key Rotation Sequence](https://docs.adid.dev/architecture/did-key-rotation-sequence.md) - [DID Document Anatomy](https://docs.adid.dev/architecture/did-document-anatomy.md) - [VC Issuance Flow](https://docs.adid.dev/architecture/vc-issuance-flow.md) - [VC Bulk Issuance Pipeline](https://docs.adid.dev/architecture/vc-bulk-issuance.md) - [VC Verification Flow](https://docs.adid.dev/architecture/vc-verification-flow.md) - [VC Revocation (Status List 2021)](https://docs.adid.dev/architecture/vc-revocation-statuslist.md) - [ZKP Generation](https://docs.adid.dev/architecture/zkp-generation.md) - [ZKP Verification + On-Chain Anchoring](https://docs.adid.dev/architecture/zkp-verification-anchoring.md) - [Agent Delegation Chain](https://docs.adid.dev/architecture/agent-delegation-chain.md) - [Agent Autonomy Ladder](https://docs.adid.dev/architecture/agent-autonomy-ladder.md) - [IBCT Capability Token Structure](https://docs.adid.dev/architecture/ibct-structure.md) - [MCP-I Integration Sequence](https://docs.adid.dev/architecture/mcp-integration-sequence.md) - [A2A Handshake](https://docs.adid.dev/architecture/a2a-handshake.md) - [DIDComm Connection Invitation Flow](https://docs.adid.dev/architecture/didcomm-invitation-flow.md) - [DIDComm v2 Envelope](https://docs.adid.dev/architecture/didcomm-envelope.md) - [Wallet MPC Topology](https://docs.adid.dev/architecture/wallet-mpc-topology.md) - [Deployment Topology — Docker Compose](https://docs.adid.dev/architecture/deployment-docker.md) - [Deployment Topology — Kubernetes](https://docs.adid.dev/architecture/deployment-kubernetes.md) - [RBAC Permission Matrix](https://docs.adid.dev/architecture/rbac-permission-matrix.md) - [JWT Lifecycle](https://docs.adid.dev/architecture/jwt-lifecycle.md) - [Smart-Contract Registry Interaction Map](https://docs.adid.dev/architecture/contracts-interaction-map.md) - [Trust Framework Mapping](https://docs.adid.dev/architecture/trust-framework-mapping.md) - [OAuth + DID-Auth Login Flows](https://docs.adid.dev/architecture/oauth-did-auth-login.md) - [Trust Scoring Data Flow](https://docs.adid.dev/architecture/trust-scoring-dataflow.md) - [Database ER (core entities)](https://docs.adid.dev/architecture/er-diagram-core.md) - [Issuer Analytics Data Flow](https://docs.adid.dev/architecture/issuer-analytics-dataflow.md) ## API Docs - REST API > Health [Liveness probe](https://docs.adid.dev/api-reference/rest-api/health/liveness-probe.md) - REST API > Health [Readiness probe](https://docs.adid.dev/api-reference/rest-api/health/readiness-probe.md) - REST API > Health [Platform-level Agent Card](https://docs.adid.dev/api-reference/rest-api/health/platform-level-agent-card.md) - REST API > Auth [Register a new account (sends OTP)](https://docs.adid.dev/api-reference/rest-api/auth/register-a-new-account-sends-otp.md) - REST API > Auth [Send OTP to existing account](https://docs.adid.dev/api-reference/rest-api/auth/send-otp-to-existing-account.md) - REST API > Auth [Verify OTP (or DID-Auth signature) and receive a JWT](https://docs.adid.dev/api-reference/rest-api/auth/verify-otp-or-did-auth-signature-and-receive-a-jwt.md) - REST API > Auth [Exchange a refresh token for a new access token](https://docs.adid.dev/api-reference/rest-api/auth/exchange-a-refresh-token-for-a-new-access-token.md) - REST API > Auth [Generate a DID-Auth challenge nonce](https://docs.adid.dev/api-reference/rest-api/auth/generate-a-did-auth-challenge-nonce.md) - REST API > Auth [Begin OAuth login](https://docs.adid.dev/api-reference/rest-api/auth/begin-o-auth-login.md) - REST API > Auth [OAuth callback that issues a JWT](https://docs.adid.dev/api-reference/rest-api/auth/o-auth-callback-that-issues-a-jwt.md) - REST API > Auth [Authenticated user profile](https://docs.adid.dev/api-reference/rest-api/auth/authenticated-user-profile.md) - REST API > Auth [Read embedded wallet metadata](https://docs.adid.dev/api-reference/rest-api/auth/read-embedded-wallet-metadata.md) - REST API > Di Ds [List your DIDs](https://docs.adid.dev/api-reference/rest-api/di-ds/list-your-di-ds.md) - REST API > Di Ds [Create a DID](https://docs.adid.dev/api-reference/rest-api/di-ds/create-a-did.md) - REST API > Di Ds [Resolve a DID](https://docs.adid.dev/api-reference/rest-api/di-ds/resolve-a-did.md) - REST API > Di Ds [Update a DID Document](https://docs.adid.dev/api-reference/rest-api/di-ds/update-a-did-document.md) - REST API > Di Ds [Deactivate a DID](https://docs.adid.dev/api-reference/rest-api/di-ds/deactivate-a-did.md) - REST API > Di Ds [Rotate the verification key](https://docs.adid.dev/api-reference/rest-api/di-ds/rotate-the-verification-key.md) - REST API > Di Ds [List delegates](https://docs.adid.dev/api-reference/rest-api/di-ds/list-delegates.md) - REST API > Di Ds [Add a delegate](https://docs.adid.dev/api-reference/rest-api/di-ds/add-a-delegate.md) - REST API > Di Ds [Revoke a delegate](https://docs.adid.dev/api-reference/rest-api/di-ds/revoke-a-delegate.md) - REST API > Di Ds [Set an attribute](https://docs.adid.dev/api-reference/rest-api/di-ds/set-an-attribute.md) - REST API > Di Ds [Revoke an attribute](https://docs.adid.dev/api-reference/rest-api/di-ds/revoke-an-attribute.md) - REST API > Di Ds [Universal DID resolver (did:adi, did:web, did:key, did:ethr)](https://docs.adid.dev/api-reference/rest-api/di-ds/universal-did-resolver-did-adi-did-web-did-key-did-ethr.md) - REST API > Schemas [List schemas](https://docs.adid.dev/api-reference/rest-api/schemas/list-schemas.md) - REST API > Schemas [Create a schema (issuer role required)](https://docs.adid.dev/api-reference/rest-api/schemas/create-a-schema-issuer-role-required.md) - REST API > Schemas [Get a schema](https://docs.adid.dev/api-reference/rest-api/schemas/get-a-schema.md) - REST API > Credentials [List credentials issued or held](https://docs.adid.dev/api-reference/rest-api/credentials/list-credentials-issued-or-held.md) - REST API > Credentials [Get a credential by ID](https://docs.adid.dev/api-reference/rest-api/credentials/get-a-credential-by-id.md) - REST API > Credentials [Status List 2021 revocation status](https://docs.adid.dev/api-reference/rest-api/credentials/status-list-2021-revocation-status.md) - REST API > Credentials [Issue a credential (issuer role required)](https://docs.adid.dev/api-reference/rest-api/credentials/issue-a-credential-issuer-role-required.md) - REST API > Credentials [Verify a credential](https://docs.adid.dev/api-reference/rest-api/credentials/verify-a-credential.md) - REST API > Credentials [Revoke a credential (issuer role required)](https://docs.adid.dev/api-reference/rest-api/credentials/revoke-a-credential-issuer-role-required.md) - REST API > Credentials [Batch revoke (max 100 per call)](https://docs.adid.dev/api-reference/rest-api/credentials/batch-revoke-max-100-per-call.md) - REST API > Presentations [Create a Verifiable Presentation](https://docs.adid.dev/api-reference/rest-api/presentations/create-a-verifiable-presentation.md) - REST API > Presentations [Verify a Verifiable Presentation](https://docs.adid.dev/api-reference/rest-api/presentations/verify-a-verifiable-presentation.md) - REST API > Zkp [Issue a server nonce for ZK proof binding](https://docs.adid.dev/api-reference/rest-api/zkp/issue-a-server-nonce-for-zk-proof-binding.md) - REST API > Zkp [List your ZK proofs](https://docs.adid.dev/api-reference/rest-api/zkp/list-your-zk-proofs.md) - REST API > Zkp [Submit a generated ZK proof](https://docs.adid.dev/api-reference/rest-api/zkp/submit-a-generated-zk-proof.md) - REST API > Zkp [Get a proof](https://docs.adid.dev/api-reference/rest-api/zkp/get-a-proof.md) - REST API > Zkp [Verify a ZK proof](https://docs.adid.dev/api-reference/rest-api/zkp/verify-a-zk-proof.md) - REST API > Zkp [Read the anchor record for a proof](https://docs.adid.dev/api-reference/rest-api/zkp/get-anchor.md) - REST API > Zkp [Anchor a ZK proof on-chain](https://docs.adid.dev/api-reference/rest-api/zkp/anchor-zk-proof.md) - REST API > Zkp [Revoke a previously-anchored ZK proof](https://docs.adid.dev/api-reference/rest-api/zkp/revoke-zk-proof.md) - REST API > Zkp [List anchor records (paginated)](https://docs.adid.dev/api-reference/rest-api/zkp/list-anchors.md) - REST API > Zkp [Generate a delegated ZK proof on a holder's behalf](https://docs.adid.dev/api-reference/rest-api/zkp/generate-delegated-proof.md) - REST API > Agents [Verify a multi-hop delegation chain](https://docs.adid.dev/api-reference/rest-api/agents/verify-delegation-chain.md) - REST API > Agents [List agents you operate or can delegate](https://docs.adid.dev/api-reference/rest-api/agents/list-agents-you-operate-or-can-delegate.md) - REST API > Agents [Register / deploy an agent](https://docs.adid.dev/api-reference/rest-api/agents/register-deploy-an-agent.md) - REST API > Agents [Discover agents (marketplace-style search)](https://docs.adid.dev/api-reference/rest-api/agents/discover-agents-marketplace-style-search.md) - REST API > Agents [Aggregate agent statistics](https://docs.adid.dev/api-reference/rest-api/agents/aggregate-agent-statistics.md) - REST API > Agents [Get agent (always detailed)](https://docs.adid.dev/api-reference/rest-api/agents/get-agent-always-detailed.md) - REST API > Agents [Update an agent](https://docs.adid.dev/api-reference/rest-api/agents/update-an-agent.md) - REST API > Agents [Decommission an agent](https://docs.adid.dev/api-reference/rest-api/agents/decommission-an-agent.md) - REST API > Agents [Delegate a capability to another agent](https://docs.adid.dev/api-reference/rest-api/agents/delegate-a-capability-to-another-agent.md) - REST API > Agents [Verify a delegation chain](https://docs.adid.dev/api-reference/rest-api/agents/verify-a-delegation-chain.md) - REST API > Agents [Tamper-evident audit log for an agent](https://docs.adid.dev/api-reference/rest-api/agents/tamper-evident-audit-log-for-an-agent.md) - REST API > Agents [Direct delegations](https://docs.adid.dev/api-reference/rest-api/agents/direct-delegations.md) - REST API > Agents [Credentials held by the agent](https://docs.adid.dev/api-reference/rest-api/agents/credentials-held-by-the-agent.md) - REST API > Agents [Delegation chain back to root operator](https://docs.adid.dev/api-reference/rest-api/agents/delegation-chain-back-to-root-operator.md) - REST API > Dashboard [Trust Explorer ZK anchor timeline](https://docs.adid.dev/api-reference/rest-api/dashboard/get-zk-anchors-dashboard.md) - REST API > Dashboard [Aggregate counters](https://docs.adid.dev/api-reference/rest-api/dashboard/aggregate-counters.md) - REST API > Dashboard [Live network events](https://docs.adid.dev/api-reference/rest-api/dashboard/live-network-events.md) - REST API > Dashboard [Recent activity](https://docs.adid.dev/api-reference/rest-api/dashboard/recent-activity.md) - REST API > Did Comm [List connections](https://docs.adid.dev/api-reference/rest-api/did-comm/list-connections.md) - REST API > Did Comm [Generate an out-of-band invitation](https://docs.adid.dev/api-reference/rest-api/did-comm/generate-an-out-of-band-invitation.md) - REST API > Did Comm [Accept a peer invitation](https://docs.adid.dev/api-reference/rest-api/did-comm/accept-a-peer-invitation.md) - REST API > Did Comm [Send a DIDComm v2 message](https://docs.adid.dev/api-reference/rest-api/did-comm/send-a-did-comm-v-2-message.md) - REST API > Did Comm [Inbound DIDComm endpoint (for mediators)](https://docs.adid.dev/api-reference/rest-api/did-comm/inbound-did-comm-endpoint-for-mediators.md) - REST API > Did Comm [List messages (filterable by thread)](https://docs.adid.dev/api-reference/rest-api/did-comm/list-messages-filterable-by-thread.md) - REST API > Issuer Analytics [List public issuer profiles](https://docs.adid.dev/api-reference/rest-api/issuer-analytics/list-public-issuer-profiles.md) - REST API > Issuer Analytics [Issuance and revocation metrics](https://docs.adid.dev/api-reference/rest-api/issuer-analytics/issuance-and-revocation-metrics.md) - REST API > Issuer Analytics [Raw activity feed](https://docs.adid.dev/api-reference/rest-api/issuer-analytics/raw-activity-feed.md) - REST API > Verifier [Verification history for the authenticated verifier](https://docs.adid.dev/api-reference/rest-api/verifier/verification-history-for-the-authenticated-verifier.md) - REST API > Verifier [Verification stats](https://docs.adid.dev/api-reference/rest-api/verifier/verification-stats.md) - REST API > Verifier [Add a verification record (verifier role required)](https://docs.adid.dev/api-reference/rest-api/verifier/add-a-verification-record-verifier-role-required.md) - REST API > Verifier [Revocation events relevant to this verifier](https://docs.adid.dev/api-reference/rest-api/verifier/revocation-events-relevant-to-this-verifier.md) - REST API > Verifier [Read trusted-issuer allowlist](https://docs.adid.dev/api-reference/rest-api/verifier/read-trusted-issuer-allowlist.md) - REST API > Verifier [Add a trusted issuer](https://docs.adid.dev/api-reference/rest-api/verifier/add-a-trusted-issuer.md) - REST API > Verifier [Remove a trusted issuer](https://docs.adid.dev/api-reference/rest-api/verifier/remove-a-trusted-issuer.md) - REST API > Verifier [Compliance Verifiable Credentials issued to the verifier](https://docs.adid.dev/api-reference/rest-api/verifier/compliance-verifiable-credentials-issued-to-the-verifier.md) - REST API > Verifier [Schema-to-issuer pinned mappings](https://docs.adid.dev/api-reference/rest-api/verifier/schema-to-issuer-pinned-mappings.md) - REST API > Verifier [Submit a network event](https://docs.adid.dev/api-reference/rest-api/verifier/submit-a-network-event.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.adid.dev/openapi.json) - [OpenAPI YAML](https://docs.adid.dev/openapi.yaml)