Polymesh SDK API Reference
beta
beta
  • Globals
  • Classes
    • Account
    • AccountManagement
    • Asset
    • AssetHolders
    • AssetPermissions
    • Assets
    • AuthorizationRequest
    • Authorizations
    • Checkpoint
    • CheckpointSchedule
    • Checkpoints
    • Claims
    • Compliance
    • CorporateAction
    • CorporateActionBase
    • CorporateActions
    • Count
    • CustomPermissionGroup
    • DefaultPortfolio
    • DefaultTrustedClaimIssuer
    • Distributions
    • DividendDistribution
    • Documents
    • Entity
    • Identities
    • Identity
    • IdentityAuthorizations
    • Instruction
    • Issuance
    • KnownPermissionGroup
    • Network
    • NumberedPortfolio
    • Offering
    • Offerings
    • Percentage
    • PermissionGroup
    • Permissions
    • Polymesh
    • PolymeshError
    • PolymeshTransaction
    • PolymeshTransactionBase
    • PolymeshTransactionBatch
    • Portfolio
    • Portfolios
    • Requirements
    • Schedules
    • Settlements
    • Subsidy
    • TickerReservation
    • TransactionQueue
    • TransferRestrictionBase
    • TransferRestrictions
    • TrustedClaimIssuers
    • Venue
  • Enums
  • Interfaces
Powered by GitBook
On this page
  • Hierarchy
  • Index
  • Properties
  • Methods
  • Properties
  • assetHolders
  • checkpoints
  • compliance
  • Protected context
  • corporateActions
  • did
  • documents
  • issuance
  • offerings
  • permissions
  • settlements
  • ticker
  • transferRestrictions
  • uuid
  • Methods
  • controllerTransfer
  • createdAt
  • createdAtV2
  • currentFundingRound
  • details
  • exists
  • freeze
  • getIdentifiers
  • getOperationHistory
  • getOperationHistoryV2
  • investorCount
  • isEqual
  • isFrozen
  • modify
  • modifyPrimaryIssuanceAgent
  • redeem
  • removePrimaryIssuanceAgent
  • toHuman
  • transferOwnership
  • unfreeze
  • Static generateUuid
  • Static unserialize

Was this helpful?

  1. Classes

Asset

PreviousAccountManagementNextAssetHolders

Last updated 2 years ago

Was this helpful?

Class used to manage all Asset functionality

Hierarchy

  • ‹UniqueIdentifiers, string›

    ↳ Asset

Index

Properties

Methods

Properties

assetHolders


checkpoints


compliance

• compliance: Compliance


Protected context

• context: Context


corporateActions


did

• did: string

Identity ID of the Asset (used for Claims)


documents


issuance


offerings


permissions

• permissions: Permissions


settlements


ticker

• ticker: string

ticker of the Asset


transferRestrictions


uuid

• uuid: string

Methods

controllerTransfer

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

Parameters:

Name
Type

args

opts?


createdAt

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


createdAtV2

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

note uses the middlewareV2

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


currentFundingRound

▸ currentFundingRound(): Promise‹string | null›

Retrieve the Asset's funding round

note can be subscribed to

Returns: Promise‹string | null›

Parameters:

Name
Type

callback


details

Retrieve the Asset's data

note can be subscribed to

Parameters:

Name
Type

callback


exists

▸ exists(): Promise‹boolean›

Determine whether this Asset exists on chain

Returns: Promise‹boolean›


freeze

Freeze transfers of the Asset

Parameters:

Name
Type

opts?


getIdentifiers

Retrieve the Asset's identifiers list

note can be subscribed to

Parameters:

Name
Type

callback?


getOperationHistory

Retrieve this Asset's Operation History

note Operations are grouped by the agent Identity who performed them

note uses the middleware


getOperationHistoryV2

Retrieve this Asset's Operation History

note Operations are grouped by the agent Identity who performed them

note uses the middlewareV2


investorCount

▸ investorCount(): Promise‹BigNumber›

Retrieve the amount of unique investors that hold this Asset

note this takes into account the Scope ID of Investor Uniqueness Claims. If an investor holds balances of this Asset 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

Returns: Promise‹BigNumber›


isEqual

Determine whether this Entity is the same as another one

Parameters:

Name
Type

entity

Returns: boolean


isFrozen

▸ isFrozen(): Promise‹boolean›

Check whether transfers are frozen for the Asset

note can be subscribed to

Returns: Promise‹boolean›

Parameters:

Name
Type

callback


modify

Modify some properties of the Asset

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

Parameters:

Name
Type

args

opts?


