Skip to content

api.entities.Identity.ChildIdentity.ChildIdentity

polymath-eric edited this page Nov 27, 2023 · 28 revisions

Class: ChildIdentity

api/entities/Identity/ChildIdentity.ChildIdentity

Represents a child identity

Hierarchy

Table of contents

Properties

Methods

Properties

assetPermissions

assetPermissions: AssetPermissions

Inherited from

Identity.assetPermissions

Defined in

api/entities/Identity/index.ts:119


authorizations

authorizations: IdentityAuthorizations

Inherited from

Identity.authorizations

Defined in

api/entities/Identity/index.ts:117


did

did: string

Identity ID as stored in the blockchain

Inherited from

Identity.did

Defined in

api/entities/Identity/index.ts:114


portfolios

portfolios: Portfolios

Inherited from

Identity.portfolios

Defined in

api/entities/Identity/index.ts:118


uuid

uuid: string

Inherited from

Identity.uuid

Defined in

api/entities/Entity.ts:46

Methods

areSecondaryAccountsFrozen

areSecondaryAccountsFrozen(): Promise<boolean>

Check whether secondary Accounts are frozen

Note

can be subscribed to

Returns

Promise<boolean>

Inherited from

Identity.areSecondaryAccountsFrozen

areSecondaryAccountsFrozen(callback): Promise<UnsubCallback>

Parameters

Name Type
callback SubCallback<boolean>

Returns

Promise<UnsubCallback>

Inherited from

Identity.areSecondaryAccountsFrozen


checkRoles

checkRoles(roles): Promise<CheckRolesResult>

Check whether this Identity possesses all specified roles

Parameters

Name Type
roles Role[]

Returns

Promise<CheckRolesResult>

Inherited from

Identity.checkRoles


exists

exists(): Promise<boolean>

Determine whether this child Identity exists

Note

asset Identities aren't considered to exist for this check

Returns

Promise<boolean>

Overrides

Identity.exists


getAssetBalance

getAssetBalance(args): Promise<BigNumber>

Retrieve the balance of a particular Asset

Note

can be subscribed to

Parameters

Name Type
args Object
args.ticker string

Returns

Promise<BigNumber>

Inherited from

Identity.getAssetBalance

getAssetBalance(args, callback): Promise<UnsubCallback>

Parameters

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

Returns

Promise<UnsubCallback>

Inherited from

Identity.getAssetBalance


getHeldAssets

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

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

Note

uses the middlewareV2

Note

supports pagination

Parameters

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

Returns

Promise<ResultSet<FungibleAsset>>

Inherited from

Identity.getHeldAssets


getHeldNfts

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

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

Note

uses the middlewareV2

Note

supports pagination

Parameters

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

Returns

Promise<ResultSet<HeldNfts>>

Inherited from

Identity.getHeldNfts


getHistoricalInstructions

getHistoricalInstructions(): Promise<HistoricInstruction[]>

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

Note

uses the middleware V2

Returns

Promise<HistoricInstruction[]>

Inherited from

Identity.getHistoricalInstructions


getInstructions

getInstructions(): Promise<GroupedInstructions>

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

Returns

Promise<GroupedInstructions>

Inherited from

Identity.getInstructions


getInvolvedInstructions

getInvolvedInstructions(): Promise<GroupedInvolvedInstructions>

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

Returns

Promise<GroupedInvolvedInstructions>

Inherited from

Identity.getInvolvedInstructions


getParentDid

getParentDid(): Promise<null | Identity>

Returns the parent of this Identity (if any)

Returns

Promise<null | Identity>


getPendingDistributions

getPendingDistributions(): Promise<DistributionWithDetails[]>

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[]>

Inherited from

Identity.getPendingDistributions


getPrimaryAccount

getPrimaryAccount(): Promise<PermissionedAccount>

Retrieve the primary Account associated with the Identity

Note

can be subscribed to

Returns

Promise<PermissionedAccount>

Inherited from

Identity.getPrimaryAccount

getPrimaryAccount(callback): Promise<UnsubCallback>

Parameters

Name Type
callback SubCallback<PermissionedAccount>

Returns

Promise<UnsubCallback>

Inherited from

Identity.getPrimaryAccount


getSecondaryAccounts

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

Get the list of secondary Accounts related to the Identity

Note

supports pagination

Note

can be subscribed to

Parameters

Name Type
paginationOpts? PaginationOptions

Returns

Promise<ResultSet<PermissionedAccount>>

Inherited from

Identity.getSecondaryAccounts

getSecondaryAccounts(callback): Promise<UnsubCallback>

Parameters

Name Type
callback SubCallback<PermissionedAccount[]>

Returns

Promise<UnsubCallback>

Inherited from

Identity.getSecondaryAccounts

getSecondaryAccounts(paginationOpts, callback): Promise<UnsubCallback>

Parameters

Name Type
paginationOpts PaginationOptions
callback SubCallback<PermissionedAccount[]>

Returns

Promise<UnsubCallback>

Inherited from

Identity.getSecondaryAccounts


getTrustingAssets

getTrustingAssets(): Promise<FungibleAsset[]>

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

Note

uses the middlewareV2

Returns

Promise<FungibleAsset[]>

Inherited from

Identity.getTrustingAssets


getVenues

getVenues(): Promise<Venue[]>

Retrieve all Venues created by this Identity

Note

can be subscribed to

Returns

Promise<Venue[]>

Inherited from

Identity.getVenues


hasRole

hasRole(role): Promise<boolean>

Check whether this Identity possesses the specified Role

Parameters

Name Type
role Role

Returns

Promise<boolean>

Inherited from

Identity.hasRole


hasValidCdd

hasValidCdd(): Promise<boolean>

Check whether this Identity has a valid CDD claim

Returns

Promise<boolean>

Inherited from

Identity.hasValidCdd


isCddProvider

isCddProvider(): Promise<boolean>

Check whether this Identity is a CDD provider

Returns

Promise<boolean>

Inherited from

Identity.isCddProvider


isChild

isChild(): Promise<boolean>

Check whether this Identity is a child Identity

Returns

Promise<boolean>

Inherited from

Identity.isChild


isEqual

isEqual(entity): boolean

Determine whether this Entity is the same as another one

Parameters

Name Type
entity Entity<unknown, unknown>

Returns

boolean

Inherited from

Identity.isEqual


isGcMember

isGcMember(): Promise<boolean>

Check whether this Identity is Governance Committee member

Returns

Promise<boolean>

Inherited from

Identity.isGcMember


toHuman

toHuman(): string

Return the Identity's DID

Returns

string

Inherited from

Identity.toHuman


unlinkChild

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

Unlinks a child identity

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

Parameters

Name Type
args UnlinkChildParams
opts? ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Inherited from

Identity.unlinkChild


unlinkFromParent

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

Unlinks this child identity from its parent

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

Parameters

Name Type
opts? ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>


generateUuid

Static generateUuid<Identifiers>(identifiers): string

Generate the Entity's UUID from its identifying properties

Type parameters

Name
Identifiers

Parameters

Name Type
identifiers Identifiers

Returns

string

Inherited from

Identity.generateUuid


unserialize

Static unserialize<Identifiers>(serialized): Identifiers

Unserialize a UUID into its Unique Identifiers

Type parameters

Name
Identifiers

Parameters

Name Type Description
serialized string UUID to unserialize

Returns

Identifiers

Inherited from

Identity.unserialize

Clone this wiki locally