BitGo | bitgo - v11.3.0

Hierarchy

BitGo

Index

Constructors

constructor

Properties

Methods

Constructors

constructor

new BitGo(params?: BitGoOptions): BitGo

- Defined in drone/src/modules/core/src/bitgo.ts:423
Constructor for BitGo Object

Parameters
- Default value params: BitGoOptions = {}
Returns BitGo

Properties

env

env: EnvironmentName

Expose env property for backwards compatibility

deprecated

Methods

addAccessToken

addAccessToken(params: AddAccessTokenOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1581
addAccessToken Add a BitGo API Access Token to the current user account

Parameters
- params: AddAccessTokenOptions
  
  { otp: (required) label: (required) duration: ipRestrict: txValueLimit: scope: (required) }
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

{ id: token: label: user: enterprise client: scope: created: expires: origin: isExtensible: extensionAddress: <address whose private key's signature is necessary for extensions> unlock: }

addWebhook

addWebhook(params: WebhookOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2124
Add new user webhook

deprecated

Parameters
- params: WebhookOptions
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

authenticate

authenticate(params: AuthenticateOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1324
Login to the bitgo platform.

Parameters
- params: AuthenticateOptions
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

authenticateWithAccessToken

authenticateWithAccessToken(__namedParameters: object): void

- Defined in drone/src/modules/core/src/bitgo.ts:1150
Synchronous method for activating an access token.

Parameters
- __namedParameters: object
Returns void

authenticateWithAuthCode

authenticateWithAuthCode(params: AuthenticateWithAuthCodeOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1451
Login to the bitgo system using an authcode generated via Oauth

Parameters
- params: AuthenticateWithAuthCodeOptions
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

blockchain

blockchain(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1911
Get the blockchain object.

deprecated

Returns any

calculateHMAC

calculateHMAC(key: string, message: string): string

- Defined in drone/src/modules/core/src/bitgo.ts:735
Calculate the HMAC for the given key and message

Parameters
- key: string
  
  the key to use for the HMAC
- message: string
  
  the actual message to HMAC
Returns string
- the result of the HMAC operation

calculateHMACSubject

calculateHMACSubject(__namedParameters: object): string

- Defined in drone/src/modules/core/src/bitgo.ts:1224
Calculate the string that is to be HMACed for a certain HTTP request or response

Parameters
- __namedParameters: object
Returns string

calculateMinerFeeInfo

calculateMinerFeeInfo(params: any, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2283
V1 method for calculating miner fee amounts, given the number and type of transaction inputs, along with a fee rate in satoshis per vkB.

This method should not be used for new code.

deprecated

Parameters
- params: any
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

calculateRequestHMAC

calculateRequestHMAC(__namedParameters: object): string

- Defined in drone/src/modules/core/src/bitgo.ts:1236
Calculate the HMAC for an HTTP request

Parameters
- __namedParameters: object
Returns string

calculateRequestHeaders

calculateRequestHeaders(__namedParameters: object): RequestHeaders

- Defined in drone/src/modules/core/src/bitgo.ts:1246
Calculate request headers with HMAC

Parameters
- __namedParameters: object
Returns RequestHeaders

changePassword

changePassword(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1745
Change the password of the currently logged in user. Also change all v1 and v2 keychain passwords if they match the given oldPassword. Returns nothing on success.

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

clear

clear(): void

- Defined in drone/src/modules/core/src/bitgo.ts:787
Clear out all state from this BitGo object, effectively logging out the current user.

Returns void

coin

coin(coinName: string): BaseCoin

- Defined in drone/src/modules/core/src/bitgo.ts:743
Create a basecoin object

Parameters
- coinName: string
Returns BaseCoin

decrypt

decrypt(params?: DecryptOptions): string

- Defined in drone/src/modules/core/src/bitgo.ts:921
Decrypt an encrypted string locally.

Parameters
- Default value params: DecryptOptions = {}
Returns string

del

del(url: string, callback?: NodeCallback<superagent.Response>): BitGoRequest

- Defined in drone/src/modules/core/src/bitgo.ts:388
Parameters
- url: string
- Optional callback: NodeCallback<superagent.Response>
Returns BitGoRequest

encrypt

encrypt(params?: EncryptOptions): string

- Defined in drone/src/modules/core/src/bitgo.ts:895
Utility function to encrypt locally.

Parameters
- Default value params: EncryptOptions = {}
Returns string

estimateFee

estimateFee(params?: EstimateFeeOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2007
Estimates approximate fee per kb needed for a tx to get into a block

deprecated

Parameters
- Default value params: EstimateFeeOptions = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

extendToken

extendToken(params?: ExtendTokenOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1855
Extend token, provided the current token is extendable

Parameters
- Default value params: ExtendTokenOptions = {}
  - duration: duration in seconds by which to extend the token, starting at the current time
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

fetchConstants

fetchConstants(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2218
Receives a TTL and refetches as necessary

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

fromJSON

fromJSON(json: BitGoJson): void

- Defined in drone/src/modules/core/src/bitgo.ts:832
Deserialize a JSON serialized BitGo object.

Overwrites the properties on the current BitGo object with those of the deserialzed object.

Parameters
- json: BitGoJson
Returns void

generateRandomPassword

generateRandomPassword(numWords?: number): string

- Defined in drone/src/modules/core/src/bitgo.ts:939
Generate a random password

Parameters
- Default value numWords: number = 5
  
  Number of 32-bit words
Returns string

base58 random password

get

get(url: string, callback?: NodeCallback<superagent.Response>): BitGoRequest

- Defined in drone/src/modules/core/src/bitgo.ts:385
Parameters
- url: string
- Optional callback: NodeCallback<superagent.Response>
Returns BitGoRequest

getBitGoFeeAddress

getBitGoFeeAddress(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2085
Get a target address for payment of a BitGo fee

deprecated

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

getConstants

getConstants(params?: undefined | __type): any

- Defined in drone/src/modules/core/src/bitgo.ts:2258
Synchronously get constants which are relevant to the client.

Note: This function has a known race condition. It may return different values over time, especially if called shortly after creation of the BitGo object.

New code should call fetchConstants() directly instead.

deprecated

Parameters
- Optional params: undefined | __type
Returns any

The client constants object

getECDHSecret

getECDHSecret(__namedParameters: object): string

- Defined in drone/src/modules/core/src/bitgo.ts:1085
Construct an ECDH secret from a private key and other user's public key

Parameters
- __namedParameters: object
Returns string

getECDHSharingKeychain

getECDHSharingKeychain(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1102
Gets the user's private keychain, used for receiving shares

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

getEnv

getEnv(): EnvironmentName

- Defined in drone/src/modules/core/src/bitgo.ts:780
Return the current BitGo environment

Returns EnvironmentName

getSharingKey

getSharingKey(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1881
Get a key for sharing a wallet with a user

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

getUser

getUser(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1726
Get a user by ID (name/email only)

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

getValidate

getValidate(): boolean

- Defined in drone/src/modules/core/src/bitgo.ts:763
Returns boolean

getWalletAddress

getWalletAddress(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2097
Gets an address object (including the wallet id) for a given address.

deprecated

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

handleTokenIssuance

handleTokenIssuance(responseBody: TokenIssuanceResponse, password?: undefined | string): TokenIssuance

- Defined in drone/src/modules/core/src/bitgo.ts:1159
Parameters
- responseBody: TokenIssuanceResponse
  
  Response body object
- Optional password: undefined | string
  
  Password for the symmetric decryption
Returns TokenIssuance

instantGuarantee

instantGuarantee(params: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2052
Get BitGo's guarantee using an instant id

deprecated

Parameters
- params: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

keychains

keychains(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1922
Get the user's keychains object.

deprecated

Returns any

labels

labels(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1992
Get all the address labels on all of the user's wallets

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

listAccessTokens

listAccessTokens(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1546
listAccessTokens Get information on all of the BitGo access tokens on the user

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

{ id: label: user: enterprise client: scope: created: expires: origin: isExtensible: extensionAddress: <address whose private key's signature is necessary for extensions> unlock: }

listWebhookNotifications

listWebhookNotifications(params?: ListWebhookNotificationsOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2169
Fetch list of webhook notifications for the user

Parameters
- Default value params: ListWebhookNotificationsOptions = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

listWebhooks

listWebhooks(callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2110
Fetch list of user webhooks

deprecated

Parameters
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

lock

lock(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1822
Lock the session

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

logout

logout(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1710
Logout of BitGo

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

market

market(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1131
Get the latest bitcoin prices (Deprecated: Will be removed in the future) use bitgo.markets().latest()

deprecated

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

markets

markets(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1119
Get bitcoin market data

Returns any

me

me(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1793
Get the current logged in user

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

microservicesUrl

microservicesUrl(path: string): string

- Defined in drone/src/modules/core/src/bitgo.ts:1985
Create a url for calling BitGo microservice APIs

Parameters
- path: string
Returns string

newWalletObject

newWalletObject(walletParams: any): any

- Defined in drone/src/modules/core/src/bitgo.ts:1968
A factory method to create a new Wallet object, initialized with the wallet params Can be used to reconstitute a wallet from cached data

deprecated

Parameters
- walletParams: any
Returns any

patch

patch(url: string, callback?: NodeCallback<superagent.Response>): BitGoRequest

- Defined in drone/src/modules/core/src/bitgo.ts:389
Parameters
- url: string
- Optional callback: NodeCallback<superagent.Response>
Returns BitGoRequest

pendingApprovals

pendingApprovals(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1955
Get pending approvals that can be approved/ or rejected

deprecated

Returns any

ping

ping(__namedParameters?: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1897
Test connectivity to the server

Parameters
- Default value __namedParameters: object = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

post

post(url: string, callback?: NodeCallback<superagent.Response>): BitGoRequest

- Defined in drone/src/modules/core/src/bitgo.ts:386
Parameters
- url: string
- Optional callback: NodeCallback<superagent.Response>
Returns BitGoRequest

preprocessAuthenticationParams

preprocessAuthenticationParams(__namedParameters: object): ProcessedAuthenticationOptions

- Defined in drone/src/modules/core/src/bitgo.ts:1286
Process the username, password and otp into an object containing the username and hashed password, ready to send to bitgo for authentication.

Parameters
- __namedParameters: object
Returns ProcessedAuthenticationOptions

put

put(url: string, callback?: NodeCallback<superagent.Response>): BitGoRequest

- Defined in drone/src/modules/core/src/bitgo.ts:387
Parameters
- url: string
- Optional callback: NodeCallback<superagent.Response>
Returns BitGoRequest

reconstituteSecret

reconstituteSecret(__namedParameters: object): ReconstitutedSecret

- Defined in drone/src/modules/core/src/bitgo.ts:981
Reconstitute a secret which was sharded with splitSecret.

Parameters
- __namedParameters: object
Returns ReconstitutedSecret

refreshToken

refreshToken(params?: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1496
Use refresh token to get new access token. If the refresh token is null/defined, then we use the stored token from auth

Parameters
- Default value params: object = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

registerPushToken

registerPushToken(params: any, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1398
deprecated

Parameters
- params: any
  - operatingSystem: one of ios, android
  - pushToken: hex-formatted token for the respective native push notification service
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

reject

reject(msg: string, callback?: NodeCallback<never>): Bluebird<never>

- Defined in drone/src/modules/core/src/bitgo.ts:800
Helper function to return a rejected promise or call callback with error

deprecated

Parameters
- msg: string
- Optional callback: NodeCallback<never>
Returns Bluebird<never>

removeAccessToken

removeAccessToken(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1671
Sets the expire time of an access token matching either the id or label to the current date, effectively deleting it

Params: id: label:

Returns: id: label: user: enterprise client: scope: created: expires: origin: isExtensible: extensionAddress: <address whose private key's signature is ne*cessary for extensions> unlock:

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

removeWebhook

removeWebhook(params: WebhookOptions, callback: any): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2147
Remove user webhook

deprecated

Parameters
- params: WebhookOptions
- callback: any
Returns Bluebird<any>

sendOTP

sendOTP(params?: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1842
Trigger a push/sms for the OTP code

deprecated

Parameters
- Default value params: object = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

session

session(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1831
Get the current session

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

setRequestTracer

setRequestTracer(reqTracer: IRequestTracer): void

- Defined in drone/src/modules/core/src/bitgo.ts:2292
Set a request tracer to provide request IDs during multi-request workflows

Parameters
- reqTracer: IRequestTracer
Returns void

setValidate

setValidate(validate: boolean): void

- Defined in drone/src/modules/core/src/bitgo.ts:770
Parameters
- validate: boolean
Returns void

simulateWebhook

simulateWebhook(params: BitGoSimulateWebhookOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:2197
Simulate a user webhook

Parameters
- params: BitGoSimulateWebhookOptions
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

splitSecret

splitSecret(__namedParameters: object): SplitSecret

- Defined in drone/src/modules/core/src/bitgo.ts:950
Split a secret into shards using Shamir Secret Sharing.

Parameters
- __namedParameters: object
Returns SplitSecret

toJSON

toJSON(): BitGoJson

- Defined in drone/src/modules/core/src/bitgo.ts:816
Serialize this BitGo object to a JSON object.

Caution: contains sensitive data

Returns BitGoJson

token

token(tokenName: string, callback?: NodeCallback<BaseCoin>): Bluebird<BaseCoin>

- Defined in drone/src/modules/core/src/bitgo.ts:752
Create a basecoin object for a virtual token

Parameters
- tokenName: string
- Optional callback: NodeCallback<BaseCoin>
Returns Bluebird<BaseCoin>

travelRule

travelRule(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1944
Get the travel rule object

deprecated

Returns any

unlock

unlock(__namedParameters: object, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1803
Unlock the session by providing OTP

Parameters
- __namedParameters: object
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

url

url(path: string, version?: number): string

- Defined in drone/src/modules/core/src/bitgo.ts:1977
Create a url for calling BitGo platform APIs

Parameters
- path: string
- Default value version: number = 1
Returns string

user

user(): User | undefined

- Defined in drone/src/modules/core/src/bitgo.ts:847
Get the current user

Returns User | undefined

verifyAddress

verifyAddress(params?: DeprecatedVerifyAddressOptions): boolean

- Defined in drone/src/modules/core/src/bitgo.ts:855
Verify a Bitcoin address is a valid base58 address

deprecated

Parameters
- Default value params: DeprecatedVerifyAddressOptions = {}
Returns boolean

verifyPassword

verifyPassword(params?: VerifyPasswordOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:876
Parameters
- Default value params: VerifyPasswordOptions = {}
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

verifyPushToken

verifyPushToken(params: VerifyPushTokenOptions, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1423
deprecated

Parameters
- params: VerifyPushTokenOptions
  - pushVerificationToken: the token received via push notification to confirm the device's mobility
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

verifyResponse

verifyResponse(__namedParameters: object): object

- Defined in drone/src/modules/core/src/bitgo.ts:1263
Verify the HMAC for an HTTP response

Parameters
- __namedParameters: object
Returns object

verifyShards

verifyShards(__namedParameters: object): boolean

- Defined in drone/src/modules/core/src/bitgo.ts:1012
Parameters
- __namedParameters: object
Returns boolean

version

version(): string

- Defined in drone/src/modules/core/src/bitgo.ts:807
Gets the version of the BitGoJS package

Returns string

wallets

wallets(): any

- Defined in drone/src/modules/core/src/bitgo.ts:1933
Get the user's wallets object.

deprecated

Returns any

yesterday

yesterday(params?: undefined | __type, callback?: NodeCallback<any>): Bluebird<any>

- Defined in drone/src/modules/core/src/bitgo.ts:1141
Get market data from yesterday (Deprecated: Will be removed in the future) use bitgo.markets().yesterday()

Parameters
- Optional params: undefined | __type
- Optional callback: NodeCallback<any>
Returns Bluebird<any>

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Default value params: BitGoOptions = {}

Returns BitGo

Properties

env

Methods

addAccessToken

Parameters

params: AddAccessTokenOptions

Optional callback: NodeCallback<any>

Returns Bluebird<any>

addWebhook

Parameters

params: WebhookOptions

Optional callback: NodeCallback<any>

Returns Bluebird<any>

authenticate

Parameters

params: AuthenticateOptions

Optional callback: NodeCallback<any>

Returns Bluebird<any>

authenticateWithAccessToken

Parameters

__namedParameters: object

Returns void

authenticateWithAuthCode

Parameters

params: AuthenticateWithAuthCodeOptions

Optional callback: NodeCallback<any>

Returns Bluebird<any>

blockchain

Returns any

calculateHMAC

Parameters

key: string

message: string

Returns string

calculateHMACSubject

Parameters

__namedParameters: object

Returns string

calculateMinerFeeInfo

Parameters

params: any

Optional callback: NodeCallback<any>

Returns Bluebird<any>

calculateRequestHMAC

Parameters

__namedParameters: object

Returns string

calculateRequestHeaders

Parameters

__namedParameters: object

Returns RequestHeaders

changePassword

Parameters

__namedParameters: object

Optional callback: NodeCallback<any>

Returns Bluebird<any>

clear

Returns void

coin

Parameters

coinName: string

Returns BaseCoin

decrypt

Parameters

Default value params: DecryptOptions = {}

Returns string

del

Parameters

url: string

Optional callback: NodeCallback<superagent.Response>