SDK Configuration

  var streambird = MoonKey('pk_test_KJuRUZmh1XC342h1n39gH84MuSZDyD13NfhtDkaY6IfwpQA0H', {
    headless: false,
    networkConfig: {
      rpcUrl: 'https://goerli.infura.io/v3/INFURA_API_KEY'
    }
  });

  // see Options Example tab ^^
  streambird.init(options);

  var options = {
    elementId: "magicLinkDiv",
    enabledProducts: ['emailMagicLink'],
    config: {
      emailMagicLink: {
        loginRedirectUrl: 'http://localhost::8080/login/authenticate',
        registrationRedirectUrl: 'http://localhost:8080/register/authenticate',
        loginExpiresIn: 5,
        registrationExpireIn: 5,
        requiresVerification: false,
        autoVerify: true
      },
      componentStyle: {
        width: 500,
        showHeaderText: true,
        headerText: 'Sign in or register',
        headerTextColor: '',
        bodyText: 'Please enter your email address',
        bodyTextColor: '#333333',
        buttonTextColor: '#FFFFFF',
        buttonColor: '',
        errMsgColor: '',
        showContainerBorder: true,
        containerXAlignment: 'center',
        containerYAlignment: 'center',
        bodyTextPosition: 'center',
        headerTextPosition: 'center'
      },
      wallet: {
        walletType: 'ETH',
        network: 'https://goerli.infura.io/v3/INFURA_API_KEY'
      }
    },
    callbacks: {
      onSuccess: async (data) => {
        // promise: check if user is logged in
        const isLogged = await sdk.sessions.isLoggedIn()
        // promise: get accounts from provider
        const accounts = await sdk.rpcProvider.send('eth_accounts', [])
        // promise: get user 
        const user = await sdk.users.getCurrentUser()
      },
      onError: (data) => {
        console.log("callback onError", data);
      }
    }
  }

  {
    eventType: 'EVENT_SUCCESS', 
    eventData: {
      publicAddress: "xvPgUXBKTPUBrBdZWHajG17nWM59Zmx7s5NhXXXXXXX",
      sessionJwt: "eyJhbGciOiJ...",
      sessionToken: "TqXsQbXoTxKvjRAqVyLjrz8cRdQRM4enTUh9ixkoeClcgldtzs4LUxEB1XXXXXXX",
      walletType: "SOL",
      public_address: "xvPgUXBKTPUBrBdZWHajG17nWM59Zmx7s5NhXXXXXXX", // legacy field
      session_token: "TqXsQbXoTxKvjRAqVyLjrz8cRdQRM4enTUh9ixkoeClcgldtzs4LUxEB1XXXXXXX", // legacy field
      wallet_type: "SOL" // legacy field
    }
  }

options parameters

string

required

Refers to the DOM element to mount the SDK component UI.
e.g. <div id="login"></div> here the elementId: "login"

[string]

required

Determines what products will be enabled within the SDK component UI. Possible values: emailMagicLink. Coming soon: oauth, smsOtp, emailOtp.

MoonKeyClientProps Object

Hide attributes

EmailMagicLinkOptions Object

This is the config for emailMagicLink and required if emailMagicLink is enabled in enabledProducts

Show childen attributes

The base url we will use to construct the final login magic link and send to the user via email if this is a login (existing user). If the redirect_url is https://moonkey.fun/authenticate, final url user sees in email will be https://moonkey.fun/authenticate?token=AUTOGENERATED_MAGIC_TOKEN. We will redirect to your app in this url and your app should handle and parse the token parameter and allow the user log in.

string

The base url we will use to construct the final login magic link and send to the user via email if this is a registration (new user). If the redirect_url is https://moonkey.fun/authenticate, final url user sees in email will be https://moonkey.fun/authenticate?token=AUTOGENERATED_MAGIC_TOKEN. We will redirect to your app in this url and your app should handle and parse the token parameter and register the user.

Expiration time of the magic link in minutes for login (when an existing user is found) Must be between 5 to 10080 minutes (7 days), defaults to 60 minutes.

integer

Expiration time of the magic link in minutes for registration (when a new user is created). Must be between 5 to 10080 minutes (7 days), defaults to 60 minutes.

boolean

Determines if verification for the authentication method (email, phone_number) is required before marking the user as active.

boolean

Determines if the user should receive a magic token that will redirect to a MoonKey hosted verify token page instead of the redirect url specified by the App owner. If set to true, the user will receive an encrypted token and MoonKey will handle the token verification on behalf of the App in our hosted page.However, if set to false (by default), user will be redirected to the redirect url and the App must handle the token in magic link in their backend using the MoonKey secret api key.

Web3NetworkConfig Object

Determines what kind of wallet login to perform, if we cannot find any wallets for a new or existing user, we will provision a wallet of the specified type for this user.

Show children attributes

string

Determines what type of wallet to login to or provision on the fly if no wallet is found. Possible values: ETH, SOL.

string

Determines the RPC network to use (eg. mainnet, testnet, goerli, etc)

ComponentStyleBase

Custom styling for the login UI component

Show children attributes

integer

default:"500"

The width of the SDK UI component

boolean

default:"true"

Determines whether or not to show the header text.

string

The header text of the SDK UI component and the default text is Sign in or register

string

default:"#000000"

The color of the header text and the format is hex e.g. #00FFCC

string

The main text in the SDI UI component which sits below the header text and above the email login input. The default text is: “Please enter your email address”

string

default:"#333333"

The color of the header text and the format is hex e.g. #000000

string

default:"#FFFFFF"

The text color of the login button and the format is hex e.g. #33CC00

string

default:"#00C475"

The background color of the login button and the format is hex e.g. #3C4D20

string

The text color of the error messages and the format is hex e.g. #FF0033

boolean

default:"true"

Whether or not to show the shadow border around the SDK UI component.

string

default:"center"

Determine the position of the SDK UI component horizontally. The values include left, center, right

string

default:"center"

Determine the position of the SDK UI component vertically. The values include top, center, bottom

string

default:"center"

Determine the position of the body text inside SDK UI component horizontally. The values include left, center, right

string

default:"center"

Determine the position of the header text inside SDK UI component horizontally. The values include left, center, right

Object

Custom event handler functions for different events triggered within the SDK.

Show childen attributes

function(data) => void

When there is a success event such as when magic link has been sent.

Show responses

string

The type of event that has been triggered. For onSuccess(data) callback function, it will be EVENT_SUCCESS.

Show childen attributes

string

The public address of the wallet

string

The session JWT token linked to this user’s account. Use this session token to authenticate and verify someone. You can either use the JWT or the session token but its a matter of preference. They will differ by the Authorization header syntax.

string

The session token linked to this user’s account. Use this session token to authenticate and verify someone. You can either the session token or the JWT but its a matter of preference. They will differ by the Authorization header syntax.

string

The type of wallet that this account is linked to e.g. SOL, ETH

function(data) => void

Any error that might occur from the SDK or API. This is helpful for doing debug during development and production.

Main

Frontend SDKs

REST API

Concepts and Resources

options parameters

​options parameters

options parameters