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
  • asset
  • Protected context
  • currency
  • declarationDate
  • defaultTaxWithholding
  • description
  • expiryDate
  • id
  • Protected kind
  • maxAmount
  • origin
  • paymentDate
  • perShare
  • targets
  • taxWithholdings
  • uuid
  • Methods
  • checkpoint
  • claim
  • details
  • exists
  • getParticipant
  • getParticipants
  • getPaymentHistory
  • getPaymentHistoryV2
  • getWithheldTax
  • getWithheldTaxV2
  • isEqual
  • linkDocuments
  • modifyCheckpoint
  • pay
  • reclaimFunds
  • toHuman
  • Static generateUuid
  • Static unserialize

Was this helpful?

  1. Classes

DividendDistribution

PreviousDistributionsNextDocuments

Last updated 2 years ago

Was this helpful?

Represents a Corporate Action via which an Asset issuer wishes to distribute dividends between a subset of the Asset Holders (targets)

Hierarchy

↳

↳ DividendDistribution

Index

Properties

Methods

Properties

asset

Asset affected by this Corporate Action


Protected context

• context: Context


currency

• currency: string

ticker of the currency in which dividends are being distributed


declarationDate

• declarationDate: Date

date at which the Corporate Action was created


defaultTaxWithholding

• defaultTaxWithholding: BigNumber

default percentage (0-100) of tax withholding for this Corporate Action


description

• description: string

brief text description of the Corporate Action


expiryDate

• expiryDate: null | Date

date after which dividends can no longer be paid/reclaimed. A null value means the distribution never expires


id

• id: BigNumber

internal Corporate Action ID


Protected kind

type of dividend distribution being represented. The chain enforces it to be either PredictableBenefit or UnpredictableBenefit


maxAmount

• maxAmount: BigNumber

maximum amount of currency to be distributed. Distributions are "first come, first served", so funds can be depleted before every Asset Holder receives their corresponding amount


origin

Portfolio from which the dividends will be distributed


paymentDate

• paymentDate: Date

date starting from which dividends can be paid/reclaimed


perShare

• perShare: BigNumber

amount of currency to pay for each share held by the Asset Holders


targets

Asset Holder Identities related to this Corporate action. If the treatment is Exclude, the Identities in the array will not be targeted by the Action, Identities not in the array will be targeted, and vice versa


taxWithholdings

percentage (0-100) of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage


uuid

• uuid: string

Methods

checkpoint

Retrieve the Checkpoint associated with this Dividend Distribution. If the Checkpoint is scheduled and has not been created yet, the corresponding CheckpointSchedule is returned instead


claim

Claim the Dividends corresponding to the signing Identity

note if currency is indivisible, the Identity's share will be rounded down to the nearest integer (after taxes are withheld)

Parameters:

Name
Type

opts?


details

Retrieve details associated with this Dividend Distribution


exists

▸ exists(): Promise‹boolean›

Retrieve whether the Distribution exists

Returns: Promise‹boolean›


getParticipant

Retrieve an Identity that is entitled to dividends in this Distribution (participant), the amount it is entitled to and whether it has been paid or not

note if the Distribution Checkpoint hasn't been created yet, the result will be null. This is because the Distribution participant's corresponding payment cannot be determined without a Checkpoint

Parameters:

Name
Type

args?

undefined | object


getParticipants

Retrieve a comprehensive list of all Identities that are entitled to dividends in this Distribution (participants), the amount they are entitled to and whether they have been paid or not

note this request can take a lot of time with large amounts of Asset Holders

note if the Distribution Checkpoint hasn't been created yet, the result will be an empty array. This is because the Distribution participants cannot be determined without a Checkpoint


getPaymentHistory

Retrieve the payment history for this Distribution

note uses the middleware

note supports pagination

Parameters:

â–ªDefault value opts: object= {}

Name
Type

size?

BigNumber

start?

BigNumber


