Introduction

Specs v4

This section documents the Specs v4 implementation of the Verana Verifiable Public Registry. See the full specification for reference.

Ecosystems create and manage their Trust Registries in Verana.

➡️ Learn the basics first in the Learn section.

Key Concepts in Specs v4

In Specs v4, all module operations follow a delegable pattern:

• An authority (group account) controls resources
• An operator executes transactions on behalf of the authority
• Operators must be authorized via the Delegation module

Create Your Own Ecosystem Trust Registry

1. Set up delegation

   • Grant operator authorization so your operator account can act on behalf of the authority group.

2. Publish an Ecosystem Governance Framework (EGF)

   • For fast setup you can use our EGF template.
   • EGF must outline Ecosystem mission, Credential Schema(s), rules for joining the Ecosystem, fee model, compliance, and slashing rules.
   • Make the document publicly reachable (e.g., IPFS / GitHub) and register its digest on-chain.

3. Create your Ecosystem in Verana

   • Create the trust registry
   • Create the credential schema(s) you defined in your EGF, and the root permissions
   • Notify potential interested participants
   • Start onboarding!

Join an Existing Ecosystem: Issuer, Verifier, Grantor (Trust Registry Operator)

Search existing ecosystems and look at their credential schemas.

If you want to work with credentials governed by an existing Ecosystem:

1. Review & accept its EGF.
2. Choose the Credential Schema relevant to your business case.
3. Request the right permission:
   • Issuer Grantor or Verifier Grantor → operate the trust registry branch.
   • Issuer → issue credentials.
   • Verifier → request presentations.
4. Depending on schema rules, either:
   • Self-create your permission (OPEN mode), or
   • Run a validation process with a Grantor / Ecosystem owner (GRANTOR / ECOSYSTEM mode).

Join as a Holder

1. Accept the Ecosystem's EGF.
2. Pick the Credential Schema you need.
3. Select an authorized Issuer (or self-issue if you already have Issuer rights).
4. Receive your Verifiable Credential and store it in your wallet.