Learn

Changelog

Enrichment of verification responses

10 May 2023

We've released an enhancement to the way our verification capabilities return the verified credential information. Until now, MATTR VII has applied a layer of convenience for integrations by returning only the claims from the verified credential.

You can now also get the raw credential presentation shared by the holder in the verification response. This brings more information and options to verifiers that enable subsequent flows like:

  • Re-verifying a credential using the MATTR VII verify capabilities, to re-check things like the revocation status.

  • Obtaining more information about which credential data attributes are coming from which credential when the verifier requested more than one credential.

Check out our tutorials for more details on how to enable and use this enhanced capability in your credential verification flows.

Enhancements and new features in the MATTR universe: April 2023

The MATTR team has been busy the last few months! We have a raft of exciting new features and updates coming to the MATTR platforms in April 2023.

  • Next-generation credential issuance with our new OpenID Credential Provisioning flow, using the OpenID4VCI standard.

  • More flexibility for credential issuance with interaction hooks and claims source integration.

  • DID Web hosting on the MATTR VII platform to simplify onboarding.

  • Major changes to our MATTR VII API with a version 2 release.

  • An update to the MATTR Wallet and Pi Wallet Toolkit to support an improved approach of matching credentials to presentation requests from verifiers.

Enhanced issuance journeys with OpenID Credential Provisioning

We're thrilled to unveil the evolution of our credential issuance capabilities with the all-new OpenID Credential Provisioning flow, based on the OpenID for Verifiable Credential Issuance (OpenID4VCI) protocol.

This protocol is a key draft standard for interoperability among digital wallets and has been included in the eIDAS expert group's draft European Digital Identity Architecture and Reference Framework (EUDI ARF) for digital wallets.

The new flow has evolved from our original OIDC Bridge credential issuance capabilities based on market and community movements and feedback from customers. It simplifies the experience of generating and configuring a credential for the issuer and it enhances the user experience of collecting a credential.

Tools for extra flexibility in credential issuance

Our OpenID Credential Provisioning flow makes issuance easier than ever before and we have built extra features that enable customers to have more flexibility to enact their unique business logic into the flow. These include:

  • Interaction hooks: integrate additional steps to the credential claiming journey such as additional biometric checks, identity assurance flows, or informational screens.

  • Multi-credential issuance: Issue multiple credentials to a wallet holder within a single user journey.

  • Claims source integration: Configure credentials using data from an existing source and supplement with additional data from tenant-managed user claims as well as claims sourced from an authentication provider or IDP. 

  • More tools on the way soon!

For current customers, we will continue to support the OIDC Bridge for issuance through the end of 2023 to allow you to transition to the new protocol and feature set. 

Read our new tutorials for issuance using the OpenID Credential Provisioning flow and new tools.

DID Web hosting now on MATTR VII

To help customers get started with using verifiable credentials quickly and easily, we now support DID Web hosting on the MATTR VII platform. 

Check out the MATTR Learn tutorials on setting up and using DIDs for more information.

New major changes to MATTR VII API

Continuing our theme of simplicity and ease of use, we will be releasing a new major version of our API, which includes a new set of endpoints that simplifies the ability to utilise MATTR’s Credential Profiles.  

Credential Profiles combine data about people, organizations or things with unique digital signatures. We use different types of Credential Profiles depending on the type of information a customer wants to convey and how they want to convey it.

See the API reference for more information on these changes.

MATTR Wallet - Migration to React Native V0.70

23 March 2023

The latest release of our MATTR Wallet is up!

Our MATTR Wallet has been migrated to React Native V0.70 as well as being upgraded to Realm V11 to leverage key improvements with these versions.
This release also includes a number of UI and usability enhancements.

Refer to the React Native and MongoDB pages for further details on React Native V0.70 and Realm V11.

You can download the MATTR Wallet app on your iPhone using the App Store or Android using Google Play.

 

Introducing MATTR Pi: Our flexible tools for creating apps your users will love.

22 February 2023

