Skip to content

Trust Registry Service

The Trust Registry Service exposes functionality for managing Trust Registries -- lists of authorized issuers for the various credential types within an ecosystem.

Under Construction

This section -- and the underlying API -- is under active development.

We are working to define exactly how Trust Registries will be implemented within our platform; this page and API may change as we do so.

Create Governance Framework

Creates a Governance Framework and attaches it to the current ecosystem.

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

AddFrameworkRequest
Request to register a new ecosystem governance framework in the current ecosystem
governance_framework_uri
string
URI of governance framework organization
name
string
Name of governance framework organization
description
string
Description of governance framework

AddFrameworkResponse
Response to AddFrameworkRequest
id
string
Unique framework identifier
governing_authority
string
DID URI of Trinsic account which created the governance framework
trust_registry
string
URN of trust registry for governance framework

RemoveFramework

Remove a governance framework from the ecosystem

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

RemoveFrameworkRequest
Request to remove a governance framework from the current ecosystem
id
string
ID of governance framework to remove

RemoveFrameworkResponse
Response to RemoveFrameworkRequest
This message has no fields

Register Member

Registers an authorized issuer for a specific credential type (identified by its schema_uri).

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

RegisterMemberRequest
Request to register a member as a valid issuer of a specific credential schema. Only one of did_uri, wallet_id, or email may be specified.
did_uri
string
DID URI of member to register
wallet_id
string
Trinsic Wallet ID of member to register
email
string
Email address of member to register. Must be associated with an existing Trinsic account.
schema_uri
string
URI of credential schema to register member as authorized issuer of
valid_from_utc
uint64
Unix Timestamp member is valid from. Member will not be considered valid before this timestamp.
valid_until_utc
uint64
Unix Timestamp member is valid until. Member will not be considered valid after this timestamp.
framework_id
string
ID of the governance framework that member is being added to

RegisterMemberResponse
Response to RegisterMemberRequest
This message has no fields

Unregister Member

Unregisters an issuer for a specific credential type (identified by its schema_uri).

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

UnregisterMemberRequest
Request to unregister a member as a valid issuer of a specific credential schema. Only one of did_uri, wallet_id, or email may be specified.
did_uri
string
DID URI of member to unregister
wallet_id
string
Trinsic Wallet ID of member to unregister
email
string
Email address of member to unregister. Must be associated with an existing Trinsic account.
schema_uri
string
URI of credential schema to unregister member as authorized issuer of
framework_id
string
ID of the governance framework that member is being removed from

UnregisterMemberResponse
Response to UnregisterMemberRequest
This message has no fields

Get Membership Status

Check the status of an issuer for a specific credential type.

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

GetMembershipStatusRequest
Request to fetch membership status in governance framework for a specific credential schema.
framework_id
string
The ID of the ecosystem governance framework. This ID may be found in the 'trustRegistry' field in the verifiable credential model
did_uri
string
DID URI of member
schema_uri
string
URI of credential schema associated with membership

GetMembershipStatusResponse
Response to GetMembershipStatusRequest
status
RegistrationStatus
Status of member for given credential schema
Show enum values

Search the registry for registered issuers using a SQL query.

trinsic vc issue --document <JSONLD_FILE> --out <OUTPUT_FILE>

SearchRegistryRequest
Request to search all governance frameworks within ecosystem
query
string
SQL query to execute against frameworks. Example: SELECT c from c where c.type == 'GovernanceFramework'
continuation_token
optional string
Token to fetch next set of results, from previous SearchRegistryResponse

SearchRegistryResponse
Response to SearchRegistryRequest
items_json
string
JSON string containing array of resultant objects
has_more
bool
Whether more data is available to fetch for query
continuation_token
string
Token to fetch next set of results via SearchRegistryRequest

Cache Offline Registry File

trinsic trust-registry download