Class: CorporateBallot
api/entities/CorporateBallot.CorporateBallot
Represents a Ballot
Hierarchy
-
↳
CorporateBallot
Properties
asset
• asset: FungibleAsset
Asset affected by this Corporate Action
Inherited from
Defined in
api/entities/CorporateActionBase/index.ts:80
declarationDate
• declarationDate: Date
date at which the Corporate Action was created
Inherited from
CorporateActionBase.declarationDate
Defined in
api/entities/CorporateActionBase/index.ts:85
defaultTaxWithholding
• defaultTaxWithholding: BigNumber
default percentage (0-100) of tax withholding for this Corporate Action
Inherited from
CorporateActionBase.defaultTaxWithholding
Defined in
api/entities/CorporateActionBase/index.ts:101
description
• description: string
brief text description of the Corporate Action
Inherited from
CorporateActionBase.description
Defined in
api/entities/CorporateActionBase/index.ts:90
id
• id: BigNumber
internal Corporate Action ID
Inherited from
Defined in
api/entities/CorporateActionBase/index.ts:75
targets
• targets: CorporateActionTargets
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
Inherited from
Defined in
api/entities/CorporateActionBase/index.ts:96
taxWithholdings
• taxWithholdings: TaxWithholding[]
percentage (0-100) of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage
Inherited from
CorporateActionBase.taxWithholdings
Defined in
api/entities/CorporateActionBase/index.ts:107
uuid
• uuid: string
Inherited from
Defined in
Methods
checkpoint
▸ checkpoint(): Promise<null | Checkpoint | CheckpointSchedule>
Retrieve the Checkpoint associated with this Corporate Action. If the Checkpoint is scheduled and has not been created yet, the corresponding CheckpointSchedule is returned instead. A null value means the Corporate Action was created without an associated Checkpoint
Returns
Promise<null | Checkpoint | CheckpointSchedule>
Inherited from
CorporateActionBase.checkpoint
Defined in
api/entities/CorporateActionBase/index.ts:191
details
▸ details(): Promise<CorporateBallotDetails>
Retrieve details associated with this Ballot
Returns
Promise<CorporateBallotDetails>
Throws
if the Ballot does not exist
Defined in
api/entities/CorporateBallot/index.ts:136
exists
▸ exists(): Promise<boolean>
Determine whether this Ballot exists on chain
Returns
Promise<boolean>
Overrides
Defined in
api/entities/CorporateBallot/index.ts:115
isEqual
▸ isEqual(entity): boolean
Determine whether this Entity is the same as another one
Parameters
| Name | Type |
|---|---|
entity | Entity<unknown, unknown> |
Returns
boolean
Inherited from
Defined in
linkDocuments
▸ linkDocuments(args, opts?): Promise<GenericPolymeshTransaction<void, void>>
Link a list of documents to this corporate action
Parameters
| Name | Type |
|---|---|
args | LinkCaDocsParams |
opts? | ProcedureOpts |
Returns
Promise<GenericPolymeshTransaction<void, void>>
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
Inherited from
CorporateActionBase.linkDocuments
Defined in
api/entities/CorporateActionBase/index.ts:160
modifyCheckpoint
▸ modifyCheckpoint(args, opts?): Promise<GenericPolymeshTransaction<void, void>>
Modify the Corporate Ballot's Record Date
Parameters
| Name | Type |
|---|---|
args | Object |
args.checkpoint | InputCaCheckpoint |
opts? | ProcedureOpts |
Returns
Promise<GenericPolymeshTransaction<void, void>>
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
Overrides
CorporateActionBase.modifyCheckpoint
Defined in
api/entities/CorporateBallot/index.ts:336
remove
▸ remove(opts?): Promise<GenericPolymeshTransaction<void, void>>
Remove the Ballot
Parameters
| Name | Type |
|---|---|
opts? | ProcedureOpts |
Returns
Promise<GenericPolymeshTransaction<void, void>>
Note
deletes the corporate action with the associated ballot if ballot has not started
Throws
if ballot has already started
Throws
if ballot is not found
Note
this method is of type NoArgsProcedureMethod, which means you can call remove.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Defined in
api/entities/CorporateBallot/index.ts:308
results
▸ results(): Promise<CorporateBallotMetaWithResults>
Retrieve the results of the Ballot
Returns
Promise<CorporateBallotMetaWithResults>
Throws
if the Ballot does not exist
Defined in
api/entities/CorporateBallot/index.ts:173
status
▸ status(): Promise<CorporateBallotStatus>
Return the status of the Ballot
Returns
Promise<CorporateBallotStatus>
Throws
if the Ballot does not exist
Defined in
api/entities/CorporateBallot/index.ts:147
toHuman
▸ toHuman(): HumanReadable
Return the Corporate Action's static data
Returns
Inherited from
Defined in
api/entities/CorporateActionBase/index.ts:271
vote
▸ vote(args, opts?): Promise<GenericPolymeshTransaction<void, void>>
Cast a vote on the Ballot
Parameters
| Name | Type |
|---|---|
args | CastBallotVoteParams |
opts? | ProcedureOpts |
Returns
Promise<GenericPolymeshTransaction<void, void>>
Throws
if the Ballot does not exist
Throws
if the Ballot voting is not active
Throws
if the number of votes does not match the sum of all choices of all motions
Throws
if fallback votes are provided for a non-RCV Ballot
Throws
if vote does not point to the correct choice in motion
Throws
if the fallback vote is the same as the choice
Throws
if the fallback vote is not pointing to a choice in the motion
Note
this method is of type ProcedureMethod, which means you can call vote.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it
Defined in
api/entities/CorporateBallot/index.ts:326
votesByIdentity
▸ votesByIdentity(did): Promise<CorporateBallotWithParticipation>
Retrieve the participation of the Ballot
Parameters
| Name | Type |
|---|---|
did | string | Identity |
Returns
Promise<CorporateBallotWithParticipation>
Throws
if the Ballot does not exist
Defined in
api/entities/CorporateBallot/index.ts:233
generateUuid
▸ Static generateUuid<Identifiers>(identifiers): string
Generate the Entity's UUID from its identifying properties
Type parameters
| Name |
|---|
Identifiers |
Parameters
| Name | Type |
|---|---|
identifiers | Identifiers |
Returns
string
Inherited from
CorporateActionBase.generateUuid
Defined in
unserialize
▸ Static unserialize<Identifiers>(serialized): Identifiers
Unserialize a UUID into its Unique Identifiers
Type parameters
| Name |
|---|
Identifiers |
Parameters
| Name | Type | Description |
|---|---|---|
serialized | string | UUID to unserialize |
Returns
Identifiers
Inherited from
CorporateActionBase.unserialize