We are excited to announce the official launch of MATTR Pi – our SDK-centric platform encompassing toolkits with the flexibility to build solutions that work for you.

Whilst pi (π) is a mathematical constant, its decimals are infinite. All MATTR Pi toolkits have our rigorous commitment to international standards and leading security practices baked in, but they equip you with the limitless potential to create value in this new world of digital trust.

The foundations of MATTR Pi, available now, are the MATTR Pi Wallet Toolkit and the MATTR Pi Compact Credentials Verifier Toolkit.

The Wallet Toolkit includes all you need to get started creating your own digital wallet experiences quickly. Find out more and read our tutorial for using the Wallet SDK.

The Compact Credentials Verifer Toolkit lets you easily integrate verification capabilities into any existing or new application. Find out more and read our tutorial for using the Compact Credentials Verifier SDK.

Interested in creating a verifier or wallet solution and not sure where to start? Get in touch with us today to discuss the best option for your business.

MATTR Wallet - Additional Language Support

16 December 2022

Our MATTR Wallet now supports Swiss German and French Canadian languages.
To experience the MATTR Wallet in these languages, you will need to set the correct language on your iPhone or Android device.

Refer to the Apple and Google support pages if you need to change your language settings.

You can download the MATTR Wallet app on your iPhone using the App Store or Android using Google Play.

 

Terms

10 November 2022

We have an updated Privacy Policy now in place.

Introducing webhooks

25 October 2022

We have added support for webhooks to MATTR VII.
This new capability allows users to obtain information that is generated during an API operation that isn't otherwise available as part of the request or response payloads.

Users are able to subscribe to specific events that are triggered on set MATTR VII operations.

When an event is triggered, the information relating to that event is published via the webhook through to the URL(s) set up on the configured subscription(s).

Users can now:

Interested in learning more about how you might use the MATTR VII Platform? Get in touch with us today.

MATTR Wallet - New look and feel

30 September 2022

Our new MATTR Wallet is up! Experience a brand new look and feel!

Improved journeys and flow

A revised navigation and structure allows you to access all the features you need in a fast and efficient way.

New and improved onboarding

New experience to guide and inform you on how to get the most out of your wallet.

Credentials look more life-like to build trust with your users. Your credentials are our top priority!

Your credentials have been redesigned to look and feel like physical cards users are already familiar with.

Create credentials that match your organisations branding

Credentials mimic real-world cards more than ever before. You can now customise colours, logos and include watermarks to suit your brand needs.

Log of all your information and sharing events plus activities

A log of all credential interactions you have performed with the MATTR Wallet, along with different ways to view the events, such as grouping by connection.

You can download the MATTR Wallet app on your iPhone using the App Store or Android using Google Play.

 

MATTR VII - Event logs

15 August 2022

MATTR introduces enhanced platform ops logging levels on MATTR VII.

As of today, we support configuration of logging at the platform environment level along with manual consumption of platform events in specific customer environments.

In future customers will be able to customise these levels more freely and 'fan-out' events to other operational systems via APIs and webhooks.

New logging levels supported:

  • Level 1 - Basic fields

  • Level 2 - Metadata + basic fields

  • Level 3 - Data (full request and response payloads) + metadata + basic fields

All MATTR VII public cloud environments (and associated tenants) are set to Level 1 - Basic Fields. No personal identifiable information (PII) is being captured in event logs at this level.

Interested in learning more about how you might use the MATTR VII Platform? Get in touch with us today.

OIDC Bridge - Additional configurations

10 August 2022

In this release, we added support for including the following configurations when setting up an OIDC Credential Issuer.

  • federatedProvider.claimSource is either idToken (default) or userInfo

  • federatedProvider.tokenEndpointAuthMethod is either client_secret_post (default), or client_secret_basic

  • staticRequestParameters: parameters that should be included in the request to the IDP. i.e. display, prompt, max_age, ui_locales etc.

  • forwardedRequestParameters: parameters that can be provided by the client to be forwarded to the IDP. These are optional and can override the staticRequestParameters i.e. login_hint.

