Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Glossary

Aries Interop Profile (AIP)

A specification within the Aries framework that defines a set of protocols, roles, and message formats to ensure interoperability between different Aries agent implementations.
Chainscore © 2026
definition
DECENTRALIZED IDENTITY STANDARD

What is Aries Interop Profile (AIP)?

A standardized set of protocols enabling secure, interoperable digital identity interactions across different vendors and frameworks.

The Aries Interop Profile (AIP) is a specification that defines a precise combination of W3C Verifiable Credentials, Decentralized Identifiers (DIDs), and Aries RFC protocols to ensure different SSI (Self-Sovereign Identity) agents and wallets can communicate and transact reliably. It acts as a formalized interoperability test suite, guaranteeing that implementations from organizations like the Linux Foundation, IDunion, and Indicio adhere to the same technical baseline for core functions like connection establishment, credential issuance, and presentation. Without AIP, agents might use compatible underlying standards but fail to interoperate in practice due to differing protocol choices or optional feature support.

AIP is versioned, with profiles like AIP 1.0 and AIP 2.0 representing specific, tested stacks of technology. Each profile mandates the use of particular DID Methods (e.g., did:key, did:sov), cryptographic suites, and message formats defined in Aries RFCs. For instance, it specifies the exact DIDComm protocol for initiating a connection, the format for a credential offer, and the method for presenting proof. This removes ambiguity, allowing a credential issued by a government using one vendor's AIP-compliant infrastructure to be seamlessly stored and presented via a citizen's wallet built by a completely different vendor.

For developers and enterprises, implementing an AIP profile is the primary pathway to achieving certified interoperability within ecosystems like the Trust Over IP (ToIP) stack or European Digital Identity Wallets. Conformance is typically validated through test suites and public interoperability events where vendors demonstrate cross-compatibility. The profile system allows the community to evolve capabilities—introducing new cryptographic methods or privacy-preserving features in later versions—while maintaining a stable, agreed-upon foundation for production deployments. Thus, AIP is less a single protocol and more a guarantee of functional compatibility for the decentralized identity layer.

how-it-works
IMPLEMENTATION GUIDE

How Does an AIP Work?

An Aries Interoperability Profile (AIP) functions as a precise technical blueprint, specifying the exact combination of protocols, data formats, and agent behaviors required for two systems to communicate in a verifiable data ecosystem.

An AIP works by defining a concrete implementation guide for developers building Aries agents. It mandates specific versions of core protocols like DIDComm for secure messaging, AnonCreds or W3C Verifiable Credentials for data models, and the Aries RFCs that govern interaction flows. By adhering to a common AIP, two agents—regardless of their underlying codebase—can establish a secure, encrypted channel, exchange cryptographic proofs, and complete complex interactions like credential issuance and presentation without prior coordination. This eliminates the need for custom integrations.

The operational mechanics are governed by a layered approach. At the foundation, an AIP selects a DID method (e.g., did:indy, did:key) for decentralized identifiers and a verifiable credential format. It then specifies the exact protocol state machines for key interactions, such as the steps in the Issue Credential protocol or the Present Proof protocol. Crucially, it defines the supported attachment formats for encoding credentials and presentations within DIDComm messages, ensuring the payloads themselves are interpretable. This granularity guarantees that if Agent A follows AIP 1.0 and Agent B follows the same profile, they can interoperate seamlessly.

In practice, implementing an AIP involves configuring an agent's protocol router to handle the mandated message types and orchestrating its wallet to store credentials and keys in the specified formats. For example, an AIP might require support for ZKP-capable credentials via AnonCreds, dictating that the agent must be able to process predicate proofs and revocation registries. The working profile also often prescribes feature discovery mechanisms, allowing agents to announce their supported AIP versions during the initial connection process using the DID Exchange or Out-of-Band protocols, enabling dynamic compatibility checks.

key-features
ARIES INTEROPERABILITY PROFILE

Key Features of an AIP

The Aries Interoperability Profile (AIP) is a specification that defines a concrete set of protocols and data formats for implementing interoperable, self-sovereign identity (SSI) agents. It ensures different agents can communicate and exchange verifiable credentials.

01

Protocol Stack Definition

An AIP specifies a concrete stack of communication and cryptographic protocols. This includes:

  • DIDComm v2 for secure, private messaging.
  • Hyperledger AnonCreds or W3C Verifiable Credentials for credential formats.
  • Specific presentation request and issue-credential protocol flows.
  • DID methods like did:indy or did:key for decentralized identifiers. By standardizing this stack, it guarantees agents built to the same AIP can interoperate without custom integration.
