Bitski.js

Index

External modules

• “browser/src/auth/access-token”
• “browser/src/auth/auth-provider”
• “browser/src/auth/oauth-manager”
• “browser/src/auth/openid-auth-provider”
• “browser/src/auth/popup-handler”
• “browser/src/auth/token-store”
• “browser/src/auth/user”
• “browser/src/auth/user-store”
• “browser/src/bitski”
• “browser/src/callback”
• “browser/src/components/connect-button”
• “browser/src/components/dialog”
• “browser/src/constants”
• “browser/src/errors/authentication-error”
• “browser/src/errors/parse-error”
• “browser/src/errors/signer-error”
• “browser/src/providers/bitski-browser-engine”
• “browser/src/signing/transaction-signer”
• “browser/src/subproviders/authenticated-cache”
• “browser/src/subproviders/remote-accounts”
• “browser/src/subproviders/signature”
• “browser/src/utils/localstorage-store”
• “browser/src/utils/no-hash-query-string-utils”
• “browser/src/utils/popup-validator”
• “browser/src/utils/request-utils”
• “browser/src/utils/store”
• “provider/src/auth/access-token”
• “provider/src/auth/access-token-provider”
• “provider/src/bitski-engine”
• “provider/src/constants”
• “provider/src/errors/provider-error”
• “provider/src/errors/server-error”
• “provider/src/index”
• “provider/src/network”
• “provider/src/subproviders/authenticated-fetch”
• “provider/src/subproviders/nonce-tracker”
• “provider/src/subproviders/transaction-validator”
• “provider/src/subproviders/typed-data”
• “provider/src/utils/parse-utils”

AccessToken

Represents a Bitski access token

constructor

new AccessToken(token: string, expiresAt?: undefined | number, scope?: undefined | string): AccessToken

Parameters

Return Value

AccessToken

Properties

expiresAt

When the token expires (in seconds)

var expiresAt: undefined | number

Defined in browser/src/auth/access-token.ts:44

scope

Scopes this token has access to

var scope: undefined | string

Defined in browser/src/auth/access-token.ts:49

token

The actual access token

var token: string

Defined in browser/src/auth/access-token.ts:39

expired

Calculates if the token is still active

getexpired(): boolean

Return Value

boolean

Methods

toStorageString

Returns a JSON string suitable for writing in local storage

Declaration

function toStorageString(): string

Defined in browser/src/auth/access-token.ts:78

Return Value

string

fromString

Creates a token from a storage string

Declaration

function fromString(s: string): AccessToken | undefined

Defined in browser/src/auth/access-token.ts:23

Parameters

Return Value

AccessToken ⎮undefined

fromTokenResponse

Creates a token from a TokenResponse object

Declaration

function fromTokenResponse(tokenResponse: TokenResponse): AccessToken

Defined in browser/src/auth/access-token.ts:11

Parameters

Return Value

AccessToken

AuthProvider

Properties

authStatus

var authStatus: AuthenticationStatus

Defined in browser/src/auth/auth-provider.ts:6

Methods

connect

Declaration

function connect(): Promise<User>

Defined in browser/src/auth/auth-provider.ts:8

Return Value

Promise<User>

getUser

Declaration

function getUser(): Promise<User>

Defined in browser/src/auth/auth-provider.ts:10

Return Value

Promise<User>

redirectCallback

Declaration

function redirectCallback(): Promise<User>

Defined in browser/src/auth/auth-provider.ts:11

Return Value

Promise<User>

signIn

Declaration

function signIn(method: OAuthSignInMethod, opts?: SignInOptions): Promise<User>

Defined in browser/src/auth/auth-provider.ts:7

Parameters

Return Value

Promise<User>

signInOrConnect

Declaration

function signInOrConnect(signInMethod?: OAuthSignInMethod, opts?: SignInOptions): Promise<User>

Defined in browser/src/auth/auth-provider.ts:9

Parameters

Return Value

Promise<User>

signOut

Declaration

function signOut(): Promise<User>

Defined in browser/src/auth/auth-provider.ts:12

Return Value

Promise<User>

OAuthManager

Responsible for submitting requests to our OAuth server.

constructor

new OAuthManager(options: OAuthManagerOptions): OAuthManager

Parameters

Return Value

OAuthManager

Properties

configuration

var configuration: AuthorizationServiceConfiguration

Defined in browser/src/auth/oauth-manager.ts:44

Methods

redirectCallback

Attempt to finalize auth request from a redirect flow. Called from your redirect url once you’ve been redirected back.

Declaration

function redirectCallback(): Promise<TokenResponse>

Defined in browser/src/auth/oauth-manager.ts:112

Return Value

Promise<TokenResponse>

refreshAccessToken

Request a new access token from a previous refresh token

Declaration

function refreshAccessToken(refreshToken: string): Promise<TokenResponse>

Defined in browser/src/auth/oauth-manager.ts:137

Parameters

Return Value

Promise<TokenResponse>

requestAccessToken

Exchange an authorization code for an access token

Declaration

function requestAccessToken(code: string): Promise<TokenResponse>

Defined in browser/src/auth/oauth-manager.ts:128

Parameters

Return Value

Promise<TokenResponse>

requestSignOut

Submit a sign out request on the oauth endpoint

Declaration

function requestSignOut(accessToken: string): Promise<any>

Defined in browser/src/auth/oauth-manager.ts:146

Parameters

Return Value

Promise<any>

requestUserInfo

Request a user’s profile from the oauth server

Declaration

function requestUserInfo(accessToken: string): Promise<UserInfoResponse>

Defined in browser/src/auth/oauth-manager.ts:163

Parameters

Return Value

Promise<UserInfoResponse>

signInPopup

Trigger a popup sign in flow (the default)

Declaration

function signInPopup(opts?: SignInOptions): Promise<TokenResponse>

Defined in browser/src/auth/oauth-manager.ts:77

Parameters

Return Value

Promise<TokenResponse>

signInRedirect

Trigger a redirect sign in flow. Promise should never fulfill, as you will be redirected.

Declaration

function signInRedirect(opts?: SignInOptions): Promise<AuthorizationResponse>

