⚙️Installing SSX

Installing SSX

SSX Client

The SSX library enables you to add user-controlled identity and data to your application.

Installation

SSX can be added as a dependency to your project using your preferred Node.js package manager by running any of the following commands.

npm

npm install @spruceid/ssx

Yarn

yarn add @spruceid/ssx

pnpm

pnpm add @spruceid/ssx

Implementation

Once installed SSX can be instantiated at any point in your frontend app. Below is an example of a function that could be called on a sign-in button. This creates a SSX instance, prompts the user to connect and Sign-In with Ethereum, and stores and returns information about the user's session in the ssx object.

import { SSX } from '@spruceid/ssx';

const signInButtonHandler = async () => {
    const ssx = new SSX();
    const session = await ssx.signIn();
};

SSX works without configuration. However, you can access a robust feature set by enabling and configuring some available options.

You can find all available options in the Configuring SSX section.