02

Versioned Interoperability

AIPs are versioned (e.g., AIP 1.0, AIP 2.0). Each version is a snapshot of compatible protocol versions, creating a stable target for implementers. Organizations can state "we support AIP 2.0," which precisely defines capabilities. This prevents fragmentation that occurs when agents implement different, potentially incompatible versions of underlying specs like DIDComm.

03

Credential Format Support

A core feature is mandating support for specific verifiable credential formats. The two primary formats are:

  • AnonCreds (ZKP-based): Supports selective disclosure and predicate proofs, offering strong privacy. Common in AIP 1.0.
  • W3C Verifiable Credentials (JWT/LD-Proofs): JSON-based formats aligned with broader web standards, emphasized in later AIP versions. An AIP dictates which formats are required or optional for issuance and presentation.
04

Agent-to-Agent Communication

The profile defines the exact message types and routing protocols for agent communication. This includes:

  • Connection establishment using the DID Exchange protocol.
  • Relay support for agents behind firewalls.
  • Message threading and error handling conventions.
  • Trust Ping for liveness checks. This ensures reliable, secure, and feature-complete peer-to-peer interactions between digital wallets and agents.
05

Governance & Test Suite

Each AIP is governed and maintained by a community, often under the Hyperledger Foundation. A critical component is the accompanying interoperability test suite. This suite provides a suite of automated tests that verify an agent's implementation conforms to the AIP specification, providing a concrete measure of compliance before deployment.

06

Use Case & Ecosystem Alignment

Different AIP versions often emerge to serve specific ecosystems or use cases. For example:

  • AIP 1.0 is closely tied to the Indy ecosystem (Sovrin, BCovrin) and AnonCreds.
  • AIP 2.0 expands support for W3C VCs and aims for broader web integration. This allows industries (finance, healthcare, education) to adopt a profile that matches their regulatory and technical requirements.
PROTOCOL EVOLUTION

Common AIP Versions and Focus

A comparison of major Aries Interoperability Profile versions, highlighting their core architectural focus and supported features.

Feature / FocusAIP 1.0AIP 2.0RFC 0434 (AIP 2.x)

Primary Architecture

Pairwise DIDs & Peer DIDs

Pairwise DIDs & Peer DIDs

DIDComm v2.0 & DID Rotation

Connection Protocol

DID Exchange (RFC 0023)

DID Exchange (RFC 0023)

Out-of-Band (RFC 0434)

Message Encryption

Authcrypt (libsodium)

Authcrypt (libsodium)

Authcrypt & Anoncrypt (JWE)

Credential Format

Indy AnonCreds

Indy AnonCreds & W3C VC-DM

W3C VC-DM & JSON-LD Signatures

Credential Exchange

Issue Credential (RFC 0036)

Issue Credential (RFC 0036)

Issue Credential (RFC 0453/0454)

Present Proof Protocol

Present Proof (RFC 0037)

Present Proof (RFC 0037)

Present Proof (RFC 0453/0454)

Mediator Coordination

Basic Routing

Mediate Coordination (RFC 0211)

Mediate Grant (RFC 0211)

Transport Backwards Compatible

examples
IMPLEMENTATION PATTERNS

Examples of AIP in Practice

The Aries Interoperability Profile (AIP) is realized through specific technical implementations and governance frameworks that enable verifiable credentials to flow between different SSI ecosystems.

01

AIP 1.0: The Baseline

Establishes the foundational DIDComm v1 protocol for secure, peer-to-peer messaging. This profile defines the core agent capabilities required for basic credential issuance and presentation, forming the bedrock for early SSI ecosystems. It specifies:

  • Use of Indy-SDK for wallet operations
  • Hyperledger Indy as the primary verifiable data registry
  • Support for the ZKP-based Indy AnonCreds credential format
02

AIP 2.0: DIDComm v2 & Credential Flexibility

A major evolution introducing DIDComm v2 for improved security and transport agility. AIP 2.0 decouples from any specific ledger or credential format, enabling support for W3C Verifiable Credentials (JSON-LD, JWT) alongside AnonCreds. Key features include:

  • Out-of-Band (OOB) invitations for easier connection establishment
  • Enhanced problem reports for better error handling
  • Formalized goal codes to communicate intent in protocols
03

The Trust Over IP (ToIP) Stack