Defined in browser/src/auth/oauth-manager.ts:94

Parameters

Return Value

Promise<AuthorizationResponse>

OAuthManagerOptions

Properties

additionalScopes

var additionalScopes: string[]

Defined in browser/src/auth/oauth-manager.ts:28

clientId

var clientId: string

Defined in browser/src/auth/oauth-manager.ts:25

configuration

var configuration: AuthorizationServiceConfiguration

Defined in browser/src/auth/oauth-manager.ts:27

redirectUri

var redirectUri: string

Defined in browser/src/auth/oauth-manager.ts:26

SignInOptions

Properties

login_hint

var login_hint: undefined | string

Defined in browser/src/auth/oauth-manager.ts:32

«Const» LOGIN_HINT_SIGNUP

var LOGIN_HINT_SIGNUP: "signup" = "signup"

Defined in browser/src/auth/oauth-manager.ts:36

OpenidAuthProvider

constructor

new OpenidAuthProvider(clientId: string, redirectUri: string, additionalScopes?: string[], opts?: BitskiSDKOptions): OpenidAuthProvider

Parameters

Return Value

OpenidAuthProvider

Properties

oauthManager

var oauthManager: OAuthManager

Defined in browser/src/auth/openid-auth-provider.ts:12

signOutCallback

var signOutCallback: undefined | function

Defined in browser/src/auth/openid-auth-provider.ts:15

tokenStore

var tokenStore: TokenStore

Defined in browser/src/auth/openid-auth-provider.ts:13

userStore

var userStore: UserStore

Defined in browser/src/auth/openid-auth-provider.ts:14

authStatus

getauthStatus(): AuthenticationStatus

Return Value

AuthenticationStatus

Methods

connect

Declaration

function connect(): Promise<User>

Defined in browser/src/auth/openid-auth-provider.ts:108

Return Value

Promise<User>

getAccessToken

Declaration

function getAccessToken(): Promise<string>

Defined in browser/src/auth/openid-auth-provider.ts:42

Return Value

Promise<string>

getRefreshToken

Declaration

function getRefreshToken(): Promise<string>

Defined in browser/src/auth/openid-auth-provider.ts:52

Return Value

Promise<string>

getUser

Declaration

function getUser(): Promise<User>

Defined in browser/src/auth/openid-auth-provider.ts:114

Return Value

Promise<User>

invalidateToken

Declaration

function invalidateToken(): Promise<void>

Defined in browser/src/auth/openid-auth-provider.ts:64

Return Value

Promise<void>

redirectCallback

Declaration

function redirectCallback(): Promise<User>

Defined in browser/src/auth/openid-auth-provider.ts:129

Return Value

Promise<User>

refreshAccessToken

Declaration

function refreshAccessToken(): Promise<string>

Defined in browser/src/auth/openid-auth-provider.ts:74

Return Value

Promise<string>

signIn

Declaration

function signIn(method: OAuthSignInMethod, opts?: SignInOptions): Promise<User>

Defined in browser/src/auth/openid-auth-provider.ts:89

Parameters

Return Value

Promise<User>

signInOrConnect

Declaration

function signInOrConnect(signInMethod?: OAuthSignInMethod, opts?: SignInOptions): Promise<User>

Defined in browser/src/auth/openid-auth-provider.ts:118

Parameters

Return Value

Promise<User>

signOut

Declaration

function signOut(): Promise<any>

Defined in browser/src/auth/openid-auth-provider.ts:136

Return Value

Promise<any>

Relationships

Implements

• AccessTokenProvider
• "browser/src/auth/auth-provider".AuthProvider

PopupBlockedError

constructor

new PopupBlockedError(): PopupBlockedError

Return Value

PopupBlockedError

Properties

Methods

Relationships

Extends

• AuthorizationError

PopupClosedError

constructor

new PopupClosedError(): PopupClosedError

Return Value

PopupClosedError

Properties

Methods

Relationships

Extends

• AuthorizationError

PopupRequestHandler

constructor

new PopupRequestHandler(utils?: BasicQueryStringUtils, crypto?: DefaultCrypto): PopupRequestHandler

Parameters

Return Value

PopupRequestHandler

Properties

Methods

callback

Declaration

function callback(url: Location)

Defined in browser/src/auth/popup-handler.ts:105

Parameters

completeAuthorizationRequest

Declaration

function completeAuthorizationRequest(): Promise<AuthorizationRequestResponse | null>

Defined in browser/src/auth/popup-handler.ts:119

Return Value

Promise<AuthorizationRequestResponse ⎮null>

completeAuthorizationRequestIfPossible

Declaration

function completeAuthorizationRequestIfPossible(): Promise<void>

Defined in browser/src/auth/popup-handler.ts:111

Return Value

Promise<void>

performAuthorizationRequest

Declaration

function performAuthorizationRequest(configuration: AuthorizationServiceConfiguration, request: AuthorizationRequest)

Defined in browser/src/auth/popup-handler.ts:85

Parameters

Relationships

Extends

• AuthorizationRequestHandler

Functions

createCenteredPopupFeatures

Declaration

function createCenteredPopupFeatures(): any

Defined in browser/src/auth/popup-handler.ts:47

Return Value

any

createPopupFeatureString

Declaration

function createPopupFeatureString(features: any): string

Defined in browser/src/auth/popup-handler.ts:33

Parameters

Return Value

string

TokenStore

constructor

new TokenStore(clientId: string, store?: Store): TokenStore

Parameters

Return Value

TokenStore

currentToken

getcurrentToken(): string | undefined

Return Value

string ⎮undefined

refreshToken

getrefreshToken(): string | undefined

Return Value

string ⎮undefined

Methods

clear

Declaration

function clear()

Defined in browser/src/auth/token-store.ts:61

invalidateCurrentToken

Declaration

function invalidateCurrentToken()

Defined in browser/src/auth/token-store.ts:56

persistTokenResponse

Declaration

function persistTokenResponse(response: TokenResponse)

Defined in browser/src/auth/token-store.ts:47

Parameters

User

constructor

new User(id: string, accounts?: string[], email?: undefined | string, emailVerified?: undefined | false | true, phone?: undefined | string, phoneNumberVerified?: undefined | false | true): User

