Methods

The following shows the methods provided by the Wepin widget JavaScript SDK.

openWidget

await wepin.openWidget()

The openWidget method shows the Wepin widget. The screen displayed in the widget window varies depending on the user's login status. If a user is not logged in, the Wepin widget will show them the login page.

Returned value

  • Promise <void>

closeWidget

wepin.closeWidget()

The closeWidget method closes Wepin widget. Closing the window does not log users out.

getAccounts

let accounts = await wepin.getAccounts(['Ethereum'])

or

let accounts = await wepin.getAccounts()

The getAccounts method returns user accounts of the networks available in the app. It's a method available after the widget login. The parameters are as follows.

Parameters

  • networks: Array of string It is the network of the address you want to receive. If no network is specified, all addresses available in the app are returned. The names of blockchain networks that can be put into networks can be found on the following page.

Returned Value

  • Promise <Array>

    • If a user is logged in, it returns a Promise object resolved with array of account of networks.

      • Type of account is assigned at @wepin/types as IAccount

      • account String

        • address String

        • network String

        • contract String optional

          • token contract address. (@wepin/types(0.0.12 버전 이상) IAccount에 정의되어 있습니다. )

    • If networks aren't passed, it returns a Promise object resolved with array of account of all networks.

    • Example

      [
          {
              "address": "0x0000001111112222223333334444445555556666",
              "network": "Ethereum"
          },
          {
              "address": "0x0000001111112222223333334444445555556666",
              "network": "Ethereum",
              "contract": "0x777777888888999999000000111111222222333333",
          },
      ]
  • Promise <void>

    • If user is not logged in, it returns Promise.

getStatus (Supported from version 0.3.1 and above.)

var status = wepin.getStatus()

The getStatus() method returns lifecycle of wepin.

Returned Value

  • <WepinLifeCycle>

    • The WepinLifeCycle is defined at @wepin/types as (Supports version 0.0.7 and above.)

      • not_initialized: if wepin is not initialized

      • initializing: if wepin is initializing

      • initialized: if wepin is initialized

      • before_login: if wepin is initialized but the user is not logged in

      • login: if the user is logged in

login (Supported from version 0.3.1 and above.)

var userInfo = await wepin.login()

The login() method returns information of the logged-in user. If a user is not logged in, Wepin widget will show login page.

Returned Value

Promise <IWepinUser>

  • Type of IWepinUser is defined in @wepin/types (Supported from version 0.0.7 and above.)

    • status String <'success'|'fail'>

    • userInfo Object (optional)

      • userId String

      • email String

      • provider String <'google'|'apple'>

    • Example

      {
          "status": "success",
          "userInfo": {
              "userID": "123455",
              "email": "abc@test.com",
              "provider": "google"
          }
      }

logout (Supported from version 0.3.1 and above.)

await wepin.logout()

The logout() method performs a wepin logout .

Returned Value

  • Promise <void>

finalize (Supported from version 0.3.1 and above.)

wepin.finalize() 

The finalize() method finalizes the Wepin SDK. The state of wepin changes to not_initialized.

Returned Value

  • void

loginWithExternalToken (Supported from version 0.5.1 and above.)

await wepin.loginWithExternalToken(token, sign, withUI?)

It logs in to the Wepin with external token(e.g., idToken). The loginWithExternalToken() method returns information of the logged-in user.

If the user is not registered on Wepin, and the withUI value is set to true, the registration page will be displayed in the widget. However, if the withUI value is set to false or not defined, a require/wepin-register exception will be triggered.

Parameters

  • token <string>

    • External token value to be used for login (e.g., idToken).

  • sign <string>

    • Signature value for the token provided as the first parameter. (Signature Generation Methods)

    • The key for signing can be obtained from Wepin Workspace. In the Development Tools menu, click Get your authentication key on the Login tab to retrieve the authentication key.

  • withUI <boolean> optional

    • Indicates whether to display the Wepin widget screen if registration is required.

