DividendDistribution
Last updated
Was this helpful?
Last updated
Was this helpful?
Represents a Corporate Action via which a Security Token issuer wishes to distribute dividends between a subset of the Tokenholders (targets)
↳
↳ DividendDistribution
• claim: ProcedureMethod‹void, void›
Claim the dividends corresponding to the current Identity
Protected context• currency: string
ticker of the currency in which dividends are being distibuted
• declarationDate: Date
date at which the Corporate Action was created
• defaultTaxWithholding: BigNumber
default percentage of tax withholding for this Corporate Action
• description: string
brief text description of the Corporate Action
• expiryDate: null | Date
date after which dividends can no longer be paid/reclaimed. A null value means the distribution never expires
• id: BigNumber
internal Corporate Action ID
Protected kindLink a list of documents to this corporate action
param list of documents
note any previous links are removed in favor of the new list
note required role:
Corporate Actions Agent
• maxAmount: BigNumber
maximum amount of currency to be distributed. Distributions are "first come, first served", so funds can be depleted before every Tokenholder receives their corresponding amount
• modifyCheckpoint: ProcedureMethod‹ModifyDistributionCheckpointParams, void›
Modify the Distribution's checkpoint
Portfolio from which the dividends will be distributed
Transfer the corresponding share of the dividends to a list of Identities
• paymentDate: Date
date starting from which dividends can be paid/reclaimed
• perShare: BigNumber
amount of currency to pay for each share the Tokenholder holds
• reclaimFunds: ProcedureMethod‹void, void›
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
tokenholder identities related to this Corporate action. If the treatment is Exclude, the identities are not targeted by the Action, and any identities left out of the array will be targeted, and vice versa
percentage of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage
• ticker: string
ticker of the Security Token
• uuid: string
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
Retrieve details associated with this Dividend Distribution
▸ exists(): Promise‹boolean›
Retrieve whether the Distribution exists
Returns: Promise‹boolean›
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 Tokenholders
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
▸ 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›
Whether this Entity is the same as another one
Parameters:
Name
Type
entity
Returns: boolean
Static generateUuid▸ generateUuid‹Identifiers›(identifiers: Identifiers): string
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
Unserialize a UUID into its Unique Identifiers
Type parameters:
â–ª Identifiers: object
Parameters:
Name
Type
Description
serialized
string
UUID to unserialize
Returns: Identifiers
Defined in
• context:
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
• linkDocuments: ProcedureMethod‹, void›
Inherited from .
Defined in
Defined in
Overrides .
Defined in
• origin: |
Defined in
• pay: ProcedureMethod‹, void›
Defined in
Defined in
Defined in
Defined in
• targets:
Inherited from .
Defined in
• taxWithholdings: []
Inherited from .
Defined in
Inherited from .
Defined in
Inherited from .
Defined in
▸ checkpoint(): Promise‹ | ›
Overrides .
Defined in
Returns: Promise‹ | ›
▸ details(): Promise‹›
Defined in
Returns: Promise‹›
Overrides .
Defined in
▸ getParticipants(): Promise‹[]›
Defined in
Returns: Promise‹[]›
Defined in
▸ isEqual(entity: ‹object›): boolean
Inherited from .
Defined in
‹object›
Inherited from .
Defined in
Inherited from .
Defined in