modifyPrimaryIssuanceAgent

Assign a new primary issuance agent for the Asset

deprecated in favor of inviteAgent

Parameters:

Name
Type

args

opts?


redeem

Redeem (burn) an amount of this Asset's tokens

note tokens are removed from the caller's Default Portfolio

Parameters:

Name
Type

args

opts?


removePrimaryIssuanceAgent

Remove the primary issuance agent of the Asset

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

deprecated

Parameters:

Name
Type

opts?


toHuman

â–¸ toHuman(): string

Return the Asset's ticker

Returns: string


transferOwnership

Transfer ownership of the Asset to another Identity. This generates an authorization request that must be accepted by the recipient

Parameters:

Name
Type

args

opts?


unfreeze

Unfreeze transfers of the Asset

Parameters:

Name
Type

opts?


Static generateUuid

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

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

Unserialize a UUID into its Unique Identifiers

Type parameters:

â–ª Identifiers

Parameters:

Name
Type
Description

serialized

string

UUID to unserialize

Returns: Identifiers

• assetHolders:

Defined in

• checkpoints:

Defined in

Defined in

Inherited from .

Defined in

• corporateActions:

Defined in

Defined in

• documents:

Defined in

• issuance:

Defined in

• offerings:

Defined in

Defined in

• settlements:

Defined in

Defined in

• transferRestrictions:

Defined in

Inherited from .

Defined in

▸ controllerTransfer(args: , opts?: ): Promise‹‹void››

Defined in

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

Returns: Promise‹‹void››

▸ createdAt(): Promise‹ | null›

Defined in

Returns: Promise‹ | null›

▸ createdAtV2(): Promise‹ | null›

Defined in

Returns: Promise‹ | null›

Defined in

▸ currentFundingRound(callback: ‹string | null›): Promise‹›

Defined in

‹string | null›

Returns: Promise‹›

▸ details(): Promise‹›

Defined in

Returns: Promise‹›

▸ details(callback: ‹›): Promise‹›

Defined in

‹›

Returns: Promise‹›

Overrides .

Defined in

▸ freeze(opts?: ): Promise‹‹››

Defined in

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

Returns: Promise‹‹››

▸ getIdentifiers(): Promise‹[]›

Defined in

Returns: Promise‹[]›

▸ getIdentifiers(callback?: ‹[]›): Promise‹›

Defined in

‹[]›

Returns: Promise‹›

▸ getOperationHistory(): Promise‹[]›

Defined in

Returns: Promise‹[]›

▸ getOperationHistoryV2(): Promise‹[]›

Defined in

Returns: Promise‹[]›

Defined in

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

Inherited from .

Defined in

‹unknown, unknown›

Defined in

▸ isFrozen(callback: ‹boolean›): Promise‹›

Defined in

‹boolean›

Returns: Promise‹›

▸ modify(args: , opts?: ): Promise‹‹››

Defined in

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

Returns: Promise‹‹››

▸ modifyPrimaryIssuanceAgent(args: , opts?: ): Promise‹‹void››

Defined in

note this will create an which has to be accepted by the target Identity. An or can fetch its pending Authorization Requests by calling . Also, an Account or Identity can directly fetch the details of an Authorization Request by calling

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

Returns: Promise‹‹void››

▸ redeem(args: , opts?: ): Promise‹‹void››

Defined in

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

Returns: Promise‹‹void››

▸ removePrimaryIssuanceAgent(opts?: ): Promise‹‹void››

Defined in

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

Returns: Promise‹‹void››

Overrides .

Defined in

▸ transferOwnership(args: , opts?: ): Promise‹‹››

Defined in

note this will create which has to be accepted by the target Identity. An or can fetch its pending Authorization Requests by calling . Also, an Account or Identity can directly fetch the details of an Authorization Request by calling

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

Returns: Promise‹‹››

▸ unfreeze(opts?: ): Promise‹‹››

Defined in

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

Returns: Promise‹‹››

Inherited from .

Defined in

Inherited from .

Defined in

