web5-go

README

web5-go

Table of Contents

• Summary
  • crypto
  • dids
  • jws
  • jwt
• Development
  • Prerequisites
    • hermit
    • Helpful Commands
    • web5 CLI
    • Contributing

Summary

This repo contains the following packages:

package	description
crypto	Key Generation, signing, verification, and a Key Manager abstraction
dids	DID creation and resolution.
jwk	implements a subset of the JSON Web Key spec
jws	JWS (JSON Web Signature) signing and verification
jwt	JWT (JSON Web Token) parsing, signing, and verification

[!IMPORTANT] Check the README in each directory for more details

crypto

Supported Digital Signature Algorithms:

• secp256k1
• Ed25519

dids

Supported DID Methods:

• did:jwk
• 🚧 did:dht 🚧

jws

JWS signing and verification using DIDs

jwt

JWT signing and verification using DIDs

Development

Prerequisites

hermit

This repo uses hermit to manage all environment dependencies (e.g. just, go).

[!IMPORTANT] run . ./bin/activate-hermit everytime you enter this directory if you don't have hermit shell hooks configured

Git hooks

Before contributing, set up the pre-commit hook by running:

cp .githooks/pre-commit .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Helpful Commands

This repo uses just as a command runner. Below is a table of helpful just commands:

command	description
just test	runs all tests
just lint	runs linter

web5 CLI

web5 -h

See cmd/web5/README.md for more information.

Contributing

Each package's README contains in-depth information about the package's structure and suggestions on how add features specific to that package