Empeiria Documentation
  • Getting Started
    • Welcome to Empeiria
    • 5 minutes Quickstart
    • Tutorial: Credential Issuance & Verification
      • Overview
      • Understanding Key Concepts
      • Project Setup
      • Deploying the Issuer
      • Uploading the Credential Schema
      • Issuing Credentials
      • Frontend for Credential Issuance
      • Testing Credential Issuance
      • Deploying the Verifier
      • Setting Up the Verification Flow
      • Creating a Verification Endpoint
      • Creating a Protected Dashboard
      • Testing the Verification Flow
      • Summary & Next Steps
  • Understand
    • EVDI Architecture
    • Self-Sovereign Identity
      • Technical Foundations
      • Roles in the SSI framework
      • Protocols and Standards
  • Develop
    • One-click deployment
      • Introduction
      • Registration
      • Login
      • Creating an Issuer
      • Issuer Data Description
      • Creating a Verifier
      • Verifier Data Description
    • Issuer
      • Terminology and Concepts
      • DID Document Management
      • Schema Management
      • Issuing Credentials and Interacting With Wallets
      • Revocations
      • Security Considerations
      • Error Handling and Troubleshooting
      • Future Enhancements
      • References and Standards
      • MCP Server Integration
      • FAQ
      • API Reference
        • Token
        • Schema
        • Offering
        • Metadata
        • Credential
        • Blockchain
        • Authorization
    • Verifier
      • Terminology and Concepts
      • Architecture Overview
      • Core Responsibilities
      • Query Language
      • Client Configuration
      • Frontend Integration
      • Revocations
      • Server-Side VP Queries
      • Security Considerations
      • Error Handling and Troubleshooting
      • Future Enhancements
      • References and Standards
      • MCP Server Integration
      • FAQ
      • API Reference
        • VP Query
        • QR Code
        • Authorization
    • Wallet SDK (Coming soon)
    • Introduction to cosmwasm
  • Empe Blockchain
    • Overview
    • Chain Architecture
      • Auth
      • Authz
      • Bank
      • Distribution
      • Governance
      • Staking
      • IBC
      • DidDoc
      • Vesting
      • Minter
      • Stablefee
      • LinkedResources
    • Important links
    • Validators Guide
      • New validator
      • Hardware requirements
      • Required software installation
      • Go installation
      • Install prebuild binary
      • Install binary from source code (option B)
      • Configure a node
      • Cosmovisor setup
      • Install wasmvm
      • Sync with state-sync
      • Full state sync from archive snapshot
      • Latest snapshot
      • Run a Validator
      • Migration to v0.2.2
      • Migration to v0.3.0
      • Migration to v0.4.0
      • FAQ
  • User Guide
    • Empe DID Wallet
      • Intro
      • Download and first launch
      • Create or import did
      • Main screen overview
      • How to claim credential from issuer
      • How to use credential with verifier
      • Settings and other options
    • Keplr Wallet and Blockchain Operations
      • How to Connect Keplr Wallet
    • Ping Pub operation
    • Staking Tokens Guide
    • Voting on Governance Proposals Guide
    • Sending Tokens Guide
    • Airdrop
      • On-Chain Testnet Airdrop
      • Faucet Guide: How to Claim Testnet Tokens?
  • Appendix
    • Glossary
Powered by GitBook
On this page
  1. Develop
  2. Issuer
  3. API Reference

Blockchain

PreviousCredentialNextAuthorization

Get the issuer's blockchain address

get

Retrieves the blockchain address used by the issuer

Responses
200
Success
application/json
404
Not Found
application/json
get
GET /v1/blockchain/address HTTP/1.1
Host: api
Accept: */*
{
  "address": "0x1234567890abcdef1234567890abcdef12345678"
}

Anchor the issuer's DID on blockchain Creates a blockchain transaction to register the issuer's DID

post

Anchors the issuer's DID on the blockchain

Responses
200
Success
application/json
500
Server Error
application/json
post
POST /v1/blockchain/dids HTTP/1.1
Host: api
Accept: */*
{
  "did": "did:empe:0x1234567890abcdef1234567890abcdef12345678"
}