Returned Value

  • Promise <IWepinUser>

    • Type of IWepinUser is defined in @wepin/types (Supports version 0.0.7 and above.)

      • status <'success'|'fail'>

      • userInfo <object> optional

        • userId <string>

        • email <string>

        • provider <'external_token'>

    • Example

      {
      	status: 'success',
      	userInfo: {
      		userID: '123455',
      		email: 'abc@test.com',
      		provider: 'external_token'
              }
      }

Exceptions

  • require/wepin-register : If this error occurs, you have to perform the wepin.register(pin) method.

signUpWithEmailAndPassword (Supported from version 0.5.1 and above.)

await wepin.signUpWithEmailAndPassword(email, password)

It signs up on the Wepin with your email and password.

Parameters

  • email <string> - User email

  • password <string> - User password

Returned Value

  • Promise <boolean>

    • Returns true if the signup is successful.

  • Example

    {
    	status: 'success',
    	userInfo: {
    		userID: '123455',
    		email: 'abc@test.com',
    		provider: 'external_token'
            }
    }

Exceptions

loginWithEmailAndPassword (Supported from version 0.5.1 and above.)

await wepin.loginWithEmailAndPassword(email, password)

It logs in to the Wepin with your email and password.

Parameters

  • email <string> - User email

  • password <string> - User password

Returned Value

  • Promise <IWepinUser>

    • Type of IWepinUser is defined in @wepin/types (Supported from version 0.0.8 and above.)

      • status <'success'|'fail'>

      • userInfo <object> optional

        • userId <string>

        • email <string>

        • provider <'email'>

    • Example

      {
      	status: 'success',
      	userInfo: {
      		userID: '123455',
      		email: 'test@test.com',
      		provider: 'email'
              }
      }

Exceptions

  • require/wepin-register : If this error occurs, you have to perform the wepin.register(pin) method.

register (Supported from version 0.5.1 and above.)

await wepin.register(pin)

It registers in the Wepin with a wallet pin.

After the signup and login are completed, the Wepin service registration (wallet and account creation) will proceed.

Parameters

  • pin <string> - Wallet PIN

Returned Value

  • Promise <boolean>

    • Returns true if the registration is successful.

    • After successful registration, the wepin.login(email, password) method has to be performed again.

Exceptions

getBalance (Supported from version 0.5.1 and above.)

await wepin.getBalance(account)

It returns the account balance information. It can be only usable after logging in through the widget.

Parameters

  • account <IAccount> - User email

Returned Value

  • Promise <IAccountBalance>

    • Type of IAccountBalance and ITokenBalance is defined in @wepin/types (Supported from version 0.0.8 and above.)

      • symbol <string> - symbol of the account

      • balance <string> - balance of the account

      • tokens <Array<ITokenBalance>> - token balance information for the account

        • name <string> - token name

        • contract <string> - token contract address

        • symbol <string> - token symbol

        • balance <string> - token balance

    • Example

      {
      	symbol: 'ETH',
              balance: '1.1',
      	tokens:[
      		{
      			name: 'test',
      			contract: '0x123...213',
      			symbol: 'TEST',
      			balance: '10'
      		},
      	]
      }

Exceptions

send (Supported from version 0.5.3 and above.)

await wepin.send(account, options?)

The "send" is performed using the widget, and returns the ID information of the "send" transaction. It can only be used after logging into Wepin.

Parameters

  • account <IAccount> - User email

  • options <ISendOptions> - The information required for the "send".

    • The ISendOptions is defined at @wepin/types.

      • toAddress <string> - The address to send tokens

      • amount <string> - The amount of tokens to send (in network units)

Example

// without options
const result = Wepin.send({
  address: '0x0000001111112222223333334444445555556666',
  network: 'Ethereum',
})

// with options
const result = Wepin.send(
  {
    address: '0x0000001111112222223333334444445555556666',
    network: 'Ethereum',
  },
  { amount: '0.1', toAddress: '0x777777888888999999000000111111222222333333' }
)

Return Value

  • Promise <string>

    • txID (Transaction ID) of the "send" transaction

    • Example

      '0x0000001111112222223333334444445555556666.............aaaaaabbbbbbccccccddddddeeeeeeffffff'

Exceptions

Exceptions

The error message types of the admin method are as follows.

Last updated