getPaymentHistoryV2

Retrieve the payment history for this Distribution

note uses the middleware V2

note supports pagination

Parameters:

â–ªDefault value opts: object= {}

Name
Type

size?

BigNumber

start?

BigNumber


getWithheldTax

▸ getWithheldTax(): Promise‹BigNumber›

Retrieve the amount of taxes that have been withheld up to this point in this Distribution

note uses the middleware

Returns: Promise‹BigNumber›


getWithheldTaxV2

▸ getWithheldTaxV2(): Promise‹BigNumber›

Retrieve the amount of taxes that have been withheld up to this point in this Distribution

note uses the middlewareV2

Returns: Promise‹BigNumber›


isEqual

Determine whether this Entity is the same as another one

Parameters:

Name
Type

entity

Returns: boolean


linkDocuments

Link a list of documents to this corporate action

note any previous links are removed in favor of the new list

Parameters:

Name
Type

args

opts?


modifyCheckpoint

Modify the Distribution's Checkpoint

Parameters:

Name
Type

args

opts?


pay

Transfer the corresponding share of the dividends to a list of Identities

note due to performance issues, we do not validate that the distribution has enough remaining funds to pay the corresponding amount to the supplied Identities

note if currency is indivisible, the Identity's share will be rounded down to the nearest integer (after taxes are withheld)

Parameters:

Name
Type

args

opts?


reclaimFunds

Reclaim any remaining funds back to the origin Portfolio. This can only be done after the Distribution has expired

note withheld taxes are also reclaimed in the same transaction

note required roles:

  • Origin Portfolio Custodian

Parameters:

Name
Type

opts?


toHuman

Return the Dividend Distribution's static data


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

• asset:

Inherited from .

Defined in

Inherited from .

Defined in

Defined in

Inherited from .

Defined in

Inherited from .

Defined in

Inherited from .

Defined in

Defined in

Inherited from .

Defined in

• kind: |

Overrides .

Defined in

Defined in

• origin: |

Defined in

Defined in

Defined in

• targets:

Inherited from .

Defined in

• taxWithholdings: []

Inherited from .

Defined in

Inherited from .

Defined in

▸ checkpoint(): Promise‹ | ›

Overrides .

Defined in

Returns: Promise‹ | ›

