Authereum SDK

Using Authereum as a Web3 provider is recommended, but you can also use the Authereum SDK directly.

Example of initializing Authereum SDK:

import Authereum from 'authereum

const authereum = new Authereum('kovan')


  • Networks

    • mainnet

    • kovan

    • rinkeby

    • ropsten

    • goerli

  • Configuration object and overrides

    • config

      • networkName - default: mainnet

      • apiKey - default: null use your API key

      • rpcUri - default:

      • webUri - default:

      • xsUri - default:

      • disableNotifications - default: false

      • blockedPopupRedirect - default true

      • forceRedirect - default false

  • Example:

    const authereum = new Authereum({
      networkName: 'kovan',
      disableNotifications: true
    • Example:

      const authereum = new Authereum({
        rpcUri: ''

NOTE: Using private chains or custom local RPC urls are not supported at the moment. Read the FAQ for more info.


  • ready

    • Emitted when SDK is ready to be used

  • iframeReady

    • Emitted when iframe connection is ready

  • openPopup

    Emitted when popup has opened, typically from a login request.

  • closePopup

    • Emitted when popup has closed, typically from logging in.

  • popupBlocked

    • Emitted when the login popup is blocked by the browser.

  • login

    • Emitted when user successfully logged in.

  • logout

    • Emitted when user logs out.

  • dappKeyExpired

    • Emitted when the dapp key expires.

  • error

    • Emitted when ever there's an error.


  • login()

    • Show login window to authenticate.

  • logout()

    • Logout from dapp.

  • showWidget(bool?)

    • Show Authereum widget on page.

  • hideWidget()

    • Hide Authereum widget from page.

  • getDappKey()

    • Get logged in user's dapp key info like public address

  • getTransactionReceipt(transactionHash)

    • Returns the transaction receipt with receipt.status being false if the top-level transaction failed or any of the internal transactions failed. The receipt status will be true if both the top-level transaction succeeded and all the internal transactions succeeded.

  • hasRecoveryEnabled()

    • Returns true if user has a recovery option set.

  • waitForTransactionReceipt(transactionHash)

    • Will wait for transaction to be mined to return transaction receipt.

  • signMessageWithSigningKey(message)

    • Sign a message using a persistent key dedicated for signing message. Check browser compatibility before using this method since it relies on cross-site storage.

  • getSigningKeyAddress()

    • Returns the public address of the signing key.

  • isAuthenticated()

    • Returns true if user is logged into dapp with Authereum.

  • isContractDeployed(accountAddress?)

    • Returns true if account address is a deployed contract.

  • addFunds(options?)

    • Render a fiat on-ramp modal to buy ETH or DAI.

    • The optional options object is for filtering the payment options available.

      • countryCode : 2-letter country code (ie 'US', 'GB', etc)

      • tokenSymbol : Token symbol (ie 'ETH', 'DAI' ,etc)

      • sourceAmount : Source fiat amount (ie 25, 100, etc)

      • Example:

        • authereum.addFunds({
            countryCode: 'US',
            tokenSymbol: 'DAI',
            sourceAmount: 25
  • version()

    • Returns the SDK version.

Browserify example

Install authereum sdk:

npm i authereum

Install browserify globally:

npm i -g browserify

Initialize authereum sdk in index.js

const { Authereum } = require('authereum')

const authereum = new Authereum()

Browserify index.js to create a bundled file which can be ran in the browser:

browserify index.js > bundle.js

Include the script tag with bundle.js in your html:

<!DOCTYPE html>
<html lang="en-US">
  <meta charset="UTF-8">
  <script src="bundle.js"></script>


Logging in:

import Authereum from 'authereum

const authereum = new Authereum('kovan')
await authereum.login()

Getting account address:

import Authereum from 'authereum

const authereum = new Authereum('kovan')
const address = await authereum.getAccountAddress()


import Authereum from 'authereum

const authereum = new Authereum('kovan')

.on('ready', () => {
.on('error', err => {

Last updated