We've also updated our MATTR Wallet SDK and MATTR Wallet App to include login_hint as a request parameter when issuing a credential using the OIDC bridge. This will allow pre-population of the username in the Federated Provider's login screen when using MATTR Wallet to claim a credential. Any other request parameters are not supported by MATTR Wallet and SDK at the moment.

Interested in learning more about how you might use the MATTR VII Platform? Get in touch with us today.

New MATTR VII Regions

1 August 2022

MATTR VII is now available in two additional AWS regions:

  • Frankfurt, Germany

  • Montréal, Canada.

Compact Credential Verifier SDK

07 July 2022

We’ve transformed our Credential Verification capabilities to support the wider platform by making it work on your own mobile experience or integrating them into other types of your applications. Utilizing SDK will significantly reduce your development time while ensuring you are leveraging safe and reliable code libraries.

The following capabilities & benefits are provided in the Verifer SDK:

  • Build your own Compact Credential verification solution into existing applications using the same tools as the MATTR Verifier App

  • Validate Compact and Semantic Compact Credentials' authenticity 

  • Offline verification of your trusted credentials

  • Refresh cached revocation lists and trusted issuers

  • Privacy-preserving features

  • Ongoing support for fast-evolving standards of digital trust and verifiable data

  • Create both iOS and Android apps using the same codebase

Interested in learning more about how you might use the MATTR Verifier SDK? Get in touch with us today.

Introducing compact credentials

30 June 2022

Claims of data can be represented as Compact Credentials, which are both cryptographically proven as authentic and dense enough to fit inside a QR code. This credential format is ideal where high information assurance is required but not high identity assurance about the entity presenting the credential.

You can choose to use either a W3C Verifiable Credential data model to provide more descriptive semantic meaning or a more concise, non-semantic data model. The choices between the data model to use comes down to how compact you need the credential to be versus how openly you intend to share and exchange the created credentials across different domains and jurisdictions.

The following capabilities of Compact Credentials are provided in this MATTR VII platform release:

With this product release, our Customer Agreement and Terms have changed. Please refer to the version dated 30 June 2022 for details.

Compressed credential support (technical preview)

24 Mar 2022

Compressing semantically verifiable credentials into smaller payload sizes is a useful technique. For example, it allows credentials and presentations to be embedded into QR codes so they can be used when one party is offline.

Try out our latest technical preview on compressed credentials to see how using CBOR-LD can unlock use cases where offline is important.

  • Convert JSON-LD to CBOR-LD to compress the payload size

  • Use the latest version of the MATTR Wallet (v1.9.1) to present applicable credentials in a CBOR-LD format

  • Convert CBOR-LD payloads to JSON-LD to use with existing MATTR VII API

Digital Covid Certificate (DCC) Extension

5 Nov 2021

We have introduced a new DCC extension to MATTR VII that is built on top of our core libraries to provide the capability to issue and verify Digital Covid Certificates (DCC).

The standards outlined for the European Union DCC (EUDCC) format, which covers 3 certificate types ( vaccination, recovery, and testing) are all covered by the extension which allows your MATTR VII tenant the ability to:

  • Maintain the required document signer certificates that facilitate trusted issuance and verification of the EUDCC format.

  • Sign and issue a health certificate payload into a EUDCC format

  • Verify a EUDCC

  • Format the EUDCC in a way that allows it to be presented in either a digital or paper-based manner.

Note: The use of the DCC extension during a trial of the MATTR VII platform may be subject to change. As you move into production workloads please get in touch to discuss your needs.

Introducing the New Zealand COVID Pass (NZCP) Verify Extension

5 Nov 2021

The New Zealand government will start issuing a type of digital health certificate known as a 'My Vaccine Pass' using the New Zealand COVID Pass (NZCP) specification , this credential contains a limited set of personal information and provides a way for the holder to prove they meet certain health policy requirements in regards to COVID-19 such as being vaccinated against the virus.

From today you can now read about the NZCP Verifier API to help you determine how to integrate and verify NZ COVID Passes that have been presented to you, this also accompanies the NZCP Verifer SDK and Verifier white label app offerings.

