Skip to main content

Create a Trust Registry

Make sure you've read the Learn section.

Post a message that will modify the ledger state by creating a trust registry.

Any verana account can execute this method.

Message Parameters​

NameDescriptionMandatory
didDecentralized Identifier (DID) - must follow DID specificationyes
languageISO 639-1 default language code (e.g., en, fr, es...)yes
doc-urlURL of the EGF in the default language.yes
doc-digest-srihash (example: SHA-384) with SRI format prefix.yes
akaAlso Known As URL.no

Required Environment Variables​

Set the following environment variables before running the CLI commands:

USER_ACC=my-user-account
CHAIN_ID=vna-testnet-1
NODE_RPC=http://node1.testnet.verana.network:26657

Post the Message​

Usage​

veranad tx tr create-trust-registry <did> <language> <doc-url> <doc-digest-sri> [aka] --from <user> --chain-id <chain-id> --keyring-backend test --fees <amount> --gas auto

Example #1: Basic creation​

veranad tx tr create-trust-registry did:example:123456789abcdefghi en https://example.com/doc sha384-MzNNbQTWCSUSi0bbz7dbua+RcENv7C6FvlmYJ1Y+I727HsPOHdzwELMYO9Mz68M26 --from $USER_ACC --chain-id ${CHAIN_ID} --keyring-backend test --fees 600000uvna --node $NODE_RPC

Example #2: With AKA (Also Known As)​

veranad tx tr create-trust-registry did:example:123456789abcdefghi en https://example.com/doc001-01 sha384-MzNNbQTWCSUSi0bbz7dbua+RcENv7C6FvlmYJ1Y+I727HsPOHdzwELMYO9Mz68001 --aka http://example.com --from $USER_ACC --chain-id ${CHAIN_ID} --keyring-backend test --fees 600000uvna --node $NODE_RPC
tip

How to find the id of the trust registry that was just created?

TX_HASH=<replace with tx-hash>
veranad q tx $TX_HASH \
  --node $NODE_RPC --output json \
| jq '.events[] | select(.type == "create_trust_registry") | .attributes | map({(.key): .value}) | add'

replace with the correct transaction hash.

Publish your Trust Registry in your DID Document​

Make sure to add the corresponding service entry to your DID Document in order to prove ownership of the DID, by replacing 1234 with your trust registry id and setting the serviceEndpoint:

"service": [
    
    {
      "id": "did:example:ecosystem#vpr-schemas-trust-registry-1234",
      "type": "VerifiablePublicRegistry",
      "version": "1.0",
      "serviceEndpoint": ["vpr:verana:testnet"]
    }
    ...
  ]