Context

Context in which the SDK is being used

• Holds the current low level API

• Holds the current keyring pair

• Holds the current Identity

Hierarchy

• Context

Index

Properties

• currentPair

• isArchiveNode

• polymeshApi

Accessors

• middlewareApi

Methods

• accountBalance

• getAccounts

• getCurrentAccount

• getCurrentIdentity

• getCurrentPair

• getInvalidDids

• getLatestBlock

• getSecondaryKeys

• getSigner

• getTransactionArguments

• getTransactionFees

• isMiddlewareAvailable

• isMiddlewareEnabled

• issuedClaims

• queryMiddleware

• setPair

• create

Properties

Optional currentPair

• currentPair? : KeyringPair

Defined in src/base/Context.ts:83

isArchiveNode

• isArchiveNode: boolean = false

Defined in src/base/Context.ts:88

Whether the current node is an archive node (contains a full history from genesis onward) or not

polymeshApi

• polymeshApi: ApiPromise

Defined in src/base/Context.ts:81

Accessors

middlewareApi

• get middlewareApi(): ApolloClient‹NormalizedCacheObject›

Defined in src/base/Context.ts:777

Retrieve the middleware client

throws if the middleware is not enabled

Returns: ApolloClient‹NormalizedCacheObject›

Methods

accountBalance

▸ accountBalance(account?: string | Account): Promise‹AccountBalance›

Defined in src/base/Context.ts:226

Retrieve the account level POLYX balance

note can be subscribed to

Parameters:

Name	Type
account?	string | Account

Returns: Promise‹AccountBalance›

▸ accountBalance(account: string | Account | undefined, callback: SubCallback‹AccountBalance›): Promise‹UnsubCallback›

Defined in src/base/Context.ts:227

Retrieve the account level POLYX balance

note can be subscribed to

Parameters:

Name	Type
account	string | Account | undefined
callback	SubCallback‹AccountBalance›

Returns: Promise‹UnsubCallback›

getAccounts

▸ getAccounts(): Array‹AccountData›

Defined in src/base/Context.ts:199

Retrieve a list of addresses associated with the account

Returns: Array‹AccountData›

getCurrentAccount

▸ getCurrentAccount(): CurrentAccount

Defined in src/base/Context.ts:285

Retrieve current Account

throws if there is no current account associated to the SDK instance

Returns: CurrentAccount

getCurrentIdentity

▸ getCurrentIdentity(): Promise‹CurrentIdentity›

Defined in src/base/Context.ts:305

Retrieve current Identity

throws if there is no Identity associated to the current Account (or there is no current Account associated to the SDK instance)

Returns: Promise‹CurrentIdentity›

getCurrentPair

▸ getCurrentPair(): KeyringPair

Defined in src/base/Context.ts:325

Retrieve current Keyring Pair

throws if there is no Account associated to the SDK instance

Returns: KeyringPair

getInvalidDids

▸ getInvalidDids(identities: (string | Identity‹›)[]): Promise‹string[]›

Defined in src/base/Context.ts:353

Check whether Identities exist

Parameters:

Name	Type
identities	(string | Identity‹›)[]

Returns: Promise‹string[]›

getLatestBlock

▸ getLatestBlock(): Promise‹BigNumber›

Defined in src/base/Context.ts:835

Retrieve the latest block number

Returns: Promise‹BigNumber›

getSecondaryKeys

▸ getSecondaryKeys(): Promise‹SecondaryKey[]›

Defined in src/base/Context.ts:551

Retrieve the list of secondary keys related to the Account

note can be subscribed to

Returns: Promise‹SecondaryKey[]›

▸ getSecondaryKeys(callback: SubCallback‹SecondaryKey[]›): Promise‹UnsubCallback›

Defined in src/base/Context.ts:552

Parameters:

Name	Type
callback	SubCallback‹SecondaryKey[]›

Returns: Promise‹UnsubCallback›

getSigner

▸ getSigner(): AddressOrPair

Defined in src/base/Context.ts:340

Retrieve the signer address (or keyring pair)

Returns: AddressOrPair

getTransactionArguments

▸ getTransactionArguments(args: object): TransactionArgument[]

Defined in src/base/Context.ts:403

Retrieve the types of arguments that a certain transaction requires to be run

Parameters:

▪ args: object

Name	Type	Description
tag	TxTag	tag associated with the transaction that will be executed if the proposal passes

Returns: TransactionArgument[]

getTransactionFees

▸ getTransactionFees(tag: TxTag): Promise‹BigNumber›

Defined in src/base/Context.ts:376

Retrieve the protocol fees associated with running a specific transaction

Parameters:

Name	Type	Description
tag	TxTag	transaction tag (i.e. TxTags.asset.CreateAsset or "asset.createAsset")

Returns: Promise‹BigNumber›

isMiddlewareAvailable

▸ isMiddlewareAvailable(): Promise‹boolean›

Defined in src/base/Context.ts:822

Return whether the middleware is enabled and online

Returns: Promise‹boolean›

isMiddlewareEnabled

▸ isMiddlewareEnabled(): boolean

Defined in src/base/Context.ts:815

Return whether the middleware was enabled at startup

Returns: boolean

issuedClaims

▸ issuedClaims(opts: object): Promise‹ResultSet‹ClaimData››

Defined in src/base/Context.ts:726

Retrieve a list of claims. Can be filtered using parameters

note uses the middleware (optional)

Parameters:

▪Default value opts: object= {}

Name	Type	Description
claimTypes?	ClaimType[]	types of the claims to fetch. Defaults to any type
includeExpired?	undefined | false | true	whether to include expired claims. Defaults to true
size?	undefined | number	page size
start?	undefined | number	page offset
targets?	(string | Identity‹›)[]	identities (or Identity IDs) for which to fetch claims (targets). Defaults to all targets
trustedClaimIssuers?	(string | Identity‹›)[]	identity IDs of claim issuers. Defaults to all claim issuers

Returns: Promise‹ResultSet‹ClaimData››

queryMiddleware

▸ queryMiddleware‹Result›(query: GraphqlQuery‹unknown›): Promise‹ApolloQueryResult‹Result››

Defined in src/base/Context.ts:793

Make a query to the middleware server using the apollo client

Type parameters:

▪ Result: Partial‹Query›

Parameters:

Name	Type
query	GraphqlQuery‹unknown›

Returns: Promise‹ApolloQueryResult‹Result››

setPair

▸ setPair(address: string): Promise‹void›

Defined in src/base/Context.ts:209

Set a pair as the current account keyring pair

Parameters:

Name	Type
address	string

Returns: Promise‹void›

Static create

▸ create(params: object): Promise‹Context›

Defined in src/base/Context.ts:122

Create the Context instance

Parameters:

▪ params: object

Name	Type
accountMnemonic?	undefined | string
accountSeed?	undefined | string
accountUri?	undefined | string
keyring?	CommonKeyring | UiKeyring
middlewareApi	ApolloClient‹NormalizedCacheObject› | null
polymeshApi	ApiPromise

Returns: Promise‹Context›