Get in touch to start onboarding to use the service today, the API will also be available on a trial basis starting soon.

ZKP-enabled credentials using Web DIDs & support for custom paths

22 Oct 2021

This release adds the ability to use bls12381g2 key types with a Web DID so that ZKP-enabled credentials can be issued. We have also enabled Web DIDs to be created on custom paths that don't rely on a /.well-known location.

  • Create DID with the web method and bls12381g2 key type.

  • A new url parameter in options to specify a domain for the Web DID as well as allowing the use of paths in the form of organization.com/path.

The domain options parameter has now been functionally superseded by the url option parameter and will be deprecated in an upcoming release.

Introducing ION DIDs & an update on Sovrin DIDs

8 Sep 2021

Decentralized Identifiers (DIDs) using the Identity Overlay Network (ION) method can now be created on the platform and used for issuing credentials and other purposes. ION DIDs use the Sidetree protocol to anchor the DID document to a ledger, which provides a high-throughput and efficient method for writing to a blockchain like Bitcoin. ION DIDs can be easily configured on the MATTR VII platform using our API interface, allowing you to leverage the benefits without having to deal with any of the underlying complexities:

  • Create & manage ION DIDs on your tenant

  • ION DIDs can be used to create credentials, sign and encrypt messages as well as being fully configurable on the OIDC Bridge for issuance and verify

  • Supports ed25519 and bls12381g2 key types

  • Fully resolve ION DID Documents from the public nodes

Note: The creation of ION DIDs during a trial of the MATTR VII platform may be subject to change. As you move into production workloads please get in touch to discuss your needs.

Sovrin DID method

Since launching the platform our implementation of did:sov has relied on private Indy nodes whilst the community around DID Sovrin continued to develop new kinds of interoperability in their infrastructure. Recently activity is showing that rather than converging around the Sovrin-specific method that’s been used to date new approaches are being looked at. Until this direction from the community has more clarity around implementation we have decided to deprecate our current private node support.

From this release, we will begin phasing out support for DIDs based on Sovrin by removing references from the documentation and in the next release, we will stop the current did:sov support and remove any Sovrin DIDs from the sandbox platform.

Custom domains & complex credentials

2 July 2021

Tenants can now be configured to represent as a verified custom domain:

Custom domains are a paid feature, setting up a custom domain whilst using a sandbox is possible, however, note this may be disabled and reverted back at MATTR's discretion.

  • New endpoints added to create, view, delete and verify a custom domain on your tenant

  • Create a custom domain by providing details like your organisation name, domain and a logo which will be displayed to end-users interacting with your tenant using a wallet app that supports a web manifest payload.

  • The MATTR mobile wallet app has been updated to support the display of custom domains as well as a number of improvements to the UI of MATTR Wallet to be more human-friendly, including support for more complex data types like nested data and embedded images.

Create & Verify Presentations Directly

20 May 2021

New endpoints provided to help you work with verifiable presentations directly on MATTR VII:

An optional description parameter has been added when creating credentials:

  • The optional description field is enabled on the Create Credential endpoint.

  • The field can be configured in the OIDC Bridge Issuer so that any credentials issued will contain the description.

Note the description field is part of the W3C Verifiable Credential Model v2 specification and will be supported in the MATTR mobile wallet as the standard begins to stabilize.

MATTR VII launch with push notification messaging

(v1.0) 25 Mar 2021

MATTR VII is now live!

Pricing

Pay-as-you-go pricing is now published

  • Get a detailed look at how MATTR VII is charged once you elect to upgrade to a paid plan.

  • To discuss high-volume discounts, please contact us.

API references

The platform is now known as MATTR VII; URLs and paths updated to reflect this:

  • MATTR VII Core is https://tenant.vii.mattr.global/core/v1.

  • OIDC Bridge is a MATTR VII extension found at https://tenant.vii.mattr.global/ext/oidc/v1.

    Old domains and paths will be discontinued from service within 30 days

Notification messaging

