Bitshares-Core  2.0.181105
BitShares blockchain implementation and command-line interface software
Classes | Public Types | Public Member Functions | Public Attributes | List of all members
graphene::chain::account_whitelist_operation Struct Reference

This operation is used to whitelist and blacklist accounts, primarily for transacting in whitelisted assetsAccounts can freely specify opinions about other accounts, in the form of either whitelisting or blacklisting them. This information is used in chain validation only to determine whether an account is authorized to transact in an asset type which enforces a whitelist, but third parties can use this information for other uses as well, as long as it does not conflict with the use of whitelisted assets. More...

#include <account.hpp>

Inheritance diagram for graphene::chain::account_whitelist_operation:
graphene::chain::base_operation

Classes

struct  fee_parameters_type
 

Public Types

enum  account_listing { no_listing = 0x0, white_listed = 0x1, black_listed = 0x2, white_and_black_listed = white_listed | black_listed }
 

Public Member Functions

account_id_type fee_payer () const
 
void validate () const
 
- Public Member Functions inherited from graphene::chain::base_operation
template<typename T >
share_type calculate_fee (const T &params) const
 
void get_required_authorities (vector< authority > &) const
 
void get_required_active_authorities (flat_set< account_id_type > &) const
 
void get_required_owner_authorities (flat_set< account_id_type > &) const
 
void validate () const
 

Public Attributes

asset fee
 Paid by authorizing_account. More...
 
account_id_type authorizing_account
 The account which is specifying an opinion of another account. More...
 
account_id_type account_to_list
 The account being opined about. More...
 
uint8_t new_listing = no_listing
 
extensions_type extensions
 

Additional Inherited Members

- Static Public Member Functions inherited from graphene::chain::base_operation
static uint64_t calculate_data_fee (uint64_t bytes, uint64_t price_per_kbyte)
 

Detailed Description

This operation is used to whitelist and blacklist accounts, primarily for transacting in whitelisted assets

Accounts can freely specify opinions about other accounts, in the form of either whitelisting or blacklisting them. This information is used in chain validation only to determine whether an account is authorized to transact in an asset type which enforces a whitelist, but third parties can use this information for other uses as well, as long as it does not conflict with the use of whitelisted assets.

An asset which enforces a whitelist specifies a list of accounts to maintain its whitelist, and a list of accounts to maintain its blacklist. In order for a given account A to hold and transact in a whitelisted asset S, A must be whitelisted by at least one of S's whitelist_authorities and blacklisted by none of S's blacklist_authorities. If A receives a balance of S, and is later removed from the whitelist(s) which allowed it to hold S, or added to any blacklist S specifies as authoritative, A's balance of S will be frozen until A's authorization is reinstated.

This operation requires authorizing_account's signature, but not account_to_list's. The fee is paid by authorizing_account.

Definition at line 187 of file account.hpp.

Member Enumeration Documentation

◆ account_listing

Enumerator
no_listing 

No opinion is specified about this account.

white_listed 

This account is whitelisted, but not blacklisted.

black_listed 

This account is blacklisted, but not whitelisted.

white_and_black_listed 

This account is both whitelisted and blacklisted.

Definition at line 190 of file account.hpp.

Member Function Documentation

◆ fee_payer()

account_id_type graphene::chain::account_whitelist_operation::fee_payer ( ) const
inline

Definition at line 208 of file account.hpp.

◆ validate()

void graphene::chain::account_whitelist_operation::validate ( ) const
inline

Definition at line 209 of file account.hpp.

Member Data Documentation

◆ account_to_list

account_id_type graphene::chain::account_whitelist_operation::account_to_list

The account being opined about.

Definition at line 202 of file account.hpp.

◆ authorizing_account

account_id_type graphene::chain::account_whitelist_operation::authorizing_account

The account which is specifying an opinion of another account.

Definition at line 200 of file account.hpp.

◆ extensions

extensions_type graphene::chain::account_whitelist_operation::extensions

Definition at line 206 of file account.hpp.

◆ fee

asset graphene::chain::account_whitelist_operation::fee

Paid by authorizing_account.

Definition at line 198 of file account.hpp.

◆ new_listing

uint8_t graphene::chain::account_whitelist_operation::new_listing = no_listing

The new white and blacklist status of account_to_list, as determined by authorizing_account This is a bitfield using values defined in the account_listing enum

Definition at line 205 of file account.hpp.


The documentation for this struct was generated from the following file: