DividendDistribution
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: Asset
Inherited from CorporateActionBase.asset
Defined in src/api/entities/CorporateActionBase/index.ts:77
Asset affected by this Corporate Action
Protected context
Protected context• context: Context
Inherited from CheckpointSchedule.context
Defined in src/api/entities/Entity.ts:48
currency
• currency: string
Defined in src/api/entities/DividendDistribution/index.ts:100
ticker of the currency in which dividends are being distributed
declarationDate
• declarationDate: Date
Inherited from CorporateActionBase.declarationDate
Defined in src/api/entities/CorporateActionBase/index.ts:82
date at which the Corporate Action was created
defaultTaxWithholding
• defaultTaxWithholding: BigNumber
Inherited from CorporateActionBase.defaultTaxWithholding
Defined in src/api/entities/CorporateActionBase/index.ts:98
default percentage (0-100) of tax withholding for this Corporate Action
description
• description: string
Inherited from CorporateActionBase.description
Defined in src/api/entities/CorporateActionBase/index.ts:87
brief text description of the Corporate Action
expiryDate
• expiryDate: null | Date
Defined in src/api/entities/DividendDistribution/index.ts:116
date after which dividends can no longer be paid/reclaimed. A null value means the distribution never expires
id
• id: BigNumber
Inherited from CorporateActionBase.id
Defined in src/api/entities/CorporateActionBase/index.ts:72
internal Corporate Action ID
Protected kind
Protected kind• kind: UnpredictableBenefit | PredictableBenefit
Overrides CorporateActionBase.kind
Defined in src/api/entities/DividendDistribution/index.ts:126
type of dividend distribution being represented. The chain enforces it to be either PredictableBenefit or UnpredictableBenefit
maxAmount
• maxAmount: BigNumber
Defined in src/api/entities/DividendDistribution/index.ts:111
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
• origin: DefaultPortfolio | NumberedPortfolio
Defined in src/api/entities/DividendDistribution/index.ts:95
Portfolio from which the dividends will be distributed
paymentDate
• paymentDate: Date
Defined in src/api/entities/DividendDistribution/index.ts:121
date starting from which dividends can be paid/reclaimed
perShare
• perShare: BigNumber
Defined in src/api/entities/DividendDistribution/index.ts:105
amount of currency to pay for each share held by the Asset Holders
targets
• targets: CorporateActionTargets
Inherited from CorporateActionBase.targets
Defined in src/api/entities/CorporateActionBase/index.ts:93
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
• taxWithholdings: TaxWithholding[]
Inherited from CorporateActionBase.taxWithholdings
Defined in src/api/entities/CorporateActionBase/index.ts:104
percentage (0-100) of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage
uuid
• uuid: string
Inherited from CheckpointSchedule.uuid
Defined in src/api/entities/Entity.ts:46
Methods
checkpoint
▸ checkpoint(): Promise‹Checkpoint | CheckpointSchedule›
Overrides CorporateActionBase.checkpoint
Defined in src/api/entities/DividendDistribution/index.ts:246
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
Returns: Promise‹Checkpoint | CheckpointSchedule›
claim
▸ claim(opts?: ProcedureOpts): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:195
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)
note this method is of type NoArgsProcedureMethod, which means you can call claim.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Parameters:
opts?
Returns: Promise‹TransactionQueue‹void››
details
▸ details(): Promise‹DividendDistributionDetails›
Defined in src/api/entities/DividendDistribution/index.ts:274
Retrieve details associated with this Dividend Distribution
Returns: Promise‹DividendDistributionDetails›
exists
▸ exists(): Promise‹boolean›
Overrides CorporateActionBase.exists
Defined in src/api/entities/DividendDistribution/index.ts:265
Retrieve whether the Distribution exists
Returns: Promise‹boolean›
getParticipant
▸ getParticipant(args?: undefined | object): Promise‹DistributionParticipant | null›
Defined in src/api/entities/DividendDistribution/index.ts:360
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:
args?
undefined | object
Returns: Promise‹DistributionParticipant | null›
getParticipants
▸ getParticipants(): Promise‹DistributionParticipant[]›
Defined in src/api/entities/DividendDistribution/index.ts:300
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
Returns: Promise‹DistributionParticipant[]›
getPaymentHistory
▸ getPaymentHistory(opts: object): Promise‹ResultSet‹DistributionPayment››
Defined in src/api/entities/DividendDistribution/index.ts:470
Retrieve the payment history for this Distribution
note uses the middleware
note supports pagination
Parameters:
▪Default value opts: object= {}
size?
BigNumber
start?
BigNumber
Returns: Promise‹ResultSet‹DistributionPayment››
getWithheldTax
▸ getWithheldTax(): Promise‹BigNumber›
Defined in src/api/entities/DividendDistribution/index.ts:435
Retrieve the amount of taxes that have been withheld up to this point in this Distribution
note uses the middleware
Returns: Promise‹BigNumber›
isEqual
▸ isEqual(entity: Entity‹unknown, unknown›): boolean
Inherited from CheckpointSchedule.isEqual
Defined in src/api/entities/Entity.ts:61
Determine whether this Entity is the same as another one
Parameters:
entity
Entity‹unknown, unknown›
Returns: boolean
linkDocuments
▸ linkDocuments(args: LinkCaDocsParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››
Inherited from CorporateActionBase.linkDocuments
Defined in src/api/entities/CorporateActionBase/index.ts:152
Link a list of documents to this corporate action
note any previous links are removed in favor of the new list
note this method is of type ProcedureMethod, which means you can call linkDocuments.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Parameters:
args
opts?
Returns: Promise‹TransactionQueue‹void››
modifyCheckpoint
▸ modifyCheckpoint(args: Modify‹ModifyCaCheckpointParams, object›, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››
Overrides CorporateActionBase.modifyCheckpoint
Defined in src/api/entities/DividendDistribution/index.ts:205
Modify the Distribution's Checkpoint
note this method is of type ProcedureMethod, which means you can call modifyCheckpoint.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Parameters:
args
Modify‹ModifyCaCheckpointParams, object›
opts?
Returns: Promise‹TransactionQueue‹void››
pay
▸ pay(args: PayDividendsParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:223
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)
note this method is of type ProcedureMethod, which means you can call pay.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Parameters:
opts?
Returns: Promise‹TransactionQueue‹void››
reclaimFunds
▸ reclaimFunds(opts?: ProcedureOpts): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:238
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
note this method is of type NoArgsProcedureMethod, which means you can call reclaimFunds.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Parameters:
opts?
Returns: Promise‹TransactionQueue‹void››
toJson
▸ toJson(): HumanReadable
Overrides CorporateActionBase.toJson
Defined in src/api/entities/DividendDistribution/index.ts:600
Return the Dividend Distribution's static data
Returns: HumanReadable
Static generateUuid
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
Parameters:
identifiers
Identifiers
Returns: string
Static unserialize
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
Parameters:
serialized
string
UUID to unserialize
Returns: Identifiers
Last updated
Was this helpful?