Decentralized Identity for Crypto Finance.
This repository is a monorepo containing the Core Verite Javascript SDK, documentation, as well as several demos to illustrate issuance, verification, revocation, and real-world use-cases of the Verite standard.
- Node.js v14
- npm v7 or greater (
npm i -g npm@7)
This repository is set up as an npm workspace (which requires npm v7 or greater). The dependencies for all packages are installed from the root level using npm install.
Each package in this repository lives in the packages/ directory.
The primary packages in this repository are:
- docs - Documentation for the Verite
- verite - The core Javascript SDK for issuing, verifying, and revoking Verifiable Credentials.
- contract - Two sample ERC20 contracts showcasing how to implement Verite into a smart contract.
- solana - A sample Solana program demonstrating how to implement Verite into a program.
- e2e-demo - A demo walkthrough of the entire Verite project, showcasing issuance, verification, and revocation, with additional demos for DeFi and custodial use cases.
- wallet - A demo wallet for storing and submitting credentials. Written in React Native using Expo.
In addition to the packages above, there are 3 single-purpose demo packages, largely extracted
from the e2e-demo package to help clarify each major function of Verite credentials.
- verite/demo-issuer - A simplified demo of issuing Verifiable Credentials using
verite. - verite/demo-verifier - A simplified demo of verifying Verifiable Credentials using
verite. - verite/demo-revocation - A simplified demo of revoking credentials using
verite.
Each package contains a README file with specific details about how to use the package.
Setting up a new development environment is accomplished by running the following script:
npm run setupThis script will do the following:
- Install all dependencies
- Build the
veriteproject - Set up the local IP hostname for
@verite/e2e-demoto be used with the wallet. - Generate an auth JWT secret for
@verite/e2e-demo - Generate issuer and verifier DIDs and secrets for
@verite/e2e-demo - Build and migrate the database for
@verite/e2e-demo
When first starting, you will likely be most interested in the ./packages/e2e-demo package. This package contains several demos and integrates deeply with verite.
This package contains several isolated demos. One of the demos showcases an Ethereum dApp integration, and requires running a local Ethereum node.
Running an Ethereum node is easily accomplished by using our built-in scripts for running a HardHat node.
- To start a local Ethereum node, simply run:
npm run hardhat:nodeNow you have a local Ethereum node running. This process is long-lived and should remain open in it's own terminal tab.
- Next, you will need to deploy the smart contracts to the local Ethereum network.
npm run hardhat:deployAnd finally, you can run the local demos:
npm run devThis will start your server at http://localhost:3000
To run the wallet, you will need the Expo Go app on your phone.
-
Start the wallet:
npm run wallet
-
Scan the QR code with your phone.
On iOS, scan the QR code with your phone's camera. On Android, scan the QR code from within the Expo Go app.
Each packages in the ./packages folder has instructions on how to get started
independently of other packages. To run a service on it's own, follow the instructions
in the package's README.md file.
NOTE It is recommended that you run npm run clean before manually running a service.
To run type-checking, linting, and tests, simply run:
npm run checkRun tests by running
npm run testNOTE Be sure to have built the verite package by running npm run build:verite.
npm run lintor, with autofix:
npm run lint -- --fixThis app uses Prettier to format the code, and you can auto-format all files with
npm run formatOccasionally, the local hardhat ethereum node and MetaMask become out of sync. If you see an error stating "Nonce too high", you can fix this by:
- Open MetaMask settings
- Click "Advanced"
- Click "Reset Account"