Skip to content

joincivil/id-hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Civil Logo


Civil ID Hub

CircleCI Go Report Card Coverage Status

Contributing

The Civil ID Hub is free and open-source. We are looking to evolve this into something the identity ecosystem will find helpful and effortless to use. We encourage your input via PRs, issues and general communication. Please don't be shy.

Roadmap

Some high level items:

  • Server UI v1 to access credentials and identities, along with credential verification and proofs.
  • Integration with Kirby.
  • Work on generically handling DIDs and credentials from other sources.
  • Work on encrypting claims.
  • Peer-to-peer data sync to ensure redundancy and data consistency.
  • Ensuring the cost of running and maintaining an ID Hub is as low as possible.
  • As standards in this ecosystem emerge, moving ID Hub towards those standards.

Install Requirements

This project is using make to run setup, builds, tests, etc and has been tested and running on go 1.12.7. This repo supports go modules so adding it to your GOPATH is unnecessary.

To setup the necessary requirements:

make setup

Lint

Check all the packages for linting errors using a variety of linters via golangci-lint. Check the Makefile for the up to date list of linters.

make lint

Build

make build

Testing

Runs the tests and checks code coverage across the project. Produces a coverage.txt file for use later.

make test

Code Coverage Tool

Run make test and launches the HTML code coverage tool.

make cover

Run

The Civil ID Hub relies on environment vars for configuration. To configure locally, edit the .env file included in the repo to what is needed.

To run the service:

go run cmd/idhub/main.go

To find all the available configuration environment vars:

go run cmd/idhub/main.go -h

There is a CLI script that runs various commands. Run this script to view the available commands:

go run cmd/idhubcli/main.go -h

Supported Persister Types

none, postgresql

Enable Info Logging

Add -logtostderr=true -stderrthreshold=INFO -v=2 as arguments for the main.go command.

Releases

No releases published

Packages

No packages published

Languages