Login

Usage

Given an existing instance of the SessionKit, the async method login can be called and awaited without any additional parameters.

const sessionKit = new SessionKit(args, options)

const result = await sessionKit.login()

While awaiting the result of this call, the UserInterface defined in the SessionKit will present any required choices to the end user, which allows them to select a WalletPlugin, a ChainDefinition, and a PermissionLevel. The choices made by the end user will be used to create and configure a new Session instance.

Upon completion, the login method will return a LoginResult that contains:

• The session that is now available to perform transactions.
• The response from the WalletPlugin that was used, indicating which blockchain and permission was returned.
• The context object (a LoginContext) that was used during the login process.

The Session instance that was returned in the result will automatically be persisted in the application through use of the SessionStorage adapter, and in the future can be retrieved with the Restore method.

Options

Additional parameters may optionally be passed to the login method in order to further control the flow of this specific call. The option specified in this way will override the defaults inherited in the SessionKit for this specific call to login.

Commonly used parameters that can be passed this way include:

• chain: The blockchain ID to login against, preventing any user chain selection.
• chains: An array of blockchain IDs to allow logging in against, overriding the defaults from the SessionKit.
• permissionLevel: A specific PermissionLevel to login with, preventing any user account selection.
• walletPlugin: A specific WalletPlugin to authenticate with, preventing any user wallet selection.

A complete list of all parameters can be found in the LoginOptions documentation.

const sessionKit = new SessionKit(
  {
    ...args,
    chains: [
      Chains.Jungle4,
      Chains.EOS,
      Chains.Telos,
      Chains.UX,
      Chains.WAX,
    ],
  },
  options
)

const result = await sessionKit.login()

const result = await sessionKit.login({
  chain: Chains.Jungle4,
})