DividendDistribution
Represents a Corporate Action via which a Security Token issuer wishes to distribute dividends between a subset of the Tokenholders (targets)
Hierarchy
↳ DividendDistribution
Index
Properties
Methods
Properties
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:74
ticker of the currency in which dividends are being distibuted
declarationDate
• declarationDate: Date
Inherited from CorporateAction.declarationDate
Defined in src/api/entities/CorporateAction/index.ts:70
date at which the Corporate Action was created
defaultTaxWithholding
• defaultTaxWithholding: BigNumber
Inherited from CorporateAction.defaultTaxWithholding
Defined in src/api/entities/CorporateAction/index.ts:86
default percentage of tax withholding for this Corporate Action
description
• description: string
Inherited from CorporateAction.description
Defined in src/api/entities/CorporateAction/index.ts:75
brief text description of the Corporate Action
expiryDate
• expiryDate: null | Date
Defined in src/api/entities/DividendDistribution/index.ts:90
date after which dividends can no longer be paid/reclaimed. A null value means the distribution never expires
id
• id: BigNumber
Inherited from CorporateAction.id
Defined in src/api/entities/CorporateAction/index.ts:60
internal Corporate Action ID
Protected
kind
Protected
kind• kind: UnpredictableBenefit
Overrides CorporateAction.kind
Defined in src/api/entities/DividendDistribution/index.ts:97
maxAmount
• maxAmount: BigNumber
Defined in src/api/entities/DividendDistribution/index.ts:85
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
origin
• origin: DefaultPortfolio | NumberedPortfolio
Defined in src/api/entities/DividendDistribution/index.ts:69
Portfolio from which the dividends will be distributed
paymentDate
• paymentDate: Date
Defined in src/api/entities/DividendDistribution/index.ts:95
date starting from which dividends can be paid/reclaimed
perShare
• perShare: BigNumber
Defined in src/api/entities/DividendDistribution/index.ts:79
amount of currency
to pay for each share the Tokenholder holds
targets
• targets: CorporateActionTargets
Inherited from CorporateAction.targets
Defined in src/api/entities/CorporateAction/index.ts:81
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
taxWithholdings
• taxWithholdings: TaxWithholding[]
Inherited from CorporateAction.taxWithholdings
Defined in src/api/entities/CorporateAction/index.ts:92
percentage of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage
ticker
• ticker: string
Inherited from CorporateAction.ticker
Defined in src/api/entities/CorporateAction/index.ts:65
ticker of the Security Token
uuid
• uuid: string
Inherited from CheckpointSchedule.uuid
Defined in src/api/entities/Entity.ts:46
Methods
checkpoint
▸ checkpoint(): Promise‹Checkpoint | CheckpointSchedule›
Overrides CorporateAction.checkpoint
Defined in src/api/entities/DividendDistribution/index.ts:206
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(args
: void): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:161
Claim the dividends corresponding to the current Identity
note
this method is of type ProcedureMethod, which means you can call claim.checkAuthorization
on it to see whether the Current Account has the required permissions to run it
Parameters:
Returns: Promise‹TransactionQueue‹void››
details
▸ details(): Promise‹DividendDistributionDetails›
Defined in src/api/entities/DividendDistribution/index.ts:225
Retrieve details associated with this Dividend Distribution
Returns: Promise‹DividendDistributionDetails›
exists
▸ exists(): Promise‹boolean›
Overrides CorporateAction.exists
Defined in src/api/entities/DividendDistribution/index.ts:216
Retrieve whether the Distribution exists
Returns: Promise‹boolean›
getParticipant
▸ getParticipant(args?
: undefined | object): Promise‹DistributionParticipant | null›
Defined in src/api/entities/DividendDistribution/index.ts:311
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:
Returns: Promise‹DistributionParticipant | null›
getParticipants
▸ getParticipants(): Promise‹DistributionParticipant[]›
Defined in src/api/entities/DividendDistribution/index.ts:251
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
Returns: Promise‹DistributionParticipant[]›
getPaymentHistory
▸ getPaymentHistory(opts
: object): Promise‹ResultSet‹DistributionPayment››
Defined in src/api/entities/DividendDistribution/index.ts:406
Retrieve the payment history for this Distribution
note
uses the middleware
note
supports pagination
Parameters:
▪Default value
opts: object= {}
Returns: Promise‹ResultSet‹DistributionPayment››
getWithheldTax
▸ getWithheldTax(): Promise‹BigNumber›
Defined in src/api/entities/DividendDistribution/index.ts:384
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›): boolean
Inherited from CheckpointSchedule.isEqual
Defined in src/api/entities/Entity.ts:61
Whether this Entity is the same as another one
Parameters:
Returns: boolean
linkDocuments
▸ linkDocuments(args
: LinkCaDocsParams): Promise‹TransactionQueue‹void››
Inherited from CorporateAction.linkDocuments
Defined in src/api/entities/CorporateAction/index.ts:149
Link a list of documents to this corporate action
note
any previous links are removed in favor of the new list
note
required role:
Corporate Actions Agent
note
this method is of type ProcedureMethod, which means you can call linkDocuments.checkAuthorization
on it to see whether the Current Account has the required permissions to run it
Parameters:
Returns: Promise‹TransactionQueue‹void››
modifyCheckpoint
▸ modifyCheckpoint(args
: ModifyDistributionCheckpointParams): Promise‹TransactionQueue‹void››
Overrides CorporateAction.modifyCheckpoint
Defined in src/api/entities/DividendDistribution/index.ts:171
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 Current Account has the required permissions to run it
Parameters:
Returns: Promise‹TransactionQueue‹void››
pay
▸ pay(args
: PayDividendsParams): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:183
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
this method is of type ProcedureMethod, which means you can call pay.checkAuthorization
on it to see whether the Current Account has the required permissions to run it
Parameters:
Returns: Promise‹TransactionQueue‹void››
reclaimFunds
▸ reclaimFunds(args
: void): Promise‹TransactionQueue‹void››
Defined in src/api/entities/DividendDistribution/index.ts:198
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 ProcedureMethod, which means you can call reclaimFunds.checkAuthorization
on it to see whether the Current Account has the required permissions to run it
Parameters:
Returns: Promise‹TransactionQueue‹void››
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:
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:
Returns: Identifiers
Last updated