SecurityToken

Class used to manage all the Security Token functionality

Hierarchy

  • Entity‹UniqueIdentifiers›

    ↳ SecurityToken

Index

Properties

Methods

Properties

checkpoints

• checkpoints: Checkpoints

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

compliance

• compliance: Compliance

Defined in src/api/entities/SecurityToken/index.ts:90

Protected context

• context: Context

Inherited from CheckpointSchedule.context

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

controllerTransfer

• controllerTransfer: ProcedureMethod‹ControllerTransferParams, void›

Defined in src/api/entities/SecurityToken/index.ts:460

Force a transfer from a given Portfolio to the PIA’s default Portfolio

param portfolio (or portfolio ID) from which tokens will be transferred

param amount of tokens to transfer

note required role:

  • Security Token Primary Issuance Agent

corporateActions

• corporateActions: CorporateActions

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

did

• did: string

Defined in src/api/entities/SecurityToken/index.ts:78

identity id of the Security Token

documents

• documents: Documents

Defined in src/api/entities/SecurityToken/index.ts:86

freeze

• freeze: ProcedureMethod‹void, SecurityToken›

Defined in src/api/entities/SecurityToken/index.ts:332

Freezes transfers and minting of the Security Token

note required role:

  • Security Token Owner

issuance

• issuance: Issuance

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

modify

Defined in src/api/entities/SecurityToken/index.ts:175

Modify some properties of the Security Token

param makes an indivisible token divisible

throws if the passed values result in no changes being made to the token

note required role:

  • Security Token Owner

modifyPrimaryIssuanceAgent

• modifyPrimaryIssuanceAgent: ProcedureMethod‹ModifyPrimaryIssuanceAgentParams, void›

Defined in src/api/entities/SecurityToken/index.ts:388

Assign a new primary issuance agent for the Security Token

param identity to be set as primary issuance agent

param date at which the authorization request to modify the primary issuance agent expires (optional, never expires if a date is not provided)

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 required role:

  • Security Token Owner

offerings

• offerings: Offerings

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

redeem

• redeem: ProcedureMethod‹RedeemTokenParams, void›

Defined in src/api/entities/SecurityToken/index.ts:410

Redeem (burn) an amount of this Security Token

note Tokens are removed from the Primary Issuance Agent's Default Portfolio. If the Security Token has no Primary Issuance Agent, funds are removed from the owner's Default Portfolio instead

note required role:

  • Security Token Primary Issuance Agent

removePrimaryIssuanceAgent

• removePrimaryIssuanceAgent: ProcedureMethod‹void, void›

Defined in src/api/entities/SecurityToken/index.ts:398

Remove the primary issuance agent of the Security Token

note if primary issuance agent is not set, Security Token owner would be used by default

note required role:

  • Security Token Owner

settlements

• settlements: Settlements

Defined in src/api/entities/SecurityToken/index.ts:87

ticker

• ticker: string

Defined in src/api/entities/SecurityToken/index.ts:83

ticker of the Security Token

tokenHolders

• tokenHolders: TokenHolders

Defined in src/api/entities/SecurityToken/index.ts:88

transferOwnership

• transferOwnership: ProcedureMethod‹TransferTokenOwnershipParams, SecurityToken›

Defined in src/api/entities/SecurityToken/index.ts:164

Transfer ownership of the Security Token to another Identity. This generates an authorization request that must be accepted by the destinatary

param date at which the authorization request for transfer expires (optional)

note required role:

  • Security Token Owner

transferRestrictions

• transferRestrictions: TransferRestrictions

Defined in src/api/entities/SecurityToken/index.ts:91

unfreeze

• unfreeze: ProcedureMethod‹void, SecurityToken›

Defined in src/api/entities/SecurityToken/index.ts:340

Unfreeze transfers and minting of the Security Token

note required role:

  • Security Token Owner

uuid

• uuid: string

Inherited from CheckpointSchedule.uuid

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

Methods

createdAt

▸ createdAt(): Promise‹EventIdentifier | null›

Defined in src/api/entities/SecurityToken/index.ts:310

Retrieve the identifier data (block number, date and event index) of the event that was emitted when the token was created

note uses the middleware

note there is a possibility that the data is not ready by the time it is requested. In that case, null is returned

Returns: Promise‹EventIdentifier | null›

currentFundingRound

▸ currentFundingRound(): Promise‹string›

Defined in src/api/entities/SecurityToken/index.ts:240

Retrieve the Security Token's funding round

note can be subscribed to

Returns: Promise‹string›

Defined in src/api/entities/SecurityToken/index.ts:241

Parameters:

Name

Type

callback

details

▸ details(): Promise‹SecurityTokenDetails›

Defined in src/api/entities/SecurityToken/index.ts:182

Retrieve the Security Token's name, total supply, whether it is divisible or not and the Identity of the owner

note can be subscribed to

Returns: Promise‹SecurityTokenDetails›

Defined in src/api/entities/SecurityToken/index.ts:183

Parameters:

Name

Type

callback

getIdentifiers

▸ getIdentifiers(): Promise‹TokenIdentifier[]›

Defined in src/api/entities/SecurityToken/index.ts:274

Retrieve the Security Token's asset identifiers list

note can be subscribed to

Returns: Promise‹TokenIdentifier[]›

Defined in src/api/entities/SecurityToken/index.ts:275

Parameters:

Name

Type

callback?

investorCount

▸ investorCount(): Promise‹number›

Defined in src/api/entities/SecurityToken/index.ts:421

Retrieve the amount of unique investors that hold this Security Token

note this takes into account the Scope ID of Investor Uniqueness Claims. If an investor holds balances of this token in two or more different Identities, but they all have Investor Uniqueness Claims with the same Scope ID, then they will only be counted once for the purposes of this result

note can be subscribed to

Returns: Promise‹number›

Defined in src/api/entities/SecurityToken/index.ts:422

Parameters:

Name

Type

callback

isEqual

▸ isEqual(entity: Entity‹object›): boolean

Inherited from CheckpointSchedule.isEqual

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

Whether this Entity is the same as another one

Parameters:

Name

Type

entity

Entity‹object›

Returns: boolean

isFrozen

▸ isFrozen(): Promise‹boolean›

Defined in src/api/entities/SecurityToken/index.ts:347

Check whether transfers are frozen for the Security Token

note can be subscribed to

Returns: Promise‹boolean›

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

Parameters:

Name

Type

callback

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

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

Parameters:

Name

Type

Description

serialized

string

UUID to unserialize

Returns: Identifiers

Last updated

Was this helpful?