Parameters

Return Value

User

Properties

accounts

var accounts: string[]

Defined in browser/src/auth/user.ts:30

email

var email: undefined | string

Defined in browser/src/auth/user.ts:31

emailVerified

var emailVerified: undefined | false | true

Defined in browser/src/auth/user.ts:32

id

var id: string

Defined in browser/src/auth/user.ts:29

phoneNumber

var phoneNumber: undefined | string

Defined in browser/src/auth/user.ts:33

phoneNumberVerified

var phoneNumberVerified: undefined | false | true

Defined in browser/src/auth/user.ts:34

Methods

toStorageString

Declaration

function toStorageString(): string

Defined in browser/src/auth/user.ts:45

Return Value

string

fromJson

Declaration

function fromJson(json: UserInfoResponse): User

Defined in browser/src/auth/user.ts:12

Parameters

Return Value

User

fromString

Declaration

function fromString(s: string): User | undefined

Defined in browser/src/auth/user.ts:16

Parameters

Return Value

User ⎮undefined

UserInfoResponse

Properties

accounts

var accounts: string[]

Defined in browser/src/auth/user.ts:3

email

var email: undefined | string

Defined in browser/src/auth/user.ts:4

email_verified

var email_verified: undefined | false | true

Defined in browser/src/auth/user.ts:7

phone_number

var phone_number: undefined | string

Defined in browser/src/auth/user.ts:5

phone_number_verified

var phone_number_verified: undefined | false | true

Defined in browser/src/auth/user.ts:6

sub

var sub: string

Defined in browser/src/auth/user.ts:2

UserStore

constructor

new UserStore(clientId: string, store?: Store): UserStore

Parameters

Return Value

UserStore

currentUser

getcurrentUser(): User | undefined

Return Value

User ⎮undefined

Methods

clear

Declaration

function clear()

Defined in browser/src/auth/user-store.ts:31

set

Declaration

function set(user: User | undefined)

Defined in browser/src/auth/user-store.ts:26

Parameters

AuthenticationStatus

Connected

var Connected:  = "CONNECTED"

Defined in browser/src/bitski.ts:21

Expired

var Expired:  = "EXPIRED"

Defined in browser/src/bitski.ts:22

NotConnected

var NotConnected:  = "NOT_CONNECTED"

Defined in browser/src/bitski.ts:23

OAuthSignInMethod

Popup

var Popup:  = "POPUP"

Defined in browser/src/bitski.ts:16

Redirect

var Redirect:  = "REDIRECT"

Defined in browser/src/bitski.ts:15

Silent

var Silent:  = "SILENT"

Defined in browser/src/bitski.ts:17

Bitski

Bitski SDK

constructor

new Bitski(clientId: string, redirectUri?: undefined | string, additionalScopes?: string[], options?: BitskiSDKOptions): Bitski

Parameters

Return Value

Bitski

authStatus

Check the logged in state of the user

getauthStatus(): AuthenticationStatus

Return Value

AuthenticationStatus

Methods

addSignOutHandler

Register a callback to be called on sign out. This is a good practice, since there may be situations where you are signed out unexpectedly.

Declaration

function addSignOutHandler(fn: function)

Defined in browser/src/bitski.ts:219

Parameters

connect

Connects to bitski to get a valid access token if possible.

Declaration

function connect(): Promise<User>

Defined in browser/src/bitski.ts:180

Return Value

Promise<User>

getConnectButton

Creates a sign in with bitski button to add to your app. If an HTML element is passed in as the first parameter, it will automatically add it to the DOM inside that element. Make sure to add a callback to get notified of login events.

Declaration

function getConnectButton(options?: ConnectButtonOptions, callback?: undefined | function): ConnectButton

Defined in browser/src/bitski.ts:134

Parameters

Return Value

ConnectButton

getCurrentAccessToken

Retrieves the current access token for the user, if logged in.

Declaration

function getCurrentAccessToken(): Promise<string>

Defined in browser/src/bitski.ts:202

Return Value

Promise<string>

getCurrentRefreshToken

Retrieves the current refresh token for the user, if logged in. Requires that the user has approved your application for offline access.

Declaration

function getCurrentRefreshToken(): Promise<string>

Defined in browser/src/bitski.ts:210

Return Value

Promise<string>

getProvider

Returns a new web3 provider for a given network.

Declaration

function getProvider(options?: ProviderOptions | string): BitskiEngine

Defined in browser/src/bitski.ts:105

Parameters

Return Value

BitskiEngine

getUser

Gets the current signed in user. Will reject if we are not signed in.

Declaration

function getUser(): Promise<User>

Defined in browser/src/bitski.ts:173

Return Value

Promise<User>

redirectCallback

Call from your oauth redirect page.

Declaration

function redirectCallback(): Promise<User>

Defined in browser/src/bitski.ts:195

Return Value

Promise<User>

removeSignOutHandler

Remove a registered signout callback

Declaration

function removeSignOutHandler(fn: function)

Defined in browser/src/bitski.ts:227

Parameters

signIn

Starts the sign in flow. Will trigger a popup window over your app, so it must be called within a user interaction handler such as a click.

Declaration

function signIn(options?: SignInOptions): Promise<User>

Defined in browser/src/bitski.ts:166

Parameters

Return Value

Promise<User>

signInRedirect

Starts redirect sign in flow. This is an alternative flow to the popup that all takes place in the same browser window.

Declaration

function signInRedirect(options?: SignInOptions)

Defined in browser/src/bitski.ts:188

Parameters

signOut

Sign the current user out of your application.

Declaration

function signOut(): Promise<void>

Defined in browser/src/bitski.ts:237

Return Value

Promise<void>

start

Signs in or connects to bitski depending on the user’s auth state. Since it may open a popup, this method must be called from user interaction handler, such as a click or tap handler.

Declaration

function start(options?: SignInOptions): Promise<User>

Defined in browser/src/bitski.ts:144

Parameters

Return Value

Promise<User>

callback

Alternative to using our static callback.html file. Call this from your own redirect page.

Declaration

function callback()

