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

Portfolio from which the dividends will be distributed

paymentDate

• paymentDate: Date

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

date starting from which dividends can be paid/reclaimed

perShare

• perShare: BigNumber

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

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

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

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:

Name

Type

opts?

Returns: Promise‹TransactionQueue‹void››

details

▸ details(): Promise‹DividendDistributionDetails›

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

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

Retrieve whether the Distribution exists

Returns: Promise‹boolean›

getParticipant

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

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

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

Returns: Promise‹DistributionParticipant | null›

getParticipants

▸ getParticipants(): Promise‹DistributionParticipant[]›

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

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

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

Returns: Promise‹ResultSet‹DistributionPayment››

getPaymentHistoryV2

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

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

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

Returns: Promise‹ResultSet‹DistributionPayment››

getWithheldTax

▸ getWithheldTax(): Promise‹BigNumber›

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

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›

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

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

note uses the middlewareV2

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:

Name

Type

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:

Name

Type

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

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:

Name

Type

args

‹ModifyCaCheckpointParams, object›

opts?

Returns: Promise‹TransactionQueue‹void››

pay

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

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

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:

Name

Type

args

opts?

Returns: Promise‹TransactionQueue‹void››

reclaimFunds

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

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

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:

Name

Type

opts?

Returns: Promise‹TransactionQueue‹void››

toHuman

▸ toHuman(): HumanReadable

Overrides CorporateActionBase.toHuman

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

Return the Dividend Distribution's static data

Returns: HumanReadable

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

Name

Type

Description

identifiers

Identifiers

Returns: string

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

Name

Type

Description

serialized

string

UUID to unserialize

Returns: Identifiers

PreviousDistributions NextDocuments

Last updated 2 years ago

Was this helpful?

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

`Protected` context

`Protected` kind

`Static` generateUuid

`Static` unserialize