Skip to main content
Version: 26.2.x

Class: Account

api/entities/Account.Account

Represents an Account in the Polymesh blockchain. Accounts can hold POLYX, control Identities and vote on proposals (among other things)

Hierarchy

Properties

address

address: string

Polymesh-specific address of the Account. Serves as an identifier

Defined in

api/entities/Account/index.ts:89


authorizations

authorizations: Authorizations<Account>

Defined in

api/entities/Account/index.ts:98


key

key: string

A hex representation of the cryptographic public key of the Account. This is consistent across Substrate chains, while the address depends on the chain as well.

Defined in

api/entities/Account/index.ts:95


subsidies

subsidies: Subsidies

Defined in

api/entities/Account/index.ts:99


uuid

uuid: string

Inherited from

Entity.uuid

Defined in

api/entities/Entity.ts:46

Methods

checkPermissions

checkPermissions(permissions): Promise<CheckPermissionsResult<Account>>

Check if this Account possesses certain Permissions to act on behalf of its corresponding Identity

Parameters

NameType
permissionsSimplePermissions

Returns

Promise<CheckPermissionsResult<Account>>

which permissions the Account is missing (if any) and the final result

Defined in

api/entities/Account/index.ts:393


exists

exists(): Promise<boolean>

Determine whether this Account exists on chain

Returns

Promise<boolean>

Overrides

Entity.exists

Defined in

api/entities/Account/index.ts:476


getBalance

getBalance(): Promise<Balance>

Get the free/locked POLYX balance of the Account

Returns

Promise<Balance>

Note

can be subscribed to, if connected to node using a web socket

Defined in

api/entities/Account/index.ts:122

getBalance(callback): Promise<UnsubCallback>

Parameters

NameType
callbackSubCallback<Balance>

Returns

Promise<UnsubCallback>

Defined in

api/entities/Account/index.ts:123


getCurrentNonce

getCurrentNonce(): Promise<BigNumber>

Retrieve the current nonce for this Account

Returns

Promise<BigNumber>

Defined in

api/entities/Account/index.ts:490


getIdentity

getIdentity(): Promise<null | Identity>

Retrieve the Identity associated to this Account (null if there is none)

Returns

Promise<null | Identity>

Defined in

api/entities/Account/index.ts:167


getMultiSig

getMultiSig(): Promise<null | MultiSig>

Fetch the MultiSig this Account is part of. If this Account is not a signer on any MultiSig, return null

Returns

Promise<null | MultiSig>

Defined in

api/entities/Account/index.ts:448


getNextAssetId

getNextAssetId(): Promise<string>

Returns next assetID that will be generated for this Identity

Returns

Promise<string>

Defined in

api/entities/Account/index.ts:635


getOffChainReceipts

getOffChainReceipts(): Promise<BigNumber[]>

Returns all off chain receipts used by this Account

Returns

Promise<BigNumber[]>

Defined in

api/entities/Account/index.ts:608


getPendingProposals

getPendingProposals(): Promise<MultiSigProposal[]>

Returns pending MultiSig proposals for this Account

Returns

Promise<MultiSigProposal[]>

Note

uses the middleware

Throws

if the Account is not a signer on any MultiSig

Defined in

api/entities/Account/index.ts:592


getPermissions

getPermissions(): Promise<Permissions>

Retrieve the Permissions this Account has as a Permissioned Account for its corresponding Identity

Returns

Promise<Permissions>

Throws

if there is no Identity associated with the Account

Defined in

api/entities/Account/index.ts:340


getPolyxTransactions

getPolyxTransactions(filters): Promise<ResultSet<HistoricPolyxTransaction>>

Returns POLYX transactions associated with this account

Parameters

NameTypeDescription
filtersObject-
filters.size?BigNumberpage size
filters.start?BigNumberpage offset

Returns

Promise<ResultSet<HistoricPolyxTransaction>>

Note

uses the middleware

Defined in

api/entities/Account/index.ts:574


getSubsidy

getSubsidy(): Promise<null | SubsidyWithAllowance>

Get the subsidized balance of this Account and the subsidizer Account. If this Account isn't being subsidized, return null

Returns

Promise<null | SubsidyWithAllowance>

Note

can be subscribed to, if connected to node using a web socket

Deprecated

in favour of subsidies.getSubsidizer

Defined in

api/entities/Account/index.ts:147

getSubsidy(callback): Promise<UnsubCallback>

Parameters

NameType
callbackSubCallback<null | SubsidyWithAllowance>

Returns

Promise<UnsubCallback>

Defined in

api/entities/Account/index.ts:148


getTransactionHistory

getTransactionHistory(filters?): Promise<ResultSet<ExtrinsicData>>

Retrieve a list of transactions signed by this Account. Can be filtered using parameters

Parameters

NameTypeDescription
filtersObject-
filters.blockHash?string-
filters.blockNumber?BigNumber-
filters.orderBy?ExtrinsicsOrderBy-
filters.size?BigNumberpage size
filters.start?BigNumberpage offset
filters.success?booleanwhether the transaction was successful or not
filters.tag?TxTagtag associated with the transaction

Returns

Promise<ResultSet<ExtrinsicData>>

Note

if both blockNumber and blockHash are passed, only blockNumber is taken into account. Also, for ordering by block_id, one should pass ExtrinsicsOrderBy.CreatedAtAsc or ExtrinsicsOrderBy.CreatedAtDesc in order of their choice (since block ID is a string field in middleware v2)

Note

uses the middleware v2

Defined in

api/entities/Account/index.ts:203


getTypeInfo

getTypeInfo(): Promise<AccountTypeInfo>

Retrieve the type of Account, and its relation to an Identity, if applicable

Returns

Promise<AccountTypeInfo>

Defined in

api/entities/Account/index.ts:511


isEqual

isEqual(entity): boolean

Determine whether this Entity is the same as another one

Parameters

NameType
entityEntity<unknown, unknown>

Returns

boolean

Inherited from

Entity.isEqual

Defined in

api/entities/Entity.ts:61


isFrozen

isFrozen(): Promise<boolean>

Check whether this Account is frozen. If frozen, it cannot perform any Identity related action until the primary Account of the Identity unfreezes all secondary Accounts

Returns

Promise<boolean>

Note

returns false if the Account isn't associated to any Identity

Defined in

api/entities/Account/index.ts:319


toHuman

toHuman(): string

Return the Account's address

Returns

string

Overrides

Entity.toHuman

Defined in

api/entities/Account/index.ts:483


generateUuid

Static generateUuid<Identifiers>(identifiers): string

Generate the Entity's UUID from its identifying properties

Type parameters

Name
Identifiers

Parameters

NameType
identifiersIdentifiers

Returns

string

Inherited from

Entity.generateUuid

Defined in

api/entities/Entity.ts:14


unserialize

Static unserialize<Identifiers>(serialized): Identifiers

Unserialize a UUID into its Unique Identifiers

Type parameters

Name
Identifiers

Parameters

NameTypeDescription
serializedstringUUID to unserialize

Returns

Identifiers

Inherited from

Entity.unserialize

Defined in

api/entities/Entity.ts:23