Defined in browser/src/bitski.ts:70

BitskiSDKOptions

Properties

configuration

var configuration: AuthorizationServiceConfiguration

Defined in browser/src/bitski.ts:45

store

var store: Store

Defined in browser/src/bitski.ts:47

ProviderOptions

Properties

additionalHeaders

var additionalHeaders: undefined | object

Defined in browser/src/bitski.ts:57

apiBaseUrl

var apiBaseUrl: undefined | string

Defined in browser/src/bitski.ts:59

disableBlockTracking

var disableBlockTracking: undefined | false | true

Defined in browser/src/bitski.ts:56

disableCaching

var disableCaching: undefined | false | true

Defined in browser/src/bitski.ts:54

disableValidation

var disableValidation: undefined | false | true

Defined in browser/src/bitski.ts:55

minGasPrice

var minGasPrice: undefined | number

Defined in browser/src/bitski.ts:60

network

var network: Network

Defined in browser/src/bitski.ts:52

networkName

var networkName: undefined | string

Defined in browser/src/bitski.ts:51

pollingInterval

var pollingInterval: undefined | number

Defined in browser/src/bitski.ts:53

webBaseUrl

var webBaseUrl: undefined | string

Defined in browser/src/bitski.ts:58

ConnectButtonSize

Sizing options for the Bitski connect button.

Large

var Large:  = "LARGE"

Defined in browser/src/components/connect-button.ts:11

Medium

var Medium:  = "MEDIUM"

Defined in browser/src/components/connect-button.ts:10

Small

var Small:  = "SMALL"

Defined in browser/src/components/connect-button.ts:9

ConnectButton

A button used to connect to Bitski.

constructor

new ConnectButton(authProvider: AuthProvider, options?: ConnectButtonOptions, callback?: undefined | function): ConnectButton

Parameters

Return Value

ConnectButton

Properties

callback

var callback: undefined | function

Defined in browser/src/components/connect-button.ts:39

element

var element: HTMLElement

Defined in browser/src/components/connect-button.ts:33

onCancel

var onCancel: undefined | function

Defined in browser/src/components/connect-button.ts:42

size

var size: ConnectButtonSize

Defined in browser/src/components/connect-button.ts:36

Methods

remove

Removes the button from the page

Declaration

function remove()

Defined in browser/src/components/connect-button.ts:83

ConnectButtonOptions

Options for the connect button component

Properties

authMethod

var authMethod: OAuthSignInMethod

Defined in browser/src/components/connect-button.ts:19

container

var container: HTMLElement

Defined in browser/src/components/connect-button.ts:23

signInOptions

var signInOptions: SignInOptions

Defined in browser/src/components/connect-button.ts:21

size

var size: ConnectButtonSize

Defined in browser/src/components/connect-button.ts:25

Dialog

Basic modal dialog

constructor

new Dialog(content: HTMLElement | string, dynamicContent?: boolean): Dialog

Parameters

Return Value

Dialog

Properties

onClose

var onClose: undefined | function

Defined in browser/src/components/dialog.ts:12

Methods

close

Cancels the dialog by dismissing and triggering the close handler.

Declaration

function close()

Defined in browser/src/components/dialog.ts:69

dismiss

Dismisses the dialog without triggering the close handler.

Declaration

function dismiss()

Defined in browser/src/components/dialog.ts:60

hide

Hides the dialog, but does not remove

Declaration

function hide()

Defined in browser/src/components/dialog.ts:53

setLoading

Show or hide the loading indicator

Declaration

function setLoading(loading: boolean)

Defined in browser/src/components/dialog.ts:80

Parameters

show

Show the dialog

Declaration

function show()

Defined in browser/src/components/dialog.ts:47

«Const» TEMPLATE

var TEMPLATE: "
  <div class='bitski-dialog'>
      <button class='bitski-close-button'>Close</button>
      <div class='bitski-dialog-body'></div>
  </div>
" =  `
  <div class='bitski-dialog'>
      <button class='bitski-close-button'>Close</button>
      <div class='bitski-dialog-body'></div>
  </div>
