AElf.Contracts.Election¶
Election contract.
Used for voting for Block Producers.
Implement AElf Standards ACS1.
Contract Methods¶
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| InitialElectionContract | Election.InitialElectionContractInput | google.protobuf.Empty | Initialize the election contract. |
| RegisterElectionVotingEvent | google.protobuf.Empty | google.protobuf.Empty | Register a new voting item through vote contract. |
| TakeSnapshot | Election.TakeElectionSnapshotInput | google.protobuf.Empty | Take snapshot according to term number, and distribute profits. |
| AnnounceElection | aelf.Address | google.protobuf.Empty | To be a block producer, a user should first register to be a candidate and lock some token as a deposit. If the data center is not full, the user will be added in automatically and get one weight for sharing bonus in the future. |
| QuitElection | google.protobuf.StringValue | google.protobuf.Empty | A candidate is able to quit the election provided he is not currently elected. If you quit successfully, the candidate will get his locked tokens back and will not receive anymore bonus. |
| Vote | Election.VoteMinerInput | aelf.Hash | Used for voting for a candidate to be elected. The tokens you vote with will be locked until the end time. According to the number of token you voted and its lock time, you can get corresponding weight for sharing the bonus in the future. And return the vote id. |
| ChangeVotingOption | Election.ChangeVotingOptionInput | google.protobuf.Empty | Before the end time, you are able to change your vote target to other candidates. |
| Withdraw | aelf.Hash | google.protobuf.Empty | After the lock time, your locked tokens will be unlocked and you can withdraw them according to the vote id. |
| UpdateCandidateInformation | Election.UpdateCandidateInformationInput | google.protobuf.Empty | Update candidate information by consensus contract. |
| UpdateMultipleCandidateInformation | Election.UpdateMultipleCandidateInformationInput | google.protobuf.Empty | Batch update candidate information by consensus contract. |
| UpdateMinersCount | Election.UpdateMinersCountInput | google.protobuf.Empty | Update the count of miner by consensus contract. |
| SetTreasurySchemeIds | Election.SetTreasurySchemeIdsInput | google.protobuf.Empty | Set the treasury profit ids. |
| SetVoteWeightInterest | Election.VoteWeightInterestList | google.protobuf.Empty | Set the weight of vote interest. |
| SetVoteWeightProportion | Election.VoteWeightProportion | google.protobuf.Empty | Set the weight of lock time and votes in the calculation of voting weight. |
| ChangeVoteWeightInterestController | AuthorityInfo | google.protobuf.Empty | Change the controller for the weight of vote interest. |
| ReplaceCandidatePubkey | Election.ReplaceCandidatePubkeyInput | google.protobuf.Empty | Candidate admin can replace candidate pubkey with a new pubkey. |
| SetCandidateAdmin | Election.SetCandidateAdminInput | google.protobuf.Empty | Set admin address of candidate (mostly supply) |
| GetCandidates | google.protobuf.Empty | Election.PubkeyList | Get all candidates’ public keys. |
| GetVotedCandidates | google.protobuf.Empty | Election.PubkeyList | Get all candidates whose number of votes is greater than 0. |
| GetCandidateInformation | google.protobuf.StringValue | Election.CandidateInformation | Get a candidate’s information. |
| GetVictories | google.protobuf.Empty | Election.PubkeyList | Get the victories of the latest term. |
| GetTermSnapshot | Election.GetTermSnapshotInput | Election.TermSnapshot | Get the snapshot of term according to term number. |
| GetMinersCount | google.protobuf.Empty | google.protobuf.Int32Value | Get the count of miner. |
| GetElectionResult | Election.GetElectionResultInput | Election.ElectionResult | Get the election result according to term id. |
| GetElectorVote | google.protobuf.StringValue | Election.ElectorVote | Get the voter information according to voter public key. |
| GetElectorVoteWithRecords | google.protobuf.StringValue | Election.ElectorVote | Gets the voter information including the active voting records (excluding withdrawn voting records.). |
| GetElectorVoteWithAllRecords | google.protobuf.StringValue | Election.ElectorVote | Gets the voter information including the active and withdrawn voting records. |
| GetCandidateVote | google.protobuf.StringValue | Election.CandidateVote | Get voting information for candidate according to the public key of the candidate. |
| GetCandidateVoteWithRecords | google.protobuf.StringValue | Election.CandidateVote | Get voting information for candidate according to the public key of the candidate. |
| GetCandidateVoteWithAllRecords | google.protobuf.StringValue | Election.CandidateVote | Get voting information for candidate according to the public key of the candidate (including the active and withdrawn voting records). |
| GetVotersCount | google.protobuf.Empty | google.protobuf.Int64Value | Get the total number of voters. |
| GetVotesAmount | google.protobuf.Empty | google.protobuf.Int64Value | Get the total number of vote token. |
| GetPageableCandidateInformation | Election.PageInformation | Election.GetPageableCandidateInformationOutput | Get candidate information according to the index and length. |
| GetMinerElectionVotingItemId | google.protobuf.Empty | aelf.Hash | Get the voting item id of miner election. |
| GetDataCenterRankingList | google.protobuf.Empty | Election.DataCenterRankingList | Get the data center ranking list. |
| GetVoteWeightSetting | google.protobuf.Empty | Election.VoteWeightInterestList | Get the weight of vote interest. |
| GetVoteWeightProportion | google.protobuf.Empty | Election.VoteWeightProportion | Get the weight of lock time and votes in the calculation of voting weight. |
| GetCalculateVoteWeight | Election.VoteInformation | google.protobuf.Int64Value | Used to calculate the bonus weights that users can get by voting. |
| GetVoteWeightInterestController | google.protobuf.Empty | AuthorityInfo | Query the controller for the weight of vote interest. |
| GetMinerReplacementInformation | Election.GetMinerReplacementInformationInput | Election.MinerReplacementInformation | Inspect the evil nodes included in the specified miners and return to the replacement node. |
| GetCandidateAdmin | google.protobuf.StringValue | aelf.Address | Query candidate admin. |
| GetNewestPubkey | google.protobuf.StringValue | google.protobuf.StringValue | Query the newest pubkey of an old pubkey. |
| GetReplacedPubkey | google.protobuf.StringValue | google.protobuf.StringValue | Query the old pubkey. |
AElf.Standards.ACS1¶
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| SetMethodFee | acs1.MethodFees | google.protobuf.Empty | Set the method fees for the specified method. Note that this will override all fees of the method. |
| ChangeMethodFeeController | AuthorityInfo | google.protobuf.Empty | Change the method fee controller, the default is parliament and default organization. |
| GetMethodFee | google.protobuf.StringValue | acs1.MethodFees | Query method fee information by method name. |
| GetMethodFeeController | google.protobuf.Empty | AuthorityInfo | Query the method fee controller. |
Contract Types¶
AElf.Contracts.Election¶
Election.CandidateDetail¶
| Field | Type | Description | Label |
|---|---|---|---|
| candidate_information | CandidateInformation | The candidate information. | |
| obtained_votes_amount | int64 | The number of votes a candidate has obtained. |
Election.CandidateInformation¶
| Field | Type | Description | Label |
|---|---|---|---|
| pubkey | string | Candidate’s public key. | |
| terms | int64 | The number of terms that the candidate is elected. | repeated |
| produced_blocks | int64 | The number of blocks the candidate has produced. | |
| missed_time_slots | int64 | The time slot for which the candidate failed to produce blocks. | |
| continual_appointment_count | int64 | The count of continual appointment. | |
| announcement_transaction_id | aelf.Hash | The transaction id when the candidate announced. | |
| is_current_candidate | bool | Indicate whether the candidate can be elected in the current term. |
Election.CandidateVote¶
| Field | Type | Description | Label |
|---|---|---|---|
| obtained_active_voting_record_ids | aelf.Hash | The active voting record ids obtained. | repeated |
| obtained_withdrawn_voting_record_ids | aelf.Hash | The active voting record ids that were withdrawn. | repeated |
| obtained_active_voted_votes_amount | int64 | The total number of active votes obtained. | |
| all_obtained_voted_votes_amount | int64 | The total number of votes obtained. | |
| obtained_active_voting_records | ElectionVotingRecord | The active voting records. | repeated |
| obtained_withdrawn_votes_records | ElectionVotingRecord | The voting records that were withdrawn. | repeated |
| pubkey | bytes | Public key for candidate. |
Election.ChangeVotingOptionInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| vote_id | aelf.Hash | The vote id to change. | |
| candidate_pubkey | string | The new candidate public key. |
Election.DataCenterRankingList¶
| Field | Type | Description | Label |
|---|---|---|---|
| data_centers | DataCenterRankingList.DataCentersEntry | The top n * 5 candidates with vote amount, candidate public key -> vote amount. | repeated |
Election.DataCenterRankingList.DataCentersEntry¶
| Field | Type | Description | Label |
|---|---|---|---|
| key | string | ||
| value | int64 |
Election.ElectionResult¶
| Field | Type | Description | Label |
|---|---|---|---|
| term_number | int64 | The term number | |
| results | ElectionResult.ResultsEntry | The election result, candidates’ public key -> number of votes. | repeated |
| is_active | bool | Whether an election is currently being held. |
Election.ElectionVotingRecord¶
| Field | Type | Description | Label |
|---|---|---|---|
| voter | aelf.Address | The address of voter. | |
| candidate | string | The public key of candidate. | |
| amount | int64 | Amount of voting. | |
| term_number | int64 | The term number of voting. | |
| vote_id | aelf.Hash | The vote id. | |
| lock_time | int64 | Vote lock time. | |
| unlock_timestamp | google.protobuf.Timestamp | The unlock timestamp. | |
| withdraw_timestamp | google.protobuf.Timestamp | The withdraw timestamp. | |
| vote_timestamp | google.protobuf.Timestamp | The vote timestamp. | |
| is_withdrawn | bool | Indicates if the vote has been withdrawn. | |
| weight | int64 | Vote weight for sharing bonus. | |
| is_change_target | bool | Whether vote others. |
Election.ElectorVote¶
| Field | Type | Description | Label |
|---|---|---|---|
| active_voting_record_ids | aelf.Hash | The active voting record ids. | repeated |
| withdrawn_voting_record_ids | aelf.Hash | The voting record ids that were withdrawn. | repeated |
| active_voted_votes_amount | int64 | The total number of active votes. | |
| all_voted_votes_amount | int64 | The total number of votes (including the number of votes withdrawn). | |
| active_voting_records | ElectionVotingRecord | The active voting records. | repeated |
| withdrawn_votes_records | ElectionVotingRecord | The voting records that were withdrawn. | repeated |
| pubkey | bytes | Public key for voter. |
Election.EvilMinerDetected¶
| Field | Type | Description | Label |
|---|---|---|---|
| pubkey | string | The public key of evil miner. |
Election.GetMinerReplacementInformationInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| current_miner_list | string | The current miner list to inspect. | repeated |
Election.GetPageableCandidateInformationOutput¶
| Field | Type | Description | Label |
|---|---|---|---|
| value | CandidateDetail | The details of the candidates. | repeated |
Election.InitialElectionContractInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| minimum_lock_time | int64 | Minimum number of seconds for locking. | |
| maximum_lock_time | int64 | Maximum number of seconds for locking. | |
| miner_list | string | The current miner list. | repeated |
| time_each_term | int64 | The number of seconds per term. | |
| miner_increase_interval | int64 | The interval second that increases the number of miners. |
Election.MinerReplacementInformation¶
| Field | Type | Description | Label |
|---|---|---|---|
| alternative_candidate_pubkeys | string | The alternative candidate public keys. | repeated |
| evil_miner_pubkeys | string | The evil miner public keys. | repeated |
Election.PageInformation¶
| Field | Type | Description | Label |
|---|---|---|---|
| start | int32 | The start index. | |
| length | int32 | The number of records. |
Election.ReplaceCandidatePubkeyInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| old_pubkey | string | ||
| new_pubkey | string |
Election.SetCandidateAdminInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| pubkey | string | ||
| admin | aelf.Address |
Election.SetTreasurySchemeIdsInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| treasury_hash | aelf.Hash | The scheme id of treasury reward. | |
| welfare_hash | aelf.Hash | The scheme id of welfare reward. | |
| subsidy_hash | aelf.Hash | The scheme id of subsidy reward. | |
| votes_reward_hash | aelf.Hash | The scheme id of votes reward. | |
| re_election_reward_hash | aelf.Hash | The scheme id of re-election reward. |
Election.TakeElectionSnapshotInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| term_number | int64 | The term number to take snapshot. | |
| mined_blocks | int64 | The number of mined blocks of this term. | |
| round_number | int64 | The end round number of this term. |
Election.TermSnapshot¶
| Field | Type | Description | Label |
|---|---|---|---|
| end_round_number | int64 | The end round number of this term. | |
| mined_blocks | int64 | The number of blocks mined in this term. | |
| election_result | TermSnapshot.ElectionResultEntry | The election result, candidates’ public key -> number of votes. | repeated |
Election.UpdateCandidateInformationInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| pubkey | string | The candidate public key. | |
| recently_produced_blocks | int64 | The number of blocks recently produced. | |
| recently_missed_time_slots | int64 | The number of time slots recently missed. | |
| is_evil_node | bool | Is it a evil node. If true will remove the candidate. |
Election.UpdateMinersCountInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| miners_count | int32 | The count of miner. |
Election.UpdateMultipleCandidateInformationInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| value | UpdateCandidateInformationInput | The candidate information to update. | repeated |
Election.VoteInformation¶
| Field | Type | Description | Label |
|---|---|---|---|
| amount | int64 | Amount of voting. | |
| lock_time | int64 | Vote lock time. |
Election.VoteMinerInput¶
| Field | Type | Description | Label |
|---|---|---|---|
| candidate_pubkey | string | The candidate public key. | |
| amount | int64 | The amount token to vote. | |
| end_timestamp | google.protobuf.Timestamp | The end timestamp of this vote. | |
| token | aelf.Hash | Used to generate vote id. |
Election.VoteWeightInterest¶
| Field | Type | Description | Label |
|---|---|---|---|
| day | int32 | Number of days locked. | |
| interest | int32 | Locked interest. | |
| capital | int32 |
Election.VoteWeightInterestList¶
| Field | Type | Description | Label |
|---|---|---|---|
| vote_weight_interest_infos | VoteWeightInterest | The weight of vote interest. | repeated |
AElf.Standards.ACS1¶
AElf.Types¶
aelf.BinaryMerkleTree¶
| Field | Type | Description | Label |
|---|---|---|---|
| nodes | Hash | The leaf nodes. | repeated |
| root | Hash | The root node hash. | |
| leaf_count | int32 | The count of leaf node. |
aelf.LogEvent¶
| Field | Type | Description | Label |
|---|---|---|---|
| address | Address | The contract address. | |
| name | string | The name of the log event. | |
| indexed | bytes | The indexed data, used to calculate bloom. | repeated |
| non_indexed | bytes | The non indexed data. |
aelf.MerklePath¶
| Field | Type | Description | Label |
|---|---|---|---|
| merkle_path_nodes | MerklePathNode | The merkle path nodes. | repeated |
aelf.MerklePathNode¶
| Field | Type | Description | Label |
|---|---|---|---|
| hash | Hash | The node hash. | |
| is_left_child_node | bool | Whether it is a left child node. |
aelf.ScopedStatePath¶
| Field | Type | Description | Label |
|---|---|---|---|
| address | Address | The scope address, which will be the contract address. | |
| path | StatePath | The path of contract state. |
aelf.SmartContractRegistration¶
| Field | Type | Description | Label |
|---|---|---|---|
| category | sint32 | The category of contract code(0: C#). | |
| code | bytes | The byte array of the contract code. | |
| code_hash | Hash | The hash of the contract code. | |
| is_system_contract | bool | Whether it is a system contract. | |
| version | int32 | The version of the current contract. |
aelf.StatePath¶
| Field | Type | Description | Label |
|---|---|---|---|
| parts | string | The partial path of the state path. | repeated |
aelf.Transaction¶
| Field | Type | Description | Label |
|---|---|---|---|
| from | Address | The address of the sender of the transaction. | |
| to | Address | The address of the contract when calling a contract. | |
| ref_block_number | int64 | The height of the referenced block hash. | |
| ref_block_prefix | bytes | The first four bytes of the referenced block hash. | |
| method_name | string | The name of a method in the smart contract at the To address. | |
| params | bytes | The parameters to pass to the smart contract method. | |
| signature | bytes | When signing a transaction it’s actually a subset of the fields: from/to and the target method as well as the parameter that were given. It also contains the reference block number and prefix. |
aelf.TransactionExecutingStateSet¶
| Field | Type | Description | Label |
|---|---|---|---|
| writes | TransactionExecutingStateSet.WritesEntry | The changed states. | repeated |
| reads | TransactionExecutingStateSet.ReadsEntry | The read states. | repeated |
| deletes | TransactionExecutingStateSet.DeletesEntry | The deleted states. | repeated |
aelf.TransactionResult¶
| Field | Type | Description | Label |
|---|---|---|---|
| transaction_id | Hash | The transaction id. | |
| status | TransactionResultStatus | The transaction result status. | |
| logs | LogEvent | The log events. | repeated |
| bloom | bytes | Bloom filter for transaction logs. A transaction log event can be defined in the contract and stored in the bloom filter after the transaction is executed. Through this filter, we can quickly search for and determine whether a log exists in the transaction result. | |
| return_value | bytes | The return value of the transaction execution. | |
| block_number | int64 | The height of the block hat packages the transaction. | |
| block_hash | Hash | The hash of the block hat packages the transaction. | |
| error | string | Failed execution error message. |
aelf.TransactionResultStatus¶
| Name | Number | Description |
|---|---|---|
| NOT_EXISTED | 0 | The execution result of the transaction does not exist. |
| PENDING | 1 | The transaction is in the transaction pool waiting to be packaged. |
| FAILED | 2 | Transaction execution failed. |
| MINED | 3 | The transaction was successfully executed and successfully packaged into a block. |
| CONFLICT | 4 | When executed in parallel, there are conflicts with other transactions. |
| PENDING_VALIDATION | 5 | The transaction is waiting for validation. |
| NODE_VALIDATION_FAILED | 6 | Transaction validation failed. |
AuthorityInfo¶
| Field | Type | Description | Label |
|---|---|---|---|
| contract_address | aelf.Address | The contract address of the controller. | |
| owner_address | aelf.Address | The address of the owner of the contract. |