AIP serves as the Interoperability Layer (Layer 3) in the ToIP stack's four-layer model. This provides a governance and technical framework where:

  • Layer 1 is the utility ledger (e.g., Sovrin, Indy).
  • Layer 2 defines governance frameworks.
  • Layer 3 (AIP) enables agents from different ecosystems to communicate.
  • Layer 4 is the end-user applications. This model ensures interoperability isn't just technical but also governed.
04

Government Digital Identity Programs

National digital identity systems, such as those in British Columbia (OrgBook BC) and the European Union's EBSI/ESSIF, leverage AIP-compliant agents. These implementations demonstrate AIP at scale for:

  • Business credentialing (permits, licenses)
  • Educational attestations (diplomas)
  • Cross-border compliance using standardized, interoperable verifiable credentials and protocols.
05

Enterprise Credential Wallets & Agents

Commercial and open-source cloud agents and mobile edge agents are built to AIP specifications. Examples include Trinsic, Mattr, and the Aries Framework JavaScript (AFJ). These provide organizations with the infrastructure to:

  • Issue employee badges or customer loyalty credentials.
  • Verify credentials from partners or job applicants.
  • Manage digital relationships via standardized DIDComm connections.
06

Interoperability Test Suites & Certification

The Aries Interoperability Test Suite is a critical practice, providing a suite of automated tests that verify an agent's compliance with AIP protocols. Projects like the Interoperability Profile Showcase run these tests to certify agents, creating a trusted ecosystem where users can be confident that an AIP 1.0 or AIP 2.0 labeled agent will work with others.

technical-details
TECHNICAL DETAILS AND COMPONENTS

Aries Interop Profile (AIP)

A set of formal specifications that define how different Aries agents and frameworks should implement core protocols to achieve interoperability within the Self-Sovereign Identity (SSI) ecosystem.

The Aries Interop Profile (AIP) is a formal specification that defines a precise set of protocols, data formats, and security mechanisms that Aries agents must implement to ensure seamless interoperability. It acts as a compliance baseline, guaranteeing that agents from different vendors or projects can successfully exchange verifiable credentials, establish secure connections, and engage in credential issuance and presentation flows. Without a common profile like AIP, agents might implement the underlying Aries RFCs (Request for Comments) differently, leading to communication failures and a fragmented ecosystem.

Profiles are versioned (e.g., AIP 1.0, AIP 2.0) and build upon the foundational W3C Verifiable Credentials Data Model and the DIDComm secure messaging protocol. Each version specifies mandatory and optional features, such as which DID methods are supported for connection establishment, which signature suites are used for credential proofs, and the exact sequence of messages for protocols like Issue Credential and Present Proof. This rigorous specification enables developers to build agents with confidence that they will work in production environments with other compliant systems.

The governance and evolution of AIP is managed by the Hyperledger Aries community through its working groups. New profiles are developed to incorporate advancements in cryptography, support new use cases, or improve security and performance. For implementers, choosing a specific AIP version is a critical architectural decision, as it dictates the supported feature set and the pool of other agents with which interoperability is guaranteed. Major deployments and trust frameworks often mandate adherence to a particular AIP version to ensure reliability and trust in large-scale, multi-vendor digital identity networks.

ARIES INTEROP PROFILE

Frequently Asked Questions (FAQ)

Essential questions and answers about the Aries Interop Profile (AIP), a critical standard for ensuring interoperability between different agents and frameworks in the Self-Sovereign Identity (SSI) ecosystem.

The Aries Interop Profile (AIP) is a formal specification that defines a specific set of protocols, data formats, and agent capabilities to guarantee seamless interoperability between different SSI (Self-Sovereign Identity) agents and frameworks. Its importance stems from solving the core challenge of vendor lock-in and fragmented ecosystems; without a common profile like AIP, an agent from one vendor might be unable to communicate or exchange verifiable credentials with an agent from another, defeating the purpose of a decentralized identity network. AIP provides a concrete, tested "recipe" that implementers can follow to ensure their software can connect, discover features, and conduct trusted interactions with any other AIP-compliant agent.

further-reading
ARIES INTEROP PROFILE (AIP)

Further Reading & Resources

Explore the core specifications, implementations, and community resources that define the Aries Interoperability Profile for decentralized identity.

05

Use Cases & Industry Adoption

Real-world applications demonstrating AIP's role in solving identity challenges.

  • Travel & Hospitality: The Good Health Pass initiative used AIP-based solutions for digital health credentials.
  • Education & Employment: Verifiable digital diplomas and professional licenses.
  • Financial Services: KYC/AML credential sharing and decentralized finance (DeFi) access.
ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected Directly to Engineering Team
Aries Interop Profile (AIP) - Decentralized Identity Glossary | ChainScore Glossary