Customers can use their tenant to construct and send messages to holders based on their subject DID, which will be delivered to the MATTR Wallet app and notified via a push notification.

  • Construct action-based messages in a DIDComm2 JWM format:

    • Start a credential issuance using the OIDC Bridge.

    • Notify of a credential revocation status change.

    • Start a verification flow using a callback.

  • Encrypt messages intended for the recipient.

    • MATTR VII enforces end-2-end encryption (E2EE), so message contents are never visible to MATTR when held in messaging inboxes.

  • Route messages to a dedicated inbox for the wallet user.

    The MATTR Wallet app is being updated to support receiving push notification and managing messaging inboxes. Make sure you update to the latest version available on the App Store or Google Play.

Further messaging capabilities are scheduled on the roadmap.

Terms

New customers signing up to MATTR VII will have a new customer agreement, SLA and privacy policy in place.

Verify ZKP-enabled Credentials

(v0.13) 18 Feb 2021

Further functionality to support the use of privacy-preserving credentials using BBS+ signatures.

Create a JSON-LD Frame Presentation Request

  • Use a query extension to the Verifiable Presentation Request Specification format, Query by Frame, to specify required credential claims.

  • Trusted Issuers and Credential Types are used to match credentials in the mobile wallet.

Mobile Wallet updates

  • The latest version (v0.50.0) of the Mobile Wallet is required to process Query by Frame presentation requests.

  • ZKP-enabled credentials using BBS+ signatures can be used to derive selectively disclosed presentations.

  • New UI screens to actively show the disclosure of claims.

Maintenance

(v0.12) 11 Feb 2021

Maintenance Release

  • Update to the Callback URL for all Issuers on the OIDC Bridge to align with future changes.

    Ensure that the allowed callback URL for your federated provided is updated with the new path. From ../oidc/v1/issuers/.. To: ../ext/oidc/v1/issuers/..

OIDC Bridge and OIDC Credential Provider

(v0.11) 16 Dec 2020

When we first launched the Platform we pioneered the bridging of existing identity solutions using Open ID Connect (OIDC) to a new world of decentralized identity and verifiable credentials. During this time we listened to customers as well as working within the Community as standards evolve. This latest version of the OIDC Bridge is now easier to set up, more flexible to integrate and conforms with OIDC Credential Provider for issuing credentials to the mobile wallet.

OIDC Bridge

Verify Credentials without using OIDC Bridge

Maintenance

(v0.10) 17 Nov 2020

Maintenance release

  • In line with the W3C VC Data Model; Subject identifiers are now not required on Create Credential, usually a Subject DID makes up a core part of a Verifiable Credential but in some cases it makes sense without one, such as issuing a ‘bearer’ style credential e.g. a concert ticket or when the credential is to be stored on behalf of a subject and reissued later with subject binding.

Maintenance

(v0.9) 4 Nov 2020

Maintenance release

  • The format of the response from /.well-known/did-configuration is now in a JSON-LD format. Learn more about the Well Known DID Configuration from the Decentralized Identity Foundation working group.

    This changes means all holders will need to being using the MATTR Mobile Wallet with a minimum version of v0.37.1 to continue to receive and present credentials, earlier versions of the app will present a generic error message.

Revocable Credentials

(v0.8) 21 Oct 2020

Credentials issued on the platform are now revocable and searches can be performed on the Credential Registry.

Revocable Credentials

  • Create Credential has new optional revocable property to create a Credential as revocable using a revocation list method.

    All Credentials issued using the OIDC Bridge are now revocable by default.

  • Management API endpoints for an Issuer to toggle the revoke status of a Credential.

  • Provisioned hosting of revocation lists for Credential Issuers.

  • Automatic verification of a presented Credential against its revocation list will result in revoked credentials being returned with an error message in the OIDC/OAuth2 callback response back to Verifiers/relying parties.

Search on Credentials

  • Credentials optionally held in the Credential Registry can now be retrieved by tag and type parameters.

  • The meta-data of non-persisted Credentials can also be found using these tags.

    All Credentials issued using the OIDC Bridge will only store meta-data.

