stellar-auth-server

Stellar Auth server library

Server side library for Stellar SEP 0010 implementation.

Installation

Install the package with:

npm install stellar-auth-server --save

Usage

Initialization

const StellarAuth = require('stellar-auth-server');
 
const serverKeyPair = StellarSdk.Keypair.fromSecret('SDL...A2J');
 
// optional param
const options = {
  challengeExpiresIn: 300, // 5 minutes
  invalidSequence: '0',
  anchorName: 'Anchor server'
}
 
const stellarAuth = new StellarAuth(serverKeyPair, options);

• serverKeyPair
  Server Keypair object.
  Required: true
• options
  Object with optional params .
  Required: false
  • challengeExpiresIn
    time in seconds in which the challenge expires.
    Default value: 300 (5 minutes)
    Required: false
  • invalidSequence
    Invalid sequence for stellar transaction.
    Default value: '0'
    Required: false
  • anchorName
    Default anchor name.
    Default value: 'Anchor server'
    Required: false

Challenge

const clientPublicKey = 'GBF...3UZ';
const txBase64 = stellarAuth.challenge(clientPublicKey);
return { transaction: txBase64 };

Verify

stellarAuth.verify(txBase64SignedByClient)
.then(result => { token: buildToken(result.hash, result.clientPublicKey) })
.catch(e => { error: translate(e.message) || e.message })

Development

Run all tests:

$ npm install
$ npm test

Run a single test suite:

$ npm run mocha -- test/lib/challenge.spec.js

Run a single test (case sensitive):

$ npm run mocha -- test/lib/challenge.spec.js --grep 'Should have valid timebounds'

_{^{Library based on Stellar SEP-0010 implementation}}