AssetHolders
src/api/entities/Asset/index.ts:117
Checkpoints
src/api/entities/Asset/index.ts:122
src/api/entities/Asset/index.ts:119
src/api/entities/Entity.ts:48
CorporateActions
src/api/entities/Asset/index.ts:123
src/api/entities/Asset/index.ts:107
Documents
src/api/entities/Asset/index.ts:115
Issuance
src/api/entities/Asset/index.ts:118
Offerings
src/api/entities/Asset/index.ts:121
src/api/entities/Asset/index.ts:124
Settlements
src/api/entities/Asset/index.ts:116
src/api/entities/Asset/index.ts:112
TransferRestrictions
src/api/entities/Asset/index.ts:120
src/api/entities/Entity.ts:46
ControllerTransferParams
ProcedureOpts
TransactionQueue
src/api/entities/Asset/index.ts:597
ProcedureMethod
controllerTransfer.checkAuthorization
TransactionQueue
EventIdentifier
src/api/entities/Asset/index.ts:395
EventIdentifier
EventIdentifier
src/api/entities/Asset/index.ts:417
EventIdentifier
src/api/entities/Asset/index.ts:320
src/api/entities/Asset/index.ts:321
AssetDetails
src/api/entities/Asset/index.ts:219
AssetDetails
src/api/entities/Asset/index.ts:220
src/api/entities/Asset/index.ts:720
ProcedureOpts
TransactionQueue
Asset
src/api/entities/Asset/index.ts:444
NoArgsProcedureMethod
freeze.checkAuthorization
TransactionQueue
Asset
SecurityIdentifier
src/api/entities/Asset/index.ts:358
SecurityIdentifier
src/api/entities/Asset/index.ts:359
HistoricAgentOperation
src/api/entities/Asset/index.ts:608
HistoricAgentOperation
HistoricAgentOperation
src/api/entities/Asset/index.ts:693
HistoricAgentOperation
src/api/entities/Asset/index.ts:541
Entity
src/api/entities/Entity.ts:61
src/api/entities/Asset/index.ts:463
src/api/entities/Asset/index.ts:464
src/api/entities/Asset/index.ts:210
ProcedureMethod
modify.checkAuthorization
TransactionQueue
Asset
ModifyPrimaryIssuanceAgentParams
ProcedureOpts
TransactionQueue
src/api/entities/Asset/index.ts:504
ProcedureMethod
modifyPrimaryIssuanceAgent.checkAuthorization
TransactionQueue
RedeemTokensParams
ProcedureOpts
TransactionQueue
src/api/entities/Asset/index.ts:530
ProcedureMethod
redeem.checkAuthorization
TransactionQueue
ProcedureOpts
TransactionQueue
src/api/entities/Asset/index.ts:518
NoArgsProcedureMethod
removePrimaryIssuanceAgent.checkAuthorization
TransactionQueue
src/api/entities/Asset/index.ts:733
TransferAssetOwnershipParams
ProcedureOpts
TransactionQueue
AuthorizationRequest
src/api/entities/Asset/index.ts:199
ProcedureMethod
transferOwnership.checkAuthorization
TransactionQueue
AuthorizationRequest
ProcedureOpts
TransactionQueue
Asset
src/api/entities/Asset/index.ts:454
NoArgsProcedureMethod
unfreeze.checkAuthorization
TransactionQueue
Asset
src/api/entities/Entity.ts:14
src/api/entities/Entity.ts:23
Entity
assetHolders
checkpoints
compliance
context
corporateActions
did
documents
issuance
offerings
permissions
settlements
ticker
transferRestrictions
uuid
controllerTransfer
createdAt
createdAtV2
currentFundingRound
details
exists
freeze
getIdentifiers
getOperationHistory
getOperationHistoryV2
investorCount
isEqual
isFrozen
modify
modifyPrimaryIssuanceAgent
redeem
removePrimaryIssuanceAgent
toHuman
transferOwnership
unfreeze
generateUuid
unserialize
ControllerTransferParams
ProcedureOpts
ProcedureOpts
Entity
ProcedureOpts
ModifyPrimaryIssuanceAgentParams
ProcedureOpts
RedeemTokensParams
ProcedureOpts
ProcedureOpts
TransferAssetOwnershipParams
ProcedureOpts
ProcedureOpts
CheckpointSchedule
CheckpointSchedule
AssetDetails
Entity
SecurityIdentifier
CheckpointSchedule
ProcedureOpts
TransactionQueue
Asset
Authorization Request
Account
Identity
Entity
Authorization Request
Account
Identity
CheckpointSchedule
CheckpointSchedule
AssetDetails
SecurityIdentifier
authorizations.getReceived
authorizations.getOne
authorizations.getReceived
authorizations.getOne
context
uuid
isEqual
generateUuid
unserialize
exists
toHuman
SubCallback
UnsubCallback
UnsubCallback
SubCallback
UnsubCallback
UnsubCallback
SubCallback
UnsubCallback
UnsubCallback
SubCallback
UnsubCallback
UnsubCallback
ModifyAssetParams
SubCallback
SubCallback
SubCallback
SubCallback
ModifyAssetParams