Verify a DID on the blockchain Retrieves and validates a DID document from the blockchain

get

Verifies if a DID exists on the blockchain

Path parameters
didstringRequired

The DID to verify

Responses
200
Success
application/json
404
Not Found
application/json
500
Server Error
application/json
get
GET /v1/blockchain/dids/{did} HTTP/1.1
Host: api
Accept: */*
{
  "did": {
    "id": "text",
    "context": [
      "text"
    ],
    "controller": [
      "text"
    ],
    "verificationMethod": [
      {
        "id": "text",
        "type": "text",
        "controller": "text",
        "publicKeyBase58": "text",
        "publicKeyMultibase": "text",
        "publicKeyJwk": {
          "kty": "text",
          "crv": "text",
          "x": "text",
          "y": "text"
        }
      }
    ],
    "authentication": [
      {
        "referenceId": "text",
        "embeddedMethod": {
          "id": "text",
          "type": "text",
          "controller": "text",
          "publicKeyBase58": "text",
          "publicKeyMultibase": "text",
          "publicKeyJwk": {
            "kty": "text",
            "crv": "text",
            "x": "text",
            "y": "text"
          }
        }
      }
    ],
    "assertionMethod": [
      {
        "referenceId": "text",
        "embeddedMethod": {
          "id": "text",
          "type": "text",
          "controller": "text",
          "publicKeyBase58": "text",
          "publicKeyMultibase": "text",
          "publicKeyJwk": {
            "kty": "text",
            "crv": "text",
            "x": "text",
            "y": "text"
          }
        }
      }
    ],
    "keyAgreement": [
      {
        "referenceId": "text",
        "embeddedMethod": {
          "id": "text",
          "type": "text",
          "controller": "text",
          "publicKeyBase58": "text",
          "publicKeyMultibase": "text",
          "publicKeyJwk": {
            "kty": "text",
            "crv": "text",
            "x": "text",
            "y": "text"
          }
        }
      }
    ],
    "capabilityInvocation": [
      {
        "referenceId": "text",
        "embeddedMethod": {
          "id": "text",
          "type": "text",
          "controller": "text",
          "publicKeyBase58": "text",
          "publicKeyMultibase": "text",
          "publicKeyJwk": {
            "kty": "text",
            "crv": "text",
            "x": "text",
            "y": "text"
          }
        }
      }
    ],
    "capabilityDelegation": [
      {
        "referenceId": "text",
        "embeddedMethod": {
          "id": "text",
          "type": "text",
          "controller": "text",
          "publicKeyBase58": "text",
          "publicKeyMultibase": "text",
          "publicKeyJwk": {
            "kty": "text",
            "crv": "text",
            "x": "text",
            "y": "text"
          }
        }
      }
    ],
    "service": [
      {
        "id": "text",
        "type": "text",
        "serviceEndpoint": [
          "text"
        ]
      }
    ],
    "alsoKnownAs": [
      "text"
    ]
  }
}

Update the revocation list on the blockchain

post

Updates the revocation list on the blockchain based on the current status of the credentials It fetches all credentials from the database, checks their status, and updates the revocation list accordingly.

Authorizations
Path parameters
idnumber ยท doubleRequired

The ID of the revocation list to update

Responses
200
OK
400
Bad Request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/blockchain/revocations/{id} HTTP/1.1
Host: api
x-client-secret: YOUR_API_KEY
Accept: */*

No content

  • GETGet the issuer's blockchain address
  • POSTAnchor the issuer's DID on blockchain Creates a blockchain transaction to register the issuer's DID
  • GETVerify a DID on the blockchain Retrieves and validates a DID document from the blockchain
  • POSTUpdate the revocation list on the blockchain