Updates

DID Web Method

(v0.7) 7 Oct 2020

New DID method did:web is available to be created on the Platform.

  • Check out the new DID Web tutorial on how to implement this style of DID.

  • Further content on the various DID methods available on the platform is available.

Updates

  • Enhanced pagination on the List Credentials endpoint, moved from using a page-offset pagination to a much more performant cursor-based pagination.

ZKP-Enabled Credentials

(v0.6) 16 Sep 2020

Support added for issuing privacy-preserving credentials using BBS+ signatures.

ZKP-enabled credential functionality during Preview are considered experimental and may change over time as well as any ZKP-enabled credentials issued during this period may need to be reissued.

Create a DID with BLS Key Types

  • Create DID now has options to set a key type (only for did:key method at this time).

  • Use the BLS key type bls12381G2 to create Issuer DIDs for issuing ZKP-enabled credentials.

  • Response for Resolve a DID has been altered to include a localMetadata parameter which will be used for future DID methods.

Create a ZKP-enabled Credential

  • Create Credential will automatically issue ZKP-enabled credentials if an issuerDid referencing a bls12381G2 key type is provided.

Updates

  • New optional parameters are available on Create Credential:

    • Providing a value in tag will set this value as metadata so it can be referenced on the platform later.

    • Setting the persist boolean to true will store the created credential on your tenant for future retrieval. The default value is not to store credentials.

Maintenance

(v0.5) 9 Sep 2020

Maintenance release.

  • Mobile Wallet App bug fixes and improvements.

  • Improved support for OIDC query parameters on mobile app authorization requests.

Sovrin DID Method

(v0.4) 25 Aug 2020

Creation of Sov DIDs on the platform is now possible.

  • Create DID can be used to create DIDs using the Sovrin DID method. Note during Preview these will not be anchored on the Sovrin MainNet.

  • Resolve a DID will resolve Sov DIDs including MATTR issued ones.

Maintenance

(v0.3) 10 Aug 2020

Maintenance release

Maintenance

(v0.2) 29 Jul 2020

New endpoints available.

Launch of the MATTR Preview Platform

(v0.1) 3 Jun 2020

SaaS Platform

  • A cloud-hosted, multi-tenanted environment that can be spun-up on-demand using managed containers

  • Authentication and access-control provisioning

  • Auditing and privacy-preserving logging

Issue Verifiable Credentials using OpenID Connect

  • Cryptographically secure issuance of Verifiable Credentials (VC) to authenticated identity holders

  • Configuration options to;

    • Bring-your-own OpenID Connect Provider (OP)

    • Or, use our step-by-step tutorial for a reference OP

  • Map personal information claims from source to VC terms, using linked-data standards

  • Decode a JWT signed using a Decentralized Identifier

  • Optionally; store issued credentials on-platform to be retrieved (for non-sensitive use-cases)

  • Create a credential Offer as a QR code or deep-link to start the issuance flow with the mobile wallet app

  • The static offer is ready to display on a website or physical media e.g. a bus shelter advertisement

Verify Verifiable Credentials using OpenID Connect

  • Cryptographically secure verification of VCs from identity holders after their consent

  • Uses the latest standards-based messaging protocols (JWM) to transmit information from the holder

  • Configure an OpenID Connect Relying Party client to accept holder information via a standard ID token

  • Map personal information from Credential claims to a standard ID token

  • Create a VC Request and embed using a QR code or deep-link into a journey

  • The dynamic request can be used in an information-gathering flow e.g. Customer onboarding

Mobile Wallet App

  • Native iOS and Android apps, supporting a range of models and devices

  • On-device biometric access enabled

  • Familiar chat-like user-interface approach, designed with core pillars of privacy, accessibility and user-experience

  • Puts the user in control during issuance and verification of their Credentials

  • Keeps user in-context with in-app-browser technology

  • Interoperable to published specifications within the Self-Sovereign Identity ecosystem

  • Theming options available to prospective customers