Identity

Represents an Identity in the Polymesh blockchain

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

+ new Identity(identifiers: UniqueIdentifiers, context: Context): Identity

Overrides void

Defined in src/api/entities/Identity/index.ts:111

Create an Identity entity

Parameters:

NameType

identifiers

context

Returns: Identity

Properties

authorizations

authorizations: IdentityAuthorizations

Defined in src/api/entities/Identity/index.ts:109


Protected context

context: Context

Inherited from Entity.context

Defined in src/api/entities/Entity.ts:48


did

did: string

Defined in src/api/entities/Identity/index.ts:106

identity ID as stored in the blockchain


portfolios

portfolios: Portfolios

Defined in src/api/entities/Identity/index.ts:110


tokenPermissions

tokenPermissions: TokenPermissions

Defined in src/api/entities/Identity/index.ts:111


uuid

uuid: string

Inherited from Entity.uuid

Defined in src/api/entities/Entity.ts:46

Methods

areSecondaryKeysFrozen

areSecondaryKeysFrozen(): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:681

Check whether secondary keys are frozen

note can be subscribed to

Returns: Promise‹boolean›

areSecondaryKeysFrozen(callback: SubCallback‹boolean›): Promise‹UnsubCallback

Defined in src/api/entities/Identity/index.ts:682

Parameters:

NameType

callback

SubCallback‹boolean›

Returns: Promise‹UnsubCallback


createVenue

createVenue(args: CreateVenueParams, opts?: ProcedureOpts): Promise‹TransactionQueueVenue››

Defined in src/api/entities/Identity/index.ts:225

Create a Venue

note this method is of type ProcedureMethod, which means you can call createVenue.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

Returns: Promise‹TransactionQueueVenue››


exists

exists(): Promise‹boolean›

Overrides Entity.exists

Defined in src/api/entities/Identity/index.ts:804

Determine whether this Identity exists on chain

Returns: Promise‹boolean›


freezeSecondaryKeys