`

Defined in browser/src/components/dialog.ts:1

«Const» ACCESS_TOKEN_KEY

var ACCESS_TOKEN_KEY: "bitski.access_token" = "bitski.access_token"

Defined in browser/src/constants.ts:34

«Const» BITSKI_RPC_BASE_URL

var BITSKI_RPC_BASE_URL: "https://api.bitski.com/v1/web3" = "https://api.bitski.com/v1/web3"

Defined in browser/src/constants.ts:7

«Const» BITSKI_TRANSACTION_API_BASE_URL

var BITSKI_TRANSACTION_API_BASE_URL: "https://api.bitski.com/v1" = "https://api.bitski.com/v1"

Defined in browser/src/constants.ts:6

«Const» BITSKI_USER_API_HOST

var BITSKI_USER_API_HOST: "https://www.bitski.com/v1" = "https://www.bitski.com/v1"

Defined in browser/src/constants.ts:5

«Const» BITSKI_WEB_BASE_URL

var BITSKI_WEB_BASE_URL: "https://sign.bitski.com" = "https://sign.bitski.com"

Defined in browser/src/constants.ts:8

«Const» CACHED_METHODS

var CACHED_METHODS: string[] =  ['eth_accounts']

Defined in browser/src/constants.ts:38

«Const» CHECK_FOR_POPUP_CLOSE_INTERVAL

var CHECK_FOR_POPUP_CLOSE_INTERVAL: 500 = 500

Defined in browser/src/constants.ts:22

«Const» DEFAULT_AUTHORIZED_METHODS

var DEFAULT_AUTHORIZED_METHODS: string[] =  [
  'eth_sendTransaction',
  'eth_signTransaction',
  'eth_sign',
  'personal_sign',
  'eth_signTypedData',
  'eth_signTypedData_v3', // For metamask compatibility
]

Defined in browser/src/constants.ts:39

«Const» DEFAULT_OPTIONAL_SCOPES

var DEFAULT_OPTIONAL_SCOPES: string[] =  ['offline']

Defined in browser/src/constants.ts:19

«Const» DEFAULT_SCOPES

var DEFAULT_SCOPES: string[] =  ['openid']

Defined in browser/src/constants.ts:18

«Const» IFRAME_MESSAGE_ORIGIN_INCLUDES

var IFRAME_MESSAGE_ORIGIN_INCLUDES: ".bitski.com" = ".bitski.com"

Defined in browser/src/constants.ts:9

«Const» REFRESH_TOKEN_KEY

var REFRESH_TOKEN_KEY: "bitski.refresh_token" = "bitski.refresh_token"

Defined in browser/src/constants.ts:33

«Const» SDK_VERSION

var SDK_VERSION: "0.10.6" = "0.10.6"

Defined in browser/src/constants.ts:2

«Const» USER_KEY

var USER_KEY: "bitski.user" = "bitski.user"

Defined in browser/src/constants.ts:35

DEFAULT_OAUTH_CONFIGURATION

authorization_endpoint

var authorization_endpoint: string = "https://account.bitski.com/oauth2/auth"

Defined in browser/src/constants.ts:13

revocation_endpoint

var revocation_endpoint: string = ""

Defined in browser/src/constants.ts:14

token_endpoint

var token_endpoint: string = "https://account.bitski.com/oauth2/token"

Defined in browser/src/constants.ts:15

userinfo_endpoint

var userinfo_endpoint: string = "https://account.bitski.com/userinfo"

Defined in browser/src/constants.ts:16

DEFAULT_POPUP_FEATURES

height

var height: number = 500

Defined in browser/src/constants.ts:27

left

var left: number = 100

Defined in browser/src/constants.ts:28

location

var location: string = "no"

Defined in browser/src/constants.ts:24

toolbar

var toolbar: string = "no"

Defined in browser/src/constants.ts:25

top

var top: number = 100

Defined in browser/src/constants.ts:29

width

var width: number = 500

Defined in browser/src/constants.ts:26

AuthenticationErrorCode

InvalidConfiguration

var InvalidConfiguration:  = 1005

Defined in browser/src/errors/authentication-error.ts:14

NoRefreshToken

var NoRefreshToken:  = 1002

Defined in browser/src/errors/authentication-error.ts:8

NotSignedIn

var NotSignedIn:  = 1000

Defined in browser/src/errors/authentication-error.ts:4

PopupBlocked

var PopupBlocked:  = 1006

Defined in browser/src/errors/authentication-error.ts:16

ServerError

var ServerError:  = 1004

Defined in browser/src/errors/authentication-error.ts:12

UnsupportedAuthenticationMethod

var UnsupportedAuthenticationMethod:  = 1003

Defined in browser/src/errors/authentication-error.ts:10

UserCancelled

var UserCancelled:  = 1001

Defined in browser/src/errors/authentication-error.ts:6

AuthenticationError

Represents an error that is thrown during the authentication process

constructor

new AuthenticationError(message: string, code: AuthenticationErrorCode): AuthenticationError

Parameters

Return Value

AuthenticationError

Properties

code

var code: AuthenticationErrorCode

Defined in browser/src/errors/authentication-error.ts:63

description

var description: undefined | string

Defined in browser/src/errors/authentication-error.ts:64

name

var name: string = "AuthenticationError"

Defined in browser/src/errors/authentication-error.ts:62

Error

var Error: ErrorConstructor

Defined in /Users/ptescher/Development/BitskiCo/bitski-js/node_modules/typedoc/node_modules/typescript/lib/lib.es5.d.ts:974

Methods

InvalidConfiguration

Declaration

function InvalidConfiguration(reason: string): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:58

Parameters

Return Value

AuthenticationError

NoRefreshToken

Declaration

function NoRefreshToken(): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:35

Return Value

AuthenticationError

NotSignedIn

Declaration

function NotSignedIn(): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:25

Return Value

AuthenticationError

PopupBlocked

Declaration

function PopupBlocked(baseUrl: string): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:45

Parameters

Return Value

AuthenticationError

ServerError

Declaration

function ServerError(message: string, description?: undefined | string): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:51

Parameters

Return Value

AuthenticationError

UnsupportedAuthenticationMethod

Declaration

function UnsupportedAuthenticationMethod(): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:40

Return Value

AuthenticationError

UserCancelled

Declaration

function UserCancelled(): AuthenticationError

Defined in browser/src/errors/authentication-error.ts:30

Return Value

AuthenticationError

Relationships

Extends

• Error

ParseErrorCode

InvalidJSON

var InvalidJSON:  = 2000

Defined in browser/src/errors/parse-error.ts:4

NoErrorBody

var NoErrorBody:  = 2001

Defined in browser/src/errors/parse-error.ts:7

ParseError

Represents an error that is thrown during decoding

constructor

new ParseError(message: string, code: ParseErrorCode): ParseError

Parameters

Return Value

ParseError

Properties

code

var code: ParseErrorCode

Defined in browser/src/errors/parse-error.ts:23

name

var name: string = "ParseError"

Defined in browser/src/errors/parse-error.ts:22

Error

var Error: ErrorConstructor

Defined in /Users/ptescher/Development/BitskiCo/bitski-js/node_modules/typedoc/node_modules/typescript/lib/lib.es5.d.ts:974

Methods

InvalidJSON

Declaration

function InvalidJSON(): ParseError

Defined in browser/src/errors/parse-error.ts:14

Return Value

ParseError

UnknownError

Declaration

function UnknownError(): ParseError

Defined in browser/src/errors/parse-error.ts:18

Return Value

ParseError

Relationships

Extends

• Error

SignerErrorCode

MissingFrom

var MissingFrom:  = 3004

Defined in browser/src/errors/signer-error.ts:14

MissingMessage

var MissingMessage:  = 3003

Defined in browser/src/errors/signer-error.ts:12

MissingTransaction

var MissingTransaction:  = 3002

Defined in browser/src/errors/signer-error.ts:9

MissingTypedData

var MissingTypedData:  = 3005

Defined in browser/src/errors/signer-error.ts:17

UnsupportedMethod

var UnsupportedMethod:  = 3000

Defined in browser/src/errors/signer-error.ts:4

UserCancelled

var UserCancelled:  = 3001

Defined in browser/src/errors/signer-error.ts:6

SignerError

constructor

new SignerError(message: string, code: SignerErrorCode): SignerError

Parameters

Return Value

SignerError

Properties

code

var code: SignerErrorCode

Defined in browser/src/errors/signer-error.ts:47

name

var name: string = "TransactionError"

Defined in browser/src/errors/signer-error.ts:46

Error

var Error: ErrorConstructor

Defined in /Users/ptescher/Development/BitskiCo/bitski-js/node_modules/typedoc/node_modules/typescript/lib/lib.es5.d.ts:974

Methods

MissingFrom

Declaration

function MissingFrom(): SignerError

Defined in browser/src/errors/signer-error.ts:38

Return Value

SignerError

MissingMessage

Declaration

function MissingMessage(): SignerError

Defined in browser/src/errors/signer-error.ts:34

Return Value

SignerError

MissingTransaction

Declaration

function MissingTransaction(): SignerError

Defined in browser/src/errors/signer-error.ts:30

Return Value

SignerError

MissingTypedData

Declaration

function MissingTypedData(): SignerError

Defined in browser/src/errors/signer-error.ts:42

Return Value

SignerError

UnsupportedMethod

Declaration

function UnsupportedMethod(): SignerError

Defined in browser/src/errors/signer-error.ts:22

Return Value

SignerError

UserCancelled

Declaration

function UserCancelled(): SignerError

Defined in browser/src/errors/signer-error.ts:26

Return Value

SignerError

Relationships

Extends

• Error

BitskiBrowserEngine

constructor

new BitskiBrowserEngine(clientId: string, tokenProvider: AccessTokenProvider, sdkVersion: string, network: Network, options?: ProviderOptions): BitskiBrowserEngine

Parameters

Return Value

BitskiBrowserEngine

Properties

Methods

Relationships

Extends

• BitskiEngine

Functions

isAuthProvider

Declaration

function isAuthProvider(object: any): boolean

Defined in browser/src/providers/bitski-browser-engine.ts:11

Parameters

Return Value

boolean

BitskiTransactionSigner

This class is responsible for signing transactions. It only knows about Bitski’s proprietary transaction objects. It is also the only class that knows about the iframe signing implementation.

constructor

new BitskiTransactionSigner(webBaseUrl: string, apiBaseUrl: string, defaultHeaders: any): BitskiTransactionSigner

Parameters

Return Value

BitskiTransactionSigner

Methods

sign

Declaration

function sign(transaction: Transaction, accessToken: string): Promise<string>

Defined in browser/src/signing/transaction-signer.ts:41

Parameters

Return Value

Promise<string>

JSONTransactionObject

Properties

transaction

var transaction: Transaction

Defined in browser/src/signing/transaction-signer.ts:9

AuthenticatedCacheSubprovider

constructor

new AuthenticatedCacheSubprovider(authProvider: AuthProvider): AuthenticatedCacheSubprovider

Parameters

Return Value

AuthenticatedCacheSubprovider

Properties

Methods

handleRequest

Declaration

function handleRequest(payload: any, next: any, end: any): any

Defined in browser/src/subproviders/authenticated-cache.ts:18

Parameters

Return Value

any

Relationships

Extends

• Subprovider

RemoteAccountSubprovider

Properties

Methods

handleRequest

Declaration

function handleRequest(payload: any, next: any, end: any)

Defined in browser/src/subproviders/remote-accounts.ts:7

Parameters

Relationships

Extends

• AuthenticatedFetchSubprovider

TransactionKind

SendTransaction

var SendTransaction:  = "ETH_SEND_TRANSACTION"

Defined in browser/src/subproviders/signature.ts:12

Sign

var Sign:  = "ETH_SIGN"

Defined in browser/src/subproviders/signature.ts:14

SignTransaction

var SignTransaction:  = "ETH_SIGN_TRANSACTION"

Defined in browser/src/subproviders/signature.ts:13

SignTypedData

var SignTypedData:  = "ETH_SIGN_TYPED_DATA"

Defined in browser/src/subproviders/signature.ts:15

SignatureSubprovider

A Subprovider that manages the interface between JSON-RPC and Bitski’s proprietary transaction signing flow. This class is responsible for transforming the JSON-RPC request into a Transaction object that the Bitski signer understands. Also responsible for submitting the transaction to the network, and converting the response back into an RPC response.

Important: this class assumes the transaction has all the necessary fields populated. The TransactionValidatorSubprovider should be placed in front of this subprovider.

constructor

new SignatureSubprovider(network: Network, signer: BitskiTransactionSigner, tokenProvider: AccessTokenProvider, signatureMethods?: string[]): SignatureSubprovider

Parameters

Return Value

SignatureSubprovider

Properties

Methods

handleRequest

Handle RPC request from engine (called by)

Declaration

function handleRequest(payload: JSONRPCRequestPayload, next: function, end: JSONRPCResponseHandler)

Defined in browser/src/subproviders/signature.ts:136

Parameters

handleSignatureRequest

Called when a payload is received that needs a signature

Declaration

function handleSignatureRequest(payload: JSONRPCRequestPayload, callback: JSONRPCResponseHandler): Promise<void>

Defined in browser/src/subproviders/signature.ts:149

Parameters

Return Value

Promise<void>

Relationships

Extends

• Subprovider

SignaturePayload

Properties

from

var from: string

Defined in browser/src/subproviders/signature.ts:32

message

var message: string

Defined in browser/src/subproviders/signature.ts:33

Transaction

Properties

context

var context: TransactionContext

Defined in browser/src/subproviders/signature.ts:22

id

var id: string

Defined in browser/src/subproviders/signature.ts:19

kind

var kind: TransactionKind

Defined in browser/src/subproviders/signature.ts:20

payload

var payload: TransactionPayload | SignaturePayload

Defined in browser/src/subproviders/signature.ts:21

TransactionContext

Properties

chainId

var chainId: undefined | number

Defined in browser/src/subproviders/signature.ts:26

currentBalance

var currentBalance: undefined | string

Defined in browser/src/subproviders/signature.ts:27

from

var from: undefined | string

Defined in browser/src/subproviders/signature.ts:28

TransactionPayload

Properties

data

var data: undefined | string

Defined in browser/src/subproviders/signature.ts:40

from

var from: string

Defined in browser/src/subproviders/signature.ts:37

gas

var gas: undefined | string

Defined in browser/src/subproviders/signature.ts:42

gasPrice

var gasPrice: undefined | string

Defined in browser/src/subproviders/signature.ts:43

nonce

var nonce: undefined | string

Defined in browser/src/subproviders/signature.ts:41

to

var to: undefined | string

Defined in browser/src/subproviders/signature.ts:38

value

var value: undefined | string

Defined in browser/src/subproviders/signature.ts:39

TypedDataDefinition

Properties

name

var name: string

Defined in browser/src/subproviders/signature.ts:47

type

var type: string

Defined in browser/src/subproviders/signature.ts:48

TypedDataPayload

Example usage:

const payload: TypedDataPayload = {
  types: {
    EIP712Domain: [
      { name: 'name', type: 'string' },
      { name: 'version', type: 'string' },
      { name: 'chainId', type: 'uint256' },
      { name: 'verifyingContract', type: 'address' },
    ],
    Person: [
      { name: 'name', type: 'string' },
      { name: 'wallet', type: 'address' }
    ],
    Mail: [
      { name: 'from', type: 'Person' },
      { name: 'to', type: 'Person' },
      { name: 'contents', type: 'string' }
    ],
  },
  primaryType: 'Mail',
  domain: {
    name: 'Ether Mail',
    version: '1',
    chainId: 1,
    verifyingContract: '0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC',
  },
  message: {
    from: {
      name: 'Cow',
      wallet: '0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826',
    },
    to: {
      name: 'Bob',
      wallet: '0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB',
    },
    contents: 'Hello, Bob!',
  },
}

Properties

domain

var domain: object

Defined in browser/src/subproviders/signature.ts:98

message

var message: object

Defined in browser/src/subproviders/signature.ts:100

primaryType

var primaryType: string

Defined in browser/src/subproviders/signature.ts:99

types

var types: object

Defined in browser/src/subproviders/signature.ts:94

Type declaration

EIP712Domain: TypedDataDefinition[]

JSONRPCResponseHandler

var JSONRPCResponseHandler: function

Defined in browser/src/subproviders/signature.ts:9

Type declaration

function (error?: JsonRpcError, result?: any)

Parameters

LocalStorageStore

constructor

new LocalStorageStore(storage?: Storage): LocalStorageStore

Parameters

Return Value

LocalStorageStore

Methods

clear

Declaration

function clear()

Defined in browser/src/utils/localstorage-store.ts:13

clearItem

Declaration

function clearItem(key: string)

Defined in browser/src/utils/localstorage-store.ts:25

Parameters

getItem

Declaration

function getItem(key: string): any

Defined in browser/src/utils/localstorage-store.ts:17

Parameters

Return Value

any

setItem

Declaration

function setItem(key: string, value: any)

Defined in browser/src/utils/localstorage-store.ts:21

Parameters

Relationships

Implements

• "browser/src/utils/store".Store

NoHashQueryStringUtils

Methods

parse

Declaration

function parse(input: LocationLike, useHash?: undefined | false | true): StringMap

Defined in browser/src/utils/no-hash-query-string-utils.ts:8

Parameters

Return Value

StringMap

Relationships

Extends

• BasicQueryStringUtils

  Implements

• QueryStringUtils

PopupValidator

A simple utility class that will check to see if a popup is blocked. Derived from info and examples on this page: https://stackoverflow.com/questions/2914/how-can-i-detect-if-a-browser-is-blocking-a-popup

constructor

new PopupValidator(errorHandler: function): PopupValidator

Parameters

Return Value

PopupValidator

Methods

check

Declaration

function check(popup: Window | null)

Defined in browser/src/utils/popup-validator.ts:17

Parameters

Functions

parseResponse

Parses a Fetch Response to extract either the result or the error

Declaration

function parseResponseT(response: Response): Promise<T>

Defined in browser/src/utils/request-utils.ts:8

Type parameters

T

Parameters

Return Value

Promise<T>

Store

Methods

clear

Declaration

function clear(): any

Defined in browser/src/utils/store.ts:5

Return Value

any

clearItem

Declaration

function clearItem(key: any): any

Defined in browser/src/utils/store.ts:14

Parameters

Return Value

any

getItem

Declaration

function getItem(key: any): any

Defined in browser/src/utils/store.ts:8

Parameters

Return Value

any

setItem

Declaration

function setItem(key: any, value: any): any

Defined in browser/src/utils/store.ts:11

Parameters

Return Value

any

AccessToken

A token that provides access to Bitski on behalf of a user.

constructor

new AccessToken(token: string, expiresIn?: undefined | number): AccessToken

Parameters

Return Value

AccessToken

Properties

expiresAt

var expiresAt: undefined | number =  undefined

Defined in provider/src/auth/access-token.ts:6

token

var token: string

Defined in provider/src/auth/access-token.ts:5

expired

getexpired(): boolean

Return Value

boolean

AccessTokenProvider

Methods

getAccessToken

Declaration

function getAccessToken(): Promise<string>

Defined in provider/src/auth/access-token-provider.ts:2

Return Value

Promise<string>

invalidateToken

Declaration

function invalidateToken(): Promise<void>

Defined in provider/src/auth/access-token-provider.ts:3

Return Value

Promise<void>

BitskiEngine

constructor

new BitskiEngine(options?: BitskiEngineOptions): BitskiEngine

Parameters

Return Value

BitskiEngine

Properties

Methods

subscribe

Declaration

function subscribe(subscribeMethod?: string, subscriptionMethod: string, parameters: any[]): Promise<string>

Defined in provider/src/bitski-engine.ts:77

Parameters

Return Value

Promise<string>

supportsSubscriptions

Declaration

function supportsSubscriptions(): boolean

Defined in provider/src/bitski-engine.ts:73

Return Value

boolean

unsubscribe

Declaration

function unsubscribe(subscriptionId: string, unsubscribeMethod?: string): Promise<boolean>

Defined in provider/src/bitski-engine.ts:83

Parameters

Return Value

Promise<boolean>

Relationships

Extends

• Web3ProviderEngine

BitskiEngineOptions

Properties

disableBlockTracking

var disableBlockTracking: undefined | false | true

Defined in provider/src/bitski-engine.ts:23

disableCaching

var disableCaching: undefined | false | true

Defined in provider/src/bitski-engine.ts:19

disableValidation

var disableValidation: undefined | false | true

Defined in provider/src/bitski-engine.ts:21

minGasPrice

var minGasPrice: undefined | number

Defined in provider/src/bitski-engine.ts:25

pollingInterval

var pollingInterval: undefined | number

Defined in provider/src/bitski-engine.ts:17

«Const» AUTHENTICATED_METHODS

var AUTHENTICATED_METHODS: string[] =  [
  'eth_accounts',
  'eth_sendTransaction',
  'eth_signTransaction',
  'eth_signTypedData',
  'personal_sign',
  'eth_sign',
]

Defined in provider/src/constants.ts:2

«Const» RETRIABLE_ERRORS

var RETRIABLE_ERRORS: string[] =  [
  // ignore server overload errors
  'Gateway timeout',
  'ETIMEDOUT',
  'ENOTFOUND', // DNS error
  // ignore server sent html error pages
  // or truncated json responses
  'SyntaxError',
  'ECONNRESET',
  'EHOSTUNREACH',
  'Timeout out while waiting for response', // Actix timeout
]

Defined in provider/src/constants.ts:12

«Const» UNAUTHORIZED_ERRORS

var UNAUTHORIZED_ERRORS: string[] =  [
  'Missing auth', // No token sent
  'Invalid client id', // Wrong client id, or invalid access token
  'Not Authorized',
]

Defined in provider/src/constants.ts:26

ProviderErrorCode

InvalidRequest

var InvalidRequest:  = 4001

Defined in provider/src/errors/provider-error.ts:5

SubscriptionsUnavailable

var SubscriptionsUnavailable:  = 4000

Defined in provider/src/errors/provider-error.ts:3

ProviderError

constructor

new ProviderError(message: string, code: ProviderErrorCode): ProviderError

Parameters

Return Value

ProviderError

Properties

code

var code: ProviderErrorCode

Defined in provider/src/errors/provider-error.ts:19

name

var name: string = "ProviderError"

Defined in provider/src/errors/provider-error.ts:18

Error

var Error: ErrorConstructor

Defined in /Users/ptescher/Development/BitskiCo/bitski-js/node_modules/typedoc/node_modules/typescript/lib/lib.es5.d.ts:974

Methods

InvalidRequest

Declaration

function InvalidRequest(reason: string): ProviderError

Defined in provider/src/errors/provider-error.ts:14

Parameters

Return Value

ProviderError

SubscriptionsUnavailable

Declaration

function SubscriptionsUnavailable(): ProviderError

Defined in provider/src/errors/provider-error.ts:10

Return Value

ProviderError

Relationships

Extends

• Error

ServerError

Represents an error that is received from the server You can access the response code via the code property, and the URI from the requestURI property. The retried property will indicate whether or not the request failed after multiple tries.

constructor

new ServerError(message: string, code: number, requestURI: string, retried?: boolean): ServerError

Parameters

Return Value

ServerError

Properties

code

var code: number

Defined in provider/src/errors/server-error.ts:10

name

var name: string = "ServerError"

Defined in provider/src/errors/server-error.ts:7

requestURI

var requestURI: string

Defined in provider/src/errors/server-error.ts:16

retried

var retried: boolean

Defined in provider/src/errors/server-error.ts:13

Error

var Error: ErrorConstructor

Defined in /Users/ptescher/Development/BitskiCo/bitski-js/node_modules/typedoc/node_modules/typescript/lib/lib.es5.d.ts:974

Relationships

Extends

• Error

JSONRPCRequestPayload

Properties

id

var id: number

Defined in provider/src/index.ts:12

jsonrpc

var jsonrpc: string

Defined in provider/src/index.ts:13

method

var method: string

Defined in provider/src/index.ts:11

params

var params: any[]

Defined in provider/src/index.ts:10

JSONRPCResponsePayload

Properties

id

var id: number

Defined in provider/src/index.ts:18

jsonrpc

var jsonrpc: string

Defined in provider/src/index.ts:19

result

var result: any

Defined in provider/src/index.ts:17

Network

Properties

chainId

var chainId: number

Defined in provider/src/network.ts:3

rpcUrl

var rpcUrl: string

Defined in provider/src/network.ts:2

Kovan

chainId

var chainId: number = 42

Defined in provider/src/network.ts:17

rpcUrl

var rpcUrl: string = "https://api.bitski.com/v1/web3/kovan"

Defined in provider/src/network.ts:18

Mainnet

chainId

var chainId: number = 1

Defined in provider/src/network.ts:7

rpcUrl

var rpcUrl: string = "https://api.bitski.com/v1/web3/mainnet"

Defined in provider/src/network.ts:8

Rinkeby

chainId

var chainId: number = 4

Defined in provider/src/network.ts:12

rpcUrl

var rpcUrl: string = "https://api.bitski.com/v1/web3/rinkeby"

Defined in provider/src/network.ts:13

AuthenticatedFetchSubprovider

constructor

new AuthenticatedFetchSubprovider(rpcUrl: string, debug: boolean, accessTokenProvider: AccessTokenProvider, defaultHeaders?: object): AuthenticatedFetchSubprovider

Parameters

Return Value

AuthenticatedFetchSubprovider

Properties

Methods

handleAuthenticatedRequest

Declaration

function handleAuthenticatedRequest(payload: any, next: any, end: any)

Defined in provider/src/subproviders/authenticated-fetch.ts:30

Parameters

handleRequest

Declaration

function handleRequest(payload: any, next: any, end: any)

Defined in provider/src/subproviders/authenticated-fetch.ts:22

Parameters

handleUnauthenticatedRequest

Declaration

function handleUnauthenticatedRequest(payload: any, next: any, end: any)