#Credential Issuer Metadata Configuration

The credential-issuer-metadata.conf file configures the OID4VCI credential issuer metadata, including supported credential types and display information.

#File Location

waltid-issuer-api2/config/credential-issuer-metadata.conf

#Configuration Options

#issuerDisplay

Display information for the issuer shown in wallet applications.

issuerDisplay = [
  {
    name = "Example Issuer"
    locale = "en-US"
    logo = {
      uri = "https://example.com/logo.png"
      alt_text = "Example Issuer Logo"
    }
  }
]

#credentialConfigurations

Map of supported credential types and their configurations.

credentialConfigurations = {
  "identity_credential_dc+sd-jwt" = {
    format = "dc+sd-jwt"
    vct = "https://example.com/credentials/identity"
    cryptographic_binding_methods_supported = ["jwk"]
    credential_signing_alg_values_supported = ["ES256"]
    sdJwtVcTypeMetadata = {
      name = "Identity Credential"
      description = "A verifiable identity credential"
      vct = "https://example.com/credentials/identity"
    }
  }
}

#Credential Configuration Types

#SD-JWT VC (dc+sd-jwt)

"identity_credential_dc+sd-jwt" = {
  format = "dc+sd-jwt"
  vct = "https://example.com/credentials/identity"
  cryptographic_binding_methods_supported = ["jwk"]
  credential_signing_alg_values_supported = ["ES256"]
  sdJwtVcTypeMetadata = {
    name = "Identity Credential"
    description = "A verifiable identity credential"
    vct = "https://example.com/credentials/identity"
  }
  display = [
    {
      name = "Identity Credential"
      locale = "en-US"
      background_color = "#12107c"
      text_color = "#FFFFFF"
    }
  ]
}

#W3C JWT VC (jwt_vc_json)

"UniversityDegree_jwt_vc_json" = {
  format = "jwt_vc_json"
  cryptographic_binding_methods_supported = ["did"]
  credential_signing_alg_values_supported = ["ES256", "EdDSA"]
  credential_definition = {
    type = ["VerifiableCredential", "UniversityDegree"]
  }
  display = [
    {
      name = "University Degree"
      locale = "en-US"
      logo = {
        uri = "https://example.edu/logo.png"
        alt_text = "University Logo"
      }
      background_color = "#1e3a8a"
      text_color = "#FFFFFF"
    }
  ]
}

#mDoc (mso_mdoc)

"org.iso.18013.5.1.mDL" = {
  format = "mso_mdoc"
  doctype = "org.iso.18013.5.1.mDL"
  cryptographic_binding_methods_supported = ["cose_key"]
  credential_signing_alg_values_supported = ["ES256"]
  display = [
    {
      name = "Mobile Driver's License"
      locale = "en-US"
      logo = {
        uri = "https://example.gov/dmv-logo.png"
        alt_text = "DMV Logo"
      }
    }
  ]
}

#Display Configuration

Each credential type can have display metadata for wallet rendering:

Property	Type	Description
`name`	String	Display name of the credential
`locale`	String	Locale code (e.g., "en-US")
`logo`	Object	Logo configuration
`logo.uri`	String	URL to the logo image
`logo.alt_text`	String	Alt text for the logo
`background_color`	String	Background color (hex)
`text_color`	String	Text color (hex)
`description`	String	Description of the credential

#Example Configuration

# credential-issuer-metadata.conf

issuerDisplay = [
  {
    name = "Example University"
    locale = "en-US"
    logo = {
      uri = "https://example.edu/logo.png"
      alt_text = "Example University Logo"
    }
  }
]

credentialConfigurations = {
  "identity_credential_dc+sd-jwt" = {
    format = "dc+sd-jwt"
    vct = "https://example.com/credentials/identity"
    cryptographic_binding_methods_supported = ["jwk"]
    credential_signing_alg_values_supported = ["ES256"]
    sdJwtVcTypeMetadata = {
      name = "Identity Credential"
      description = "A verifiable identity credential"
      vct = "https://example.com/credentials/identity"
    }
    display = [
      {
        name = "Identity Credential"
        locale = "en-US"
        background_color = "#12107c"
        text_color = "#FFFFFF"
      }
    ]
  }
  
  "UniversityDegree_jwt_vc_json" = {
    format = "jwt_vc_json"
    cryptographic_binding_methods_supported = ["did"]
    credential_signing_alg_values_supported = ["ES256"]
    credential_definition = {
      type = ["VerifiableCredential", "UniversityDegree"]
    }
    display = [
      {
        name = "University Degree"
        locale = "en-US"
        background_color = "#1e3a8a"
        text_color = "#FFFFFF"
      }
    ]
  }
}

Issuer Profiles – Credential profile configuration
Issuer Service – Core service configuration

Last updated on June 15, 2026

Issuer Service Issuer Profiles