freezeSecondaryKeys(args: void, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:235

Freeze all the secondary keys in this Identity. This means revoking their permission to perform any operation on the blockchain and freezing their funds until the keys are unfrozen via unfreezeSecondaryKeys

note this method is of type ProcedureMethod, which means you can call freezeSecondaryKeys.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

NameType

args

void

opts?

Returns: Promise‹TransactionQueue‹void››


getHeldTokens

getHeldTokens(opts: object): Promise‹ResultSetSecurityToken››

Defined in src/api/entities/Identity/index.ts:435

Retrieve a list of all tokens which were held at one point by this Identity

note uses the middleware

note supports pagination

Parameters:

Default value opts: object= { order: Order.Asc }

NameType

order?

Order

size?

undefined | number

start?

undefined | number

Returns: Promise‹ResultSetSecurityToken››


getInstructions

getInstructions(): Promise‹GroupedInstructions

Defined in src/api/entities/Identity/index.ts:559

Retrieve all Instructions where this Identity is a participant, grouped by status

Returns: Promise‹GroupedInstructions


getPendingDistributions

getPendingDistributions(): Promise‹DistributionWithDetails[]›

Defined in src/api/entities/Identity/index.ts:717

Retrieve every Dividend Distribution for which this Identity is eligible and hasn't been paid

note uses the middleware

note this query can be potentially SLOW depending on which Tokens this Identity has held

Returns: Promise‹DistributionWithDetails[]›


getPendingInstructions

getPendingInstructions(): Promise‹Instruction[]›

Defined in src/api/entities/Identity/index.ts:628

Retrieve all pending Instructions involving this Identity

deprecated in favor of getInstructions

Returns: Promise‹Instruction[]›


getPrimaryKey

getPrimaryKey(): Promise‹Account

Defined in src/api/entities/Identity/index.ts:400

Retrieve the primary key associated with the Identity

note can be subscribed to

Returns: Promise‹Account

getPrimaryKey(callback: SubCallbackAccount›): Promise‹UnsubCallback

Defined in src/api/entities/Identity/index.ts:401

Parameters:

NameType

callback

Returns: Promise‹UnsubCallback


getScopeId

getScopeId(args: object): Promise‹string›

Defined in src/api/entities/Identity/index.ts:541

Retrieve the Scope ID associated to this Identity's Investor Uniqueness Claim for a specific Security Token

note more on Investor Uniqueness: https://developers.polymesh.live/confidential_identity

Parameters:

args: object

NameType

token

SecurityToken | string

Returns: Promise‹string›


getSecondaryKeys

getSecondaryKeys(): Promise‹SecondaryKey[]›

Defined in src/api/entities/Identity/index.ts:769

Get the list of secondary keys related to the Identity

note can be subscribed to

Returns: Promise‹SecondaryKey[]›

getSecondaryKeys(callback: SubCallbackSecondaryKey[]›): Promise‹UnsubCallback

Defined in src/api/entities/Identity/index.ts:770

Parameters:

NameType

callback

Returns: Promise‹UnsubCallback


getTokenBalance

getTokenBalance(args: object): Promise‹BigNumber›

Defined in src/api/entities/Identity/index.ts:300

Retrieve the balance of a particular Security Token

note can be subscribed to

Parameters:

args: object

NameType

ticker

string

Returns: Promise‹BigNumber›

getTokenBalance(args: object, callback: SubCallback‹BigNumber›): Promise‹UnsubCallback

Defined in src/api/entities/Identity/index.ts:301

Parameters:

args: object

NameType

ticker

string

callback: SubCallback‹BigNumber›

Returns: Promise‹UnsubCallback


getTrustingTokens

getTrustingTokens(args: object): Promise‹SecurityToken[]›

Defined in src/api/entities/Identity/index.ts:486

Get the list of tokens for which this Identity is a trusted claim issuer

note uses the middleware

Parameters:

Default value args: object= { order: Order.Asc }

NameType

order

Order

Returns: Promise‹SecurityToken[]›


getVenues

getVenues(): Promise‹Venue[]›

Defined in src/api/entities/Identity/index.ts:507

Retrieve all Venues created by this Identity

note can be subscribed to

Returns: Promise‹Venue[]›

getVenues(callback: SubCallbackVenue[]›): Promise‹UnsubCallback

Defined in src/api/entities/Identity/index.ts:508

Parameters:

NameType

callback

Returns: Promise‹UnsubCallback


hasRole

hasRole(role: Role): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:252

Check whether this Identity possesses the specified Role

Parameters:

NameType

role

Returns: Promise‹boolean›


hasRoles

hasRoles(roles: Role[]): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:475

Check whether this Identity possesses all specified roles

Parameters:

NameType

roles

Returns: Promise‹boolean›


hasValidCdd

hasValidCdd(): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:348

Check whether this Identity has a valid CDD claim

Returns: Promise‹boolean›


inviteAccount

inviteAccount(args: InviteAccountParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:215

Send an invitation to an Account to join this Identity

note this may create AuthorizationRequest which have to be accepted by the corresponding Account. An Account or Identity can fetch its pending Authorization Requests by calling authorizations.getReceived

note this method is of type ProcedureMethod, which means you can call inviteAccount.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

Returns: Promise‹TransactionQueue‹void››


isCddProvider

isCddProvider(): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:381

Check whether this Identity is a CDD provider

Returns: Promise‹boolean›


isEqual

isEqual(entity: Entity‹unknown, unknown›): boolean

Inherited from Entity.isEqual

Defined in src/api/entities/Entity.ts:61

Determine whether this Entity is the same as another one

Parameters:

NameType

entity

Entity‹unknown, unknown›

Returns: boolean


isGcMember

isGcMember(): Promise‹boolean›

Defined in src/api/entities/Identity/index.ts:364

Check whether this Identity is Governance Committee member

Returns: Promise‹boolean›


modifyPermissions

modifyPermissions(args: ModifySignerPermissionsParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:201

Modify all permissions of a list of secondary keys associated with the Identity

note this method is of type ProcedureMethod, which means you can call modifyPermissions.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

Returns: Promise‹TransactionQueue‹void››


removeSecondaryKeys

removeSecondaryKeys(args: RemoveSecondaryKeysParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:181

Remove a list of secondary keys associated with the Identity

note this method is of type ProcedureMethod, which means you can call removeSecondaryKeys.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

Returns: Promise‹TransactionQueue‹void››


revokePermissions

revokePermissions(args: object, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:191

Revoke all permissions of a list of secondary keys associated with the Identity

note this method is of type ProcedureMethod, which means you can call revokePermissions.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

args: object

NameType

secondaryKeys

Optional opts: ProcedureOpts

Returns: Promise‹TransactionQueue‹void››


toJson

toJson(): string

Overrides Entity.toJson

Defined in src/api/entities/Identity/index.ts:817

Return the Identity's DID

Returns: string


unfreezeSecondaryKeys

unfreezeSecondaryKeys(args: void, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/Identity/index.ts:245

Unfreeze all the secondary keys in this Identity. This will restore their permissions as they were before being frozen

note this method is of type ProcedureMethod, which means you can call unfreezeSecondaryKeys.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

NameType

args

void

opts?

Returns: Promise‹TransactionQueue‹void››


Static generateUuid

generateUuidIdentifiers›(identifiers: Identifiers): string

Inherited from Entity.generateUuid

Defined in src/api/entities/Entity.ts:14

Generate the Entity's UUID from its identifying properties

Type parameters:

Identifiers

Parameters:

NameTypeDescription

identifiers

Identifiers

Returns: string


Static unserialize

unserializeIdentifiers›(serialized: string): Identifiers

Inherited from Entity.unserialize

Defined in src/api/entities/Entity.ts:23

Unserialize a UUID into its Unique Identifiers

Type parameters:

Identifiers

Parameters:

NameTypeDescription

serialized

string

UUID to unserialize

Returns: Identifiers

Last updated