Identity

Represents an Identity in the Polymesh blockchain

Hierarchy

• Entity‹UniqueIdentifiers, string›

  ↳ Identity

  ↳ DefaultTrustedClaimIssuer

Index

Constructors

• constructor

Properties

• assetPermissions

• authorizations

• context

• did

• portfolios

• uuid

Methods

• areSecondaryAccountsFrozen

• checkRoles

• exists

• getAssetBalance

• getHeldAssets

• getInstructions

• getPendingDistributions

• getPendingInstructions

• getPrimaryAccount

• getScopeId

• getSecondaryAccounts

• getTrustingAssets

• getVenues

• hasRole

• hasRoles

• hasValidCdd

• isCddProvider

• isEqual

• isGcMember

• toJson

• generateUuid

• unserialize

Constructors

constructor

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

Overrides void

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

Create an Identity entity

Parameters:

Name	Type
identifiers	UniqueIdentifiers
context	Context

Returns: Identity

Properties

assetPermissions

• assetPermissions: AssetPermissions

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

---

authorizations

• authorizations: IdentityAuthorizations

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

---

Protected context

• context: Context

Inherited from CheckpointSchedule.context

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

---

did

• did: string

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

Identity ID as stored in the blockchain

---

portfolios

• portfolios: Portfolios

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

---

uuid

• uuid: string

Inherited from CheckpointSchedule.uuid

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

Methods

areSecondaryAccountsFrozen

▸ areSecondaryAccountsFrozen(): Promise‹boolean›

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

Check whether secondary Accounts are frozen

note can be subscribed to

Returns: Promise‹boolean›

▸ areSecondaryAccountsFrozen(callback: SubCallback‹boolean›): Promise‹UnsubCallback›

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

Parameters:

Name	Type
callback	SubCallback‹boolean›

Returns: Promise‹UnsubCallback›

---

checkRoles

▸ checkRoles(roles: Role[]): Promise‹CheckRolesResult›

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

Check whether this Identity possesses all specified roles

Parameters:

Name	Type
roles	Role[]

Returns: Promise‹CheckRolesResult›

---

exists

▸ exists(): Promise‹boolean›

Overrides Entity.exists

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

Determine whether this Identity exists on chain

Returns: Promise‹boolean›

---

getAssetBalance

▸ getAssetBalance(args: object): Promise‹BigNumber›

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

Retrieve the balance of a particular Asset

note can be subscribed to

Parameters:

▪ args: object

Name	Type
ticker	string

Returns: Promise‹BigNumber›

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

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

Parameters:

▪ args: object

Name	Type
ticker	string

▪ callback: SubCallback‹BigNumber›

Returns: Promise‹UnsubCallback›

---

getHeldAssets

▸ getHeldAssets(opts: object): Promise‹ResultSet‹Asset››

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

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

note uses the middleware

note supports pagination

Parameters:

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

Name	Type
order?	Order
size?	BigNumber
start?	BigNumber

Returns: Promise‹ResultSet‹Asset››

---

getInstructions

▸ getInstructions(): Promise‹GroupedInstructions›

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

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:620

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 Assets this Identity has held

Returns: Promise‹DistributionWithDetails[]›

---

getPendingInstructions

▸ getPendingInstructions(): Promise‹Instruction[]›

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

Retrieve all pending Instructions involving this Identity

deprecated in favor of getInstructions

Returns: Promise‹Instruction[]›

---

getPrimaryAccount

▸ getPrimaryAccount(): Promise‹PermissionedAccount›

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

Retrieve the primary Account associated with the Identity

note can be subscribed to

Returns: Promise‹PermissionedAccount›

▸ getPrimaryAccount(callback: SubCallback‹PermissionedAccount›): Promise‹UnsubCallback›

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

Parameters:

Name	Type
callback	SubCallback‹PermissionedAccount›

Returns: Promise‹UnsubCallback›

---

getScopeId

▸ getScopeId(args: object): Promise‹string | null›

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

Retrieve the Scope ID associated to this Identity's Investor Uniqueness Claim for a specific Asset, or null if there is none

note more on Investor Uniqueness here and here

Parameters:

▪ args: object

Name	Type
asset	Asset | string

Returns: Promise‹string | null›

---

getSecondaryAccounts

▸ getSecondaryAccounts(): Promise‹PermissionedAccount[]›

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

Get the list of secondary Accounts related to the Identity

note can be subscribed to

Returns: Promise‹PermissionedAccount[]›

▸ getSecondaryAccounts(callback: SubCallback‹PermissionedAccount[]›): Promise‹UnsubCallback›

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

Parameters:

Name	Type
callback	SubCallback‹PermissionedAccount[]›

Returns: Promise‹UnsubCallback›

---

getTrustingAssets

▸ getTrustingAssets(): Promise‹Asset[]›

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

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

note uses the middleware

Returns: Promise‹Asset[]›

---

getVenues

▸ getVenues(): Promise‹Venue[]›

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

Retrieve all Venues created by this Identity

note can be subscribed to

Returns: Promise‹Venue[]›

▸ getVenues(callback: SubCallback‹Venue[]›): Promise‹UnsubCallback›

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

Parameters:

Name	Type
callback	SubCallback‹Venue[]›

Returns: Promise‹UnsubCallback›

---

hasRole

▸ hasRole(role: Role): Promise‹boolean›

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

Check whether this Identity possesses the specified Role

Parameters:

Name	Type
role	Role

Returns: Promise‹boolean›

---

hasRoles

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

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

Check whether this Identity possesses all specified roles

deprecated in favor of checkRoles

Parameters:

Name	Type
roles	Role[]

Returns: Promise‹boolean›

---

hasValidCdd

▸ hasValidCdd(): Promise‹boolean›

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

Check whether this Identity has a valid CDD claim

Returns: Promise‹boolean›

---

isCddProvider

▸ isCddProvider(): Promise‹boolean›

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

Check whether this Identity is a CDD provider

Returns: Promise‹boolean›

---

isEqual

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

Inherited from CheckpointSchedule.isEqual

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

Determine whether this Entity is the same as another one

Parameters:

Name	Type
entity	Entity‹unknown, unknown›

Returns: boolean

---

isGcMember

▸ isGcMember(): Promise‹boolean›

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

Check whether this Identity is Governance Committee member

Returns: Promise‹boolean›

---

toJson

▸ toJson(): string

Overrides Entity.toJson

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

Return the Identity's DID

Returns: string

---

Static generateUuid

▸ generateUuid‹Identifiers›(identifiers: Identifiers): string

Inherited from CheckpointSchedule.generateUuid

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

Generate the Entity's UUID from its identifying properties

Type parameters:

▪ Identifiers

Parameters:

Name	Type	Description
identifiers	Identifiers

Returns: string

---

Static unserialize

▸ unserialize‹Identifiers›(serialized: string): Identifiers

Inherited from CheckpointSchedule.unserialize

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

Unserialize a UUID into its Unique Identifiers

Type parameters:

▪ Identifiers

Parameters:

Name	Type	Description
serialized	string	UUID to unserialize

Returns: Identifiers