Skip to main content

Connection

The Connection API in the Cloud Wallet domain handles peer-to-peer relationships between wallets and external agents (issuers, verifiers, or other wallets). Connections allow secure, bidirectional communications using protocols like DIDComm or OpenID-based flows.

What “Connection” enables

  • Invitation Acceptance: The API supports accepting connection invitation, enabling your wallet to establish a secure channel with another party.
  • Connection Retrieval & Listing: You can fetch details of individual connections (by ID) or list all current connections tied to a wallet.
  • Connection Metadata & State: Each connection carries state, metadata, and IDs — useful for tracking role etc.

Example: Creating a Connection Request for the Indicio Ecosystem

Follow these steps to create a secure connection in the Indicio ecosystem.

Note: The connection workflow described below is applicable only for Indicio and Cheqd ecosystems.

  1. Visit the Hovi Cloud Wallet API Reference.

  2. Navigate to Connection section.

  3. Select the POST - Accept Out-of-Band Connection Invitation endpoint and click “Test Request”.

  4. Enter the API key as a Bearer Token, provide the body parameters, and click “Send”. If success a connection will automatically received by holder's wallet after he scan the QR code.

note

Hovi’s Cloud Wallet Connections endpoints allow you to accept, and retrieve connections, as well as access connection invitations. For more information, please visit Hovi Cloud Wallet API Connection Reference.