Support & Contributing

Get help, report issues, and contribute to the SIROS Registry and mtcvctm projects.

Getting Help

If you have questions about using the SIROS Registry or mtcvctm tool:

Reporting Issues

Found a bug or want to request a feature? We track issues separately for each project:

mtcvctm Library

For issues with the Markdown-to-credential-metadata converter or multi-format output generation:

  • Parsing or conversion errors
  • Multi-format generation (SD-JWT VC, mDOC, W3C VC)
  • Markdown format questions
  • Documentation improvements
Open Issue on mtcvctm

Registry Website

For issues with the SIROS Registry website (registry.siros.org):

  • Display or rendering problems
  • Registry discovery issues
  • Website navigation or UI bugs
  • Documentation on the site
  • New feature requests for the registry
Open Issue on Registry

What to Include

When reporting a bug, please include:

  • Description — Clear description of the issue
  • Steps to reproduce — How to trigger the problem
  • Expected behavior — What should happen
  • Actual behavior — What actually happens
  • Environment — OS, Go version (if using CLI), browser (if website issue)
  • Sample files — Markdown files or configuration that triggers the issue

For feature requests, please describe:

  • Use case — What problem does this solve?
  • Proposed solution — How should it work?
  • Alternatives — Other approaches you've considered

Contributing

We welcome contributions! To get started:

  1. Fork the repository on GitHub
  2. Create a feature branch from main
  3. Make your changes with clear commit messages
  4. Add tests if applicable
  5. Submit a pull request

Development Setup

registry-cli (Go)

git clone https://github.com/sirosfoundation/registry-cli.git
cd registry-cli
go build ./...
go test ./...

Registry Website

git clone https://github.com/sirosfoundation/registry.siros.org.git
cd registry.siros.org
# Build requires registry-cli:
go install github.com/sirosfoundation/registry-cli/cmd/registry-cli@latest
registry-cli build --sources sources.yaml --templates templates-go --static static --output dist

Project Repositories

Project Description Links
mtcvctm Markdown to credential metadata library (embedded in registry-cli) Repository · Issues
registry-cli CLI tool for building and signing the registry catalogue Repository · Issues
registry.siros.org SIROS Credential Type Registry website and configuration Repository · Issues
vctm-template Template repository for creating credential type definitions Repository

Community

The SIROS Foundation develops open standards and tools for verifiable credentials and digital identity. Learn more at: