api/entities/Identity/ChildIdentity.ChildIdentity

Represents a child identity

• Identity

  ↳ ChildIdentity

• assetPermissions
• authorizations
• did
• portfolios
• uuid

• areSecondaryAccountsFrozen
• checkRoles
• exists
• getAssetBalance
• getHeldAssets
• getHeldNfts
• getHistoricalInstructions
• getInstructions
• getInvolvedInstructions
• getMultiSigSigners
• getOffChainAuthorizationNonce
• getParentDid
• getPendingDistributions
• getPrimaryAccount
• getSecondaryAccounts
• getTrustingAssets
• getVenues
• hasRole
• hasValidCdd
• isAssetPreApproved
• isCddProvider
• isChild
• isEqual
• isGcMember
• preApprovedAssets
• toHuman
• unlinkChild
• unlinkFromParent
• generateUuid
• unserialize

• assetPermissions: AssetPermissions

Identity.assetPermissions

api/entities/Identity/index.ts:137

---

• authorizations: IdentityAuthorizations

Identity.authorizations

api/entities/Identity/index.ts:135

---

• did: string

Identity ID as stored in the blockchain

Identity.did

api/entities/Identity/index.ts:132

---

• portfolios: Portfolios

Identity.portfolios

api/entities/Identity/index.ts:136

---

• uuid: string

Identity.uuid

api/entities/Entity.ts:46

▸ areSecondaryAccountsFrozen(): Promise<boolean>

Check whether secondary Accounts are frozen

Promise<boolean>

Note

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

Identity.areSecondaryAccountsFrozen

api/entities/Identity/index.ts:700

▸ areSecondaryAccountsFrozen(callback): Promise<UnsubCallback>

Name	Type
callback	SubCallback<boolean>

Promise<UnsubCallback>

Identity.areSecondaryAccountsFrozen

api/entities/Identity/index.ts:701

---

▸ checkRoles(roles): Promise<CheckRolesResult>

Check whether this Identity possesses all specified roles

Name	Type
roles	Role[]

Promise<CheckRolesResult>

Identity.checkRoles

api/entities/Identity/index.ts:483

---

▸ exists(): Promise<boolean>

Determine whether this child Identity exists

Promise<boolean>

Note

asset Identities aren't considered to exist for this check

Identity.exists

api/entities/Identity/ChildIdentity.ts:67

---

▸ getAssetBalance(args): Promise<BigNumber>

Retrieve the balance of a particular Asset

Name	Type
args	Object
args.ticker	string

Promise<BigNumber>

Note

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

Identity.getAssetBalance

api/entities/Identity/index.ts:213

▸ getAssetBalance(args, callback): Promise<UnsubCallback>

Name	Type
args	Object
args.ticker	string
callback	SubCallback<BigNumber>

Promise<UnsubCallback>

Identity.getAssetBalance

api/entities/Identity/index.ts:214

---

▸ getHeldAssets(opts?): Promise<ResultSet<FungibleAsset>>

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

Name	Type
opts	Object
opts.order?	AssetHoldersOrderBy
opts.size?	BigNumber
opts.start?	BigNumber

Promise<ResultSet<FungibleAsset>>

Note

uses the middlewareV2

Note

supports pagination

Identity.getHeldAssets

api/entities/Identity/index.ts:380

---

▸ getHeldNfts(opts?): Promise<ResultSet<HeldNfts>>

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

Name	Type
opts	Object
opts.order?	NftHoldersOrderBy
opts.size?	BigNumber
opts.start?	BigNumber

Promise<ResultSet<HeldNfts>>

Note

uses the middlewareV2

Note

supports pagination

Identity.getHeldNfts

api/entities/Identity/index.ts:426

---

▸ getHistoricalInstructions(): Promise<HistoricInstruction[]>

Retrieve all Instructions that have been associated with this Identity's DID

Promise<HistoricInstruction[]>

Note

uses the middleware V2

Identity.getHistoricalInstructions

api/entities/Identity/index.ts:909

---

▸ getInstructions(): Promise<GroupedInstructions>

Retrieve all Instructions where this Identity is a custodian of one or more portfolios in the legs, grouped by status

Promise<GroupedInstructions>

Identity.getInstructions

api/entities/Identity/index.ts:554

---

▸ getInvolvedInstructions(): Promise<GroupedInvolvedInstructions>

Retrieve all Instructions where this Identity is a participant (owner/custodian), grouped by the role of the Identity and Instruction status

Promise<GroupedInvolvedInstructions>

Identity.getInvolvedInstructions

api/entities/Identity/index.ts:641

---

▸ getMultiSigSigners(): Promise<MultiSigSigners[]>

Returns the list of MultiSig accounts linked with this Identity along with the signatories

Promise<MultiSigSigners[]>

Note

this query can be potentially SLOW depending on the number of MultiSigs present on the chain

Identity.getMultiSigSigners

api/entities/Identity/index.ts:1063

---

▸ getOffChainAuthorizationNonce(): Promise<BigNumber>

Returns the off chain authorization nonce for this Identity

Promise<BigNumber>

Identity.getOffChainAuthorizationNonce

api/entities/Identity/index.ts:1123

---

▸ getParentDid(): Promise<null | Identity>

Returns the parent of this Identity (if any)

Promise<null | Identity>

api/entities/Identity/ChildIdentity.ts:31

---

▸ getPendingDistributions(): Promise<DistributionWithDetails[]>

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

Promise<DistributionWithDetails[]>

Note

uses the middleware

Note

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

Identity.getPendingDistributions

api/entities/Identity/index.ts:739

---

▸ getPrimaryAccount(): Promise<PermissionedAccount>

Retrieve the primary Account associated with the Identity

Promise<PermissionedAccount>

Note

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

Identity.getPrimaryAccount

api/entities/Identity/index.ts:316

▸ getPrimaryAccount(callback): Promise<UnsubCallback>

Name	Type
callback	SubCallback<PermissionedAccount>

Promise<UnsubCallback>

Identity.getPrimaryAccount

api/entities/Identity/index.ts:317

---

▸ getSecondaryAccounts(paginationOpts?): Promise<ResultSet<PermissionedAccount>>

Get the list of secondary Accounts related to the Identity

Name	Type
paginationOpts?	PaginationOptions

Promise<ResultSet<PermissionedAccount>>

Note

supports pagination

Note

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

Identity.getSecondaryAccounts

api/entities/Identity/index.ts:794

▸ getSecondaryAccounts(callback): Promise<UnsubCallback>

Name	Type
callback	SubCallback<PermissionedAccount[]>

Promise<UnsubCallback>

Identity.getSecondaryAccounts

api/entities/Identity/index.ts:798

▸ getSecondaryAccounts(paginationOpts, callback): Promise<UnsubCallback>

Name	Type
paginationOpts	PaginationOptions
callback	SubCallback<PermissionedAccount[]>

Promise<UnsubCallback>

Identity.getSecondaryAccounts

api/entities/Identity/index.ts:802

---

▸ getTrustingAssets(): Promise<FungibleAsset[]>

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

Promise<FungibleAsset[]>

Note

uses the middlewareV2

Identity.getTrustingAssets

api/entities/Identity/index.ts:507

---

▸ getVenues(): Promise<Venue[]>

Retrieve all Venues created by this Identity

Promise<Venue[]>

Identity.getVenues

api/entities/Identity/index.ts:526

---

▸ hasRole(role): Promise<boolean>

Check whether this Identity possesses the specified Role

Name	Type
role	Role

Promise<boolean>

Identity.hasRole

api/entities/Identity/index.ts:165

---

▸ hasValidCdd(): Promise<boolean>

Check whether this Identity has a valid CDD claim

Promise<boolean>

Identity.hasValidCdd

api/entities/Identity/index.ts:264

---

▸ isAssetPreApproved(asset): Promise<boolean>

Returns whether or not this Identity has pre-approved a particular asset

Name	Type
asset	string | BaseAsset

Promise<boolean>

Identity.isAssetPreApproved

api/entities/Identity/index.ts:1036

---

▸ isCddProvider(): Promise<boolean>

Check whether this Identity is a CDD provider

Promise<boolean>

Identity.isCddProvider

api/entities/Identity/index.ts:297

---

▸ isChild(): Promise<boolean>

Check whether this Identity is a child Identity

Promise<boolean>

Identity.isChild

api/entities/Identity/index.ts:989

---

▸ isEqual(entity): boolean

Determine whether this Entity is the same as another one

Name	Type
entity	Entity<unknown, unknown>

boolean

Identity.isEqual

api/entities/Entity.ts:61

---

▸ isGcMember(): Promise<boolean>

Check whether this Identity is Governance Committee member

Promise<boolean>

Identity.isGcMember

api/entities/Identity/index.ts:280

---

▸ preApprovedAssets(paginationOpts?): Promise<ResultSet<Asset>>

Returns a list of all assets this Identity has pre-approved. These assets will not require affirmation when being received in settlements

Name	Type
paginationOpts?	PaginationOptions

Promise<ResultSet<Asset>>

Identity.preApprovedAssets

api/entities/Identity/index.ts:1000

---

▸ toHuman(): string

Return the Identity's DID

string

Identity.toHuman

api/entities/Identity/index.ts:900

---

▸ unlinkChild(args, opts?): Promise<GenericPolymeshTransaction<void, void>>

Unlinks a child identity

Name	Type
args	UnlinkChildParams
opts?	ProcedureOpts

Promise<GenericPolymeshTransaction<void, void>>

Throws

if

• the child is not a child of this identity
• the transaction signer is not the primary key of the parent identity

Note

this method is of type ProcedureMethod, which means you can call unlinkChild.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it

Identity.unlinkChild

api/entities/Identity/index.ts:982

---

▸ unlinkFromParent(opts?): Promise<GenericPolymeshTransaction<void, void>>

Unlinks this child identity from its parent

Name	Type
opts?	ProcedureOpts

Promise<GenericPolymeshTransaction<void, void>>

Throws

if

• this identity doesn't have a parent
• the transaction signer is not the primary key of the child identity

Note

this method is of type NoArgsProcedureMethod, which means you can call unlinkFromParent.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it

api/entities/Identity/ChildIdentity.ts:83

---

▸ Static generateUuid<Identifiers>(identifiers): string

Generate the Entity's UUID from its identifying properties

Name
Identifiers

Name	Type
identifiers	Identifiers

string

Identity.generateUuid

api/entities/Entity.ts:14

---

▸ Static unserialize<Identifiers>(serialized): Identifiers

Unserialize a UUID into its Unique Identifiers

Name
Identifiers

Name	Type	Description
serialized	string	UUID to unserialize

Identifiers

Identity.unserialize

api/entities/Entity.ts:23