▸ claim(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››

▸ details(): Promise‹›

Defined in

Returns: Promise‹›

Overrides .

Defined in

▸ getParticipant(args?: undefined | object): Promise‹ | null›

Defined in

Returns: Promise‹ | null›

▸ getParticipants(): Promise‹[]›

Defined in

Returns: Promise‹[]›

▸ getPaymentHistory(opts: object): Promise‹‹››

Defined in

Returns: Promise‹‹››

▸ getPaymentHistoryV2(opts: object): Promise‹‹››

Defined in

Returns: Promise‹‹››

Defined in

Defined in

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

Inherited from .

Defined in

‹unknown, unknown›

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

Inherited from .

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››

▸ modifyCheckpoint(args: ‹ModifyCaCheckpointParams, object›, opts?: ): Promise‹‹void››

Overrides .

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

‹ModifyCaCheckpointParams, object›

Returns: Promise‹‹void››

▸ pay(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››

▸ reclaimFunds(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››

â–¸ toHuman():

Overrides .

Defined in

Returns:

Inherited from .

Defined in

Inherited from .

Defined in

Asset
src/api/entities/CorporateActionBase/index.ts:77
src/api/entities/Entity.ts:48
src/api/entities/DividendDistribution/index.ts:109
src/api/entities/CorporateActionBase/index.ts:82
src/api/entities/CorporateActionBase/index.ts:98
src/api/entities/CorporateActionBase/index.ts:87
src/api/entities/DividendDistribution/index.ts:125
src/api/entities/CorporateActionBase/index.ts:72
UnpredictableBenefit
PredictableBenefit
src/api/entities/DividendDistribution/index.ts:135
src/api/entities/DividendDistribution/index.ts:120
DefaultPortfolio
NumberedPortfolio
src/api/entities/DividendDistribution/index.ts:104
src/api/entities/DividendDistribution/index.ts:130
src/api/entities/DividendDistribution/index.ts:114
CorporateActionTargets
src/api/entities/CorporateActionBase/index.ts:93
TaxWithholding
src/api/entities/CorporateActionBase/index.ts:104
src/api/entities/Entity.ts:46
Checkpoint
CheckpointSchedule
src/api/entities/DividendDistribution/index.ts:255
Checkpoint
CheckpointSchedule
ProcedureOpts
TransactionQueue
src/api/entities/DividendDistribution/index.ts:204
NoArgsProcedureMethod
claim.checkAuthorization
TransactionQueue
DividendDistributionDetails
src/api/entities/DividendDistribution/index.ts:283
DividendDistributionDetails
src/api/entities/DividendDistribution/index.ts:274
DistributionParticipant
src/api/entities/DividendDistribution/index.ts:364
DistributionParticipant
DistributionParticipant
src/api/entities/DividendDistribution/index.ts:309
DistributionParticipant
ResultSet
DistributionPayment
src/api/entities/DividendDistribution/index.ts:538
ResultSet
DistributionPayment
ResultSet
DistributionPayment
src/api/entities/DividendDistribution/index.ts:624
ResultSet
DistributionPayment
src/api/entities/DividendDistribution/index.ts:466
src/api/entities/DividendDistribution/index.ts:500
Entity
src/api/entities/Entity.ts:61
LinkCaDocsParams
ProcedureOpts
TransactionQueue
src/api/entities/CorporateActionBase/index.ts:152
ProcedureMethod
linkDocuments.checkAuthorization
TransactionQueue
src/api/entities/DividendDistribution/index.ts:214
ProcedureMethod
modifyCheckpoint.checkAuthorization
TransactionQueue
PayDividendsParams
ProcedureOpts
TransactionQueue
src/api/entities/DividendDistribution/index.ts:232
ProcedureMethod
pay.checkAuthorization
TransactionQueue
ProcedureOpts
TransactionQueue
src/api/entities/DividendDistribution/index.ts:247
NoArgsProcedureMethod
reclaimFunds.checkAuthorization
TransactionQueue
HumanReadable
src/api/entities/DividendDistribution/index.ts:739
HumanReadable
src/api/entities/Entity.ts:14
src/api/entities/Entity.ts:23
CorporateActionBase
asset
context
currency
declarationDate
defaultTaxWithholding
description
expiryDate
id
kind
maxAmount
origin
paymentDate
perShare
targets
taxWithholdings
uuid
checkpoint
claim
details
exists
getParticipant
getParticipants
getPaymentHistory
getPaymentHistoryV2
getWithheldTax
getWithheldTaxV2
isEqual
linkDocuments
modifyCheckpoint
pay
reclaimFunds
toHuman
generateUuid
unserialize
ProcedureOpts
Entity
LinkCaDocsParams
ProcedureOpts
ProcedureOpts
PayDividendsParams
ProcedureOpts
ProcedureOpts
CorporateActionBase
CheckpointSchedule
CorporateActionBase
CorporateActionBase
CorporateActionBase
CorporateActionBase
CorporateActionBase
CorporateActionBase
CorporateActionBase
CheckpointSchedule
CorporateActionBase
CorporateActionBase
CheckpointSchedule
CorporateActionBase
ProcedureOpts
TransactionQueue
CorporateActionBase
CorporateActionBase
CheckpointSchedule
CheckpointSchedule
context
uuid
isEqual
generateUuid
unserialize
asset
declarationDate
defaultTaxWithholding
description
id
kind
targets
taxWithholdings
checkpoint
exists
linkDocuments
modifyCheckpoint
toHuman
Modify
Modify