/ssx

Self-Sovereign Anything

Primary LanguageTypeScriptApache License 2.0Apache-2.0

codecov

SSX

SSX is a library that enables you to easily add user authentication, session management, and more to your app.

Documentation

https://docs.ssx.id

SDKs

Useful Commands

⚠ This repository requires node >= 18.16.0

  • yarn - Install dependencies and build packages
  • yarn build - Build all packages and examples
  • yarn build:packages - Build all packages
  • yarn build:examples - Build all examples
  • yarn examples - Concurrently run the ssx-test-app and ssx-test-express-api found in ./examples
  • yarn test - Run unit tests (Jest)
  • yarn test:e2e - Run E2E tests (Cypress/Synpress)
  • yarn reset - Remove all build artifacts and node_modules

Docker

SSX ships with a Docker Compose configuration for setting up a local development and testing environment with SSX server and our example app. Make sure you have Docker and Compose installed, then create a .env file in the project root:

ssx_listenPort=8443 # ssx server will be available on http://localhost:8443
ssx_signingKey= # session secret for ssx server
ssx_providers__metrics__apiKey= # ssx metrics api key https://app.ssx.id
ssx_providers__rpc__apiKey= # infura api key for wallet connect (optional)

Save your .env file and from the project root, run:

docker compose up

Docker will build containers for the SSX server and example app from the working tree and start them both.