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:91

Portfolio from which the dividends will be distributed

paymentDate

• paymentDate: Date

Defined in src/api/entities/DividendDistribution/index.ts:117

date starting from which dividends can be paid/reclaimed

perShare

• perShare: BigNumber

Defined in src/api/entities/DividendDistribution/index.ts:101

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:93

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:104

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:77

ticker of the Security Token

uuid

• uuid: string

Inherited from Entity.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:236

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, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/DividendDistribution/index.ts:190

Claim the Dividends corresponding to the current 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 ProcedureMethod, which means you can call claim.checkAuthorization on it to see whether the Current Account has the required permissions to run it

Parameters:

Name Type

Name	Type
`args`	void
`opts?`	ProcedureOpts

args

void

opts?

ProcedureOpts

Returns: Promise‹TransactionQueue‹void››

details

▸ details(): Promise‹DividendDistributionDetails›

Defined in src/api/entities/DividendDistribution/index.ts:264

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:255

Retrieve whether the Distribution exists

Returns: Promise‹boolean›

getParticipant

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

Defined in src/api/entities/DividendDistribution/index.ts:350

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

Name	Type
`args?`	undefined \| object

args?

undefined | object

Returns: Promise‹DistributionParticipant | null›

getParticipants

▸ getParticipants(): Promise‹DistributionParticipant[]›

Defined in src/api/entities/DividendDistribution/index.ts:290

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:454

Retrieve the payment history for this Distribution

note uses the middleware

note supports pagination

Parameters:

▪Default value opts: object= {}

Name Type

Name	Type
`size?`	undefined \| number
`start?`	undefined \| number

size?

undefined | number

start?

undefined | number

Returns: Promise‹ResultSet‹DistributionPayment››

getWithheldTax

▸ getWithheldTax(): Promise‹BigNumber›

Defined in src/api/entities/DividendDistribution/index.ts:423

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 Entity.isEqual

Defined in src/api/entities/Entity.ts:61

Determine whether this Entity is the same as another one

Parameters:

Name Type

Name	Type
`entity`	Entity‹unknown, unknown›

entity

Entity‹unknown, unknown›

Returns: boolean

linkDocuments

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

Inherited from CorporateAction.linkDocuments

Defined in src/api/entities/CorporateAction/index.ts:162

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 Current Account has the required permissions to run it

Parameters:

Name Type

Name	Type
`args`	LinkCaDocsParams
`opts?`	ProcedureOpts

args

LinkCaDocsParams

opts?

ProcedureOpts

Returns: Promise‹TransactionQueue‹void››

modifyCheckpoint

▸ modifyCheckpoint(args: ModifyDistributionCheckpointParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Overrides CorporateAction.modifyCheckpoint

Defined in src/api/entities/DividendDistribution/index.ts:200

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:

Name Type

Name	Type
`args`	ModifyDistributionCheckpointParams
`opts?`	ProcedureOpts

args

ModifyDistributionCheckpointParams

opts?

ProcedureOpts

Returns: Promise‹TransactionQueue‹void››

pay

▸ pay(args: PayDividendsParams, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/DividendDistribution/index.ts:213

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 Current Account has the required permissions to run it

Parameters:

Name Type

Name	Type
`args`	PayDividendsParams
`opts?`	ProcedureOpts

args

PayDividendsParams

opts?

ProcedureOpts

Returns: Promise‹TransactionQueue‹void››

reclaimFunds

▸ reclaimFunds(args: void, opts?: ProcedureOpts): Promise‹TransactionQueue‹void››

Defined in src/api/entities/DividendDistribution/index.ts:228

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:

Name Type

Name	Type
`args`	void
`opts?`	ProcedureOpts

args

void

opts?

ProcedureOpts

Returns: Promise‹TransactionQueue‹void››

toJson

▸ toJson(): HumanReadable

Overrides CorporateAction.toJson

Defined in src/api/entities/DividendDistribution/index.ts:564

Return the Dividend Distribution's static data

Returns: HumanReadable

`Static` generateUuid

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

Inherited from Entity.generateUuid

Defined in src/api/entities/Entity.ts:14

Generate the Entity's UUID from its identifying properties

Type parameters:

▪ Identifiers

Parameters:

Name Type Description

Name	Type	Description
`identifiers`	Identifiers

identifiers

Identifiers

Returns: string

`Static` unserialize

▸ unserialize‹Identifiers›(serialized: string): Identifiers

Inherited from Entity.unserialize

Defined in src/api/entities/Entity.ts:23

Unserialize a UUID into its Unique Identifiers

Type parameters:

▪ Identifiers

Parameters:

Name Type Description

Name	Type	Description
`serialized`	string	UUID to unserialize

serialized

string

UUID to unserialize

Returns: Identifiers

PreviousDistributions NextDocuments

Last updated 2 years ago

Hierarchy

Index

Properties

Methods

Properties

Protected context

currency

declarationDate

defaultTaxWithholding

description

expiryDate

id

Protected kind

maxAmount

origin

paymentDate

perShare

targets

taxWithholdings

ticker

uuid

Methods

checkpoint

claim

details

exists

getParticipant

getParticipants

getPaymentHistory

getWithheldTax

isEqual

linkDocuments

modifyCheckpoint

pay

reclaimFunds

toJson

Static generateUuid

Static unserialize

`Protected` context

`Protected` kind

`Static` generateUuid

`Static` unserialize