* Created unit test for #325
* remove needless find()
* issue - 154: Don't allow to vote when vesting balance is 0
* Increase block creation timeout to 2500ms
* increase delay for node connection
* remove cache from cli get_account
* add cli tests framework
* Adjust newly merged code to new API
* Merged changes from Bitshares PR 1036
* GRPH-76 - Short-cut long sequences of missed blocks
Fixes database::update_global_dynamic_data to speed up counting missed blocks.
(This also fixes a minor issue with counting - the previous algorithm would skip missed blocks for the witness who signed the first block after the gap.)
* Improved resilience of block database against corruption
* Moved reindex logic into database / chain_database, make use of additional blocks in block_database
Fixed tests wrt db.open
* Enable undo + fork database for final blocks in a replay
Dont remove blocks from block db when popping blocks, handle edge case in replay wrt fork_db, adapted unit tests
* Log starting block number of replay
* Prevent unsigned integer underflow
* Fixed lock detection
* Dont leave _data_dir empty if db is locked
* Writing the object_database is now almost atomic
* Improved consistency check for block_log
* Cut back block_log index file if inconsistent
* Fixed undo_database
* Added test case for broken merge on empty undo_db
* exclude second undo_db.enable() call in some cases
* Add missing change
* change bitshares to core in message
* Merge pull request #938 from bitshares/fix-block-storing
Store correct block ID when switching forks
* Fixed integer overflow issue
* Fix for for history ID mismatch ( Bitshares PR #875 )
* Update the FC submodule with the changes for GRPH-4
* Merged Bitshares PR #1462 and compilation fixes
* Support/gitlab (#123)
* Updated gitlab process
* Fix undefined references in cli test
* Updated GitLab CI
* Fix #436 object_database created outside of witness data directory
* supplement more comments on database::_opened variable
* prevent segfault when destructing application obj
* Fixed test failures and compilation issue
* minor performance improvement
* Added comment
* Fix compilation in debug mode
* Fixed duplicate ops returned from get_account_history
* Fixed account_history_pagination test
* Removed unrelated comment
* Update to fixed version of fc
* Skip auth check when pushing self-generated blocks
* Extract public keys before pushing a transaction
* Dereference chain_database shared_ptr
* Updated transaction::signees to mutable
and
* updated get_signature_keys() to return a const reference,
* get_signature_keys() will update signees on first call,
* modified test cases and wallet.cpp accordingly,
* no longer construct a new signed_transaction object before pushing
* Added get_asset_count API
* No longer extract public keys before pushing a trx
and removed unused new added constructor and _get_signature_keys() function from signed_transaction struct
* changes to withdraw_vesting feature(for both cdd and GPOS)
* Comments update
* update to GPOS hardfork ref
* Remove leftover comment from merge
* fix for get_vesting_balance API call
* braces update
* Allow sufficient space for new undo_session
* Throw for deep nesting
* node.cpp: Check the attacker/buggy client before updating items ids
The peer is an attacker or buggy, which means the item_hashes_received is
not correct.
Move the check before updating items ids to save some time in this case.
* Create .gitlab-ci.yml
* Added cli_test to CI
* fixing build errors (#150)
* fixing build errors
vest type correction
* fixing build errors
vest type correction
* fixes
new Dockerfile
* vesting_balance_type correction
vesting_balance_type changed to normal
* gcc5 support to Dockerfile
gcc5 support to Dockerfile
* use random port numbers in app_test (#154)
* Changes to compiple with GCC 7(Ubuntu 18.04)
* proposal fail_reason bug fixed (#157)
* Added Sonarcloud code_quality to CI (#159)
* Added sonarcloud analysis (#158)
* changes to have separate methods and single withdrawl fee for multiple vest objects
* 163-fix, Return only non-zero vesting balances
* Support/gitlab develop (#168)
* Added code_quality to CI
* Update .gitlab-ci.yml
* Point to PBSA/peerplays-fc commit f13d063 (#167)
* [GRPH-3] Additional cli tests (#155)
* Additional cli tests
* Compatible with latest fc changes
* Fixed Spacing issues
* [GRPH-106] Added voting tests (#136)
* Added more voting tests
* Added additional option
* Adjust p2p log level (#180)
* merge gpos to develop (#186)
* issue - 154: Don't allow to vote when vesting balance is 0
* changes to withdraw_vesting feature(for both cdd and GPOS)
* Comments update
* update to GPOS hardfork ref
* fix for get_vesting_balance API call
* braces update
* Create .gitlab-ci.yml
* fixing build errors (#150)
* fixing build errors
vest type correction
* fixing build errors
vest type correction
* fixes
new Dockerfile
* vesting_balance_type correction
vesting_balance_type changed to normal
* gcc5 support to Dockerfile
gcc5 support to Dockerfile
* Changes to compiple with GCC 7(Ubuntu 18.04)
* changes to have separate methods and single withdrawl fee for multiple vest objects
* 163-fix, Return only non-zero vesting balances
* Revert "Revert "GPOS protocol""
This reverts commit 67616417b7.
* add new line needed to gpos hardfork file
* comment temporally cli_vote_for_2_witnesses until refactor or delete
* fix gpos tests
* fix gitlab-ci conflict
* Fixed few error messages
* error message corrections at other places
* Updated FC repository to peerplays-network/peerplays-fc (#189)
Point to fc commit hash 6096e94 [latest-fc branch]
* Project name update in Doxyfile (#146)
* changes to allow user to vote in each sub-period
* Fixed GPOS vesting factor issue when proxy is set
* Added unit test for proxy voting
* Review changes
* changes to update last voting time
* resolve merge conflict
* unit test changes and also separated GPOS test suite
* delete unused variables
* removed witness check
* eliminate time gap between two consecutive vesting periods
* deleted GPOS specific test suite and updated gpos tests
* updated GPOS hf
* Fixed dividend distribution issue and added test case
* fix flag
* clean newlines gpos_tests
* adapt gpos_tests to changed flag
* Fix to roll in GPOS rules, carry votes from 6th sub-period
* check was already modified
* comments updated
* updated comments to the benefit of reviewer
* Added token symbol name in error messages
* Added token symbol name in error messages (#204)
* case 1: Fixed last voting time issue
* get_account bug fixed
* Fixed flag issue
* Fixed spelling issue
* remove non needed gcc5 changes to dockerfile
* GRPH134- High CPU Issue, websocket changes (#213)
* update submodule branch to refer to the latest commit on latest-fc branch (#214)
* Improve account maintenance performance (#130)
* Improve account maintenance performance
* merge fixes
* Fixed merge issue
* Fixed indentations and extra ';'
* Update CI for syncing gitmodules (#216)
* Added logging for the old update_expired_feeds bug
The old bug is https://github.com/cryptonomex/graphene/issues/615 .
Due to the bug, `update_median_feeds()` and `check_call_orders()`
will be called when a feed is not actually expired, normally this
should not affect consensus since calling them should not change
any data in the state.
However, the logging indicates that `check_call_orders()` did
change some data under certain circumstances, specifically, when
multiple limit order matching issue (#453) occurred at same block.
* https://github.com/bitshares/bitshares-core/issues/453
* Minor performance improvement for price::is_null()
* Use static refs in db_getter for immutable objects
* Minor performance improvement for db_maint
* Minor code updates for asset_evaluator.cpp
* changed an `assert()` to `FC_ASSERT()`
* replaced one `db.get(asset_id_type())` with `db.get_core_asset()`
* capture only required variables for lambda
* Improve update_expired_feeds performance #1093
* Change static refs to member pointers of db class
* Added getter for witness schedule object
* Added getter for core dynamic data object
* Use getters
* Removed unused variable
* Add comments for update_expired_feeds in db_block
* Minor refactory asset_create_evaluator::do_apply()
* Added FC_ASSERT for dynamic data id of core asset
* Added header inclusions in db_management.cpp
* fix global objects usage during replay
* Logging config parsing issue
* added new files
* compilation fix
* Simplified code in database::pay_workers()
* issue with withdrawl
* Added unit test for empty account history
* set extensions default values
* Update GPOS hardfork date and don't allow GPOS features before hardfork time
* refer to latest commit of latest-fc branch (#224)
* account name or id support in all database api
* asset id or name support in all asset APIs
* Fixed compilation issues
* Fixed alignment issues
* Externalized some API templates
* Externalize serialization of blocks, tx, ops
* Externalized db objects
* Externalized genesis serialization
* Externalized serialization in protocol library
* Undo superfluous change
* remove default value for extension parameter
* fix compilation issues
* GRPH-46-Quit_command_cliwallet
* removed multiple function definition
* Fixed chainparameter update proposal issue
* Move GPOS withdraw logic to have single transaction(also single fee) and update API
* Added log for authorization failure of proposal operations
* Votes consideration on GPOS activation
* bump fc version
* fix gpos tests
* Bump fc version
* Updated gpos/voting_tests
* Fixed withdraw vesting bug
* Added unit test
* Update hardfork date for TESTNET, sync fc module and update logs
* avoid wlog as it filling up space
* Beatrice hot fix(sync issue fix)
* gpos tests fix
* Set hardfork date to Jan5th on TESTNET
Co-authored-by: Peter Conrad <github.com@quisquis.de>
Co-authored-by: John M. Jones <jmjatlanta@gmail.com>
Co-authored-by: obucinac <obucinac@users.noreply.github.com>
Co-authored-by: Bobinson K B <bobinson@gmail.com>
Co-authored-by: Alfredo Garcia <oxarbitrage@gmail.com>
Co-authored-by: Miha Čančula <miha@noughmad.eu>
Co-authored-by: Abit <abitmore@users.noreply.github.com>
Co-authored-by: Roshan Syed <r.syed@pbsa.info>
Co-authored-by: Sandip Patel <sandip@knackroot.com>
Co-authored-by: RichardWeiYang <richard.weiyang@gmail.com>
Co-authored-by: gladcow <jahr@yandex.ru>
Co-authored-by: satyakoneru <satyakoneru.iiith@gmail.com>
327 lines
13 KiB
C++
327 lines
13 KiB
C++
/*
|
|
* Copyright (c) 2015 Cryptonomex, Inc., and contributors.
|
|
*
|
|
* The MIT License
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
#include <graphene/chain/account_object.hpp>
|
|
#include <graphene/chain/database.hpp>
|
|
|
|
#include <fc/io/raw.hpp>
|
|
#include <fc/uint128.hpp>
|
|
|
|
namespace graphene { namespace chain {
|
|
|
|
share_type cut_fee(share_type a, uint16_t p)
|
|
{
|
|
if( a == 0 || p == 0 )
|
|
return 0;
|
|
if( p == GRAPHENE_100_PERCENT )
|
|
return a;
|
|
|
|
fc::uint128 r(a.value);
|
|
r *= p;
|
|
r /= GRAPHENE_100_PERCENT;
|
|
return r.to_uint64();
|
|
}
|
|
|
|
void account_balance_object::adjust_balance(const asset& delta)
|
|
{
|
|
assert(delta.asset_id == asset_type);
|
|
balance += delta.amount;
|
|
if( asset_type == asset_id_type() ) // CORE asset
|
|
maintenance_flag = true;
|
|
}
|
|
|
|
void account_statistics_object::process_fees(const account_object& a, database& d) const
|
|
{
|
|
if( pending_fees > 0 || pending_vested_fees > 0 )
|
|
{
|
|
auto pay_out_fees = [&](const account_object& account, share_type core_fee_total, bool require_vesting)
|
|
{
|
|
// Check the referrer -- if he's no longer a member, pay to the lifetime referrer instead.
|
|
// No need to check the registrar; registrars are required to be lifetime members.
|
|
if( account.referrer(d).is_basic_account(d.head_block_time()) )
|
|
d.modify( account, [](account_object& acc) {
|
|
acc.referrer = acc.lifetime_referrer;
|
|
});
|
|
|
|
share_type network_cut = cut_fee(core_fee_total, account.network_fee_percentage);
|
|
assert( network_cut <= core_fee_total );
|
|
|
|
#ifndef NDEBUG
|
|
const auto& props = d.get_global_properties();
|
|
|
|
share_type reserveed = cut_fee(network_cut, props.parameters.reserve_percent_of_fee);
|
|
share_type accumulated = network_cut - reserveed;
|
|
assert( accumulated + reserveed == network_cut );
|
|
#endif
|
|
share_type lifetime_cut = cut_fee(core_fee_total, account.lifetime_referrer_fee_percentage);
|
|
share_type referral = core_fee_total - network_cut - lifetime_cut;
|
|
|
|
d.modify( d.get_core_dynamic_data(), [network_cut](asset_dynamic_data_object& addo) {
|
|
addo.accumulated_fees += network_cut;
|
|
});
|
|
|
|
// Potential optimization: Skip some of this math and object lookups by special casing on the account type.
|
|
// For example, if the account is a lifetime member, we can skip all this and just deposit the referral to
|
|
// it directly.
|
|
share_type referrer_cut = cut_fee(referral, account.referrer_rewards_percentage);
|
|
share_type registrar_cut = referral - referrer_cut;
|
|
|
|
d.deposit_cashback(d.get(account.lifetime_referrer), lifetime_cut, require_vesting);
|
|
d.deposit_cashback(d.get(account.referrer), referrer_cut, require_vesting);
|
|
d.deposit_cashback(d.get(account.registrar), registrar_cut, require_vesting);
|
|
|
|
assert( referrer_cut + registrar_cut + accumulated + reserveed + lifetime_cut == core_fee_total );
|
|
};
|
|
|
|
pay_out_fees(a, pending_fees, true);
|
|
pay_out_fees(a, pending_vested_fees, false);
|
|
|
|
d.modify(*this, [&](account_statistics_object& s) {
|
|
s.lifetime_fees_paid += pending_fees + pending_vested_fees;
|
|
s.pending_fees = 0;
|
|
s.pending_vested_fees = 0;
|
|
});
|
|
}
|
|
}
|
|
|
|
void account_statistics_object::pay_fee( share_type core_fee, share_type cashback_vesting_threshold )
|
|
{
|
|
if( core_fee > cashback_vesting_threshold )
|
|
pending_fees += core_fee;
|
|
else
|
|
pending_vested_fees += core_fee;
|
|
}
|
|
|
|
set<account_id_type> account_member_index::get_account_members(const account_object& a)const
|
|
{
|
|
set<account_id_type> result;
|
|
for( auto auth : a.owner.account_auths )
|
|
result.insert(auth.first);
|
|
for( auto auth : a.active.account_auths )
|
|
result.insert(auth.first);
|
|
return result;
|
|
}
|
|
set<public_key_type, account_member_index::key_compare> account_member_index::get_key_members(const account_object& a)const
|
|
{
|
|
set<public_key_type, key_compare> result;
|
|
for( auto auth : a.owner.key_auths )
|
|
result.insert(auth.first);
|
|
for( auto auth : a.active.key_auths )
|
|
result.insert(auth.first);
|
|
result.insert( a.options.memo_key );
|
|
return result;
|
|
}
|
|
set<address> account_member_index::get_address_members(const account_object& a)const
|
|
{
|
|
set<address> result;
|
|
for( auto auth : a.owner.address_auths )
|
|
result.insert(auth.first);
|
|
for( auto auth : a.active.address_auths )
|
|
result.insert(auth.first);
|
|
result.insert( a.options.memo_key );
|
|
return result;
|
|
}
|
|
|
|
void account_member_index::object_inserted(const object& obj)
|
|
{
|
|
assert( dynamic_cast<const account_object*>(&obj) ); // for debug only
|
|
const account_object& a = static_cast<const account_object&>(obj);
|
|
|
|
auto account_members = get_account_members(a);
|
|
for( auto item : account_members )
|
|
account_to_account_memberships[item].insert(obj.id);
|
|
|
|
auto key_members = get_key_members(a);
|
|
for( auto item : key_members )
|
|
account_to_key_memberships[item].insert(obj.id);
|
|
|
|
auto address_members = get_address_members(a);
|
|
for( auto item : address_members )
|
|
account_to_address_memberships[item].insert(obj.id);
|
|
}
|
|
|
|
void account_member_index::object_removed(const object& obj)
|
|
{
|
|
assert( dynamic_cast<const account_object*>(&obj) ); // for debug only
|
|
const account_object& a = static_cast<const account_object&>(obj);
|
|
|
|
auto key_members = get_key_members(a);
|
|
for( auto item : key_members )
|
|
account_to_key_memberships[item].erase( obj.id );
|
|
|
|
auto address_members = get_address_members(a);
|
|
for( auto item : address_members )
|
|
account_to_address_memberships[item].erase( obj.id );
|
|
|
|
auto account_members = get_account_members(a);
|
|
for( auto item : account_members )
|
|
account_to_account_memberships[item].erase( obj.id );
|
|
}
|
|
|
|
void account_member_index::about_to_modify(const object& before)
|
|
{
|
|
before_key_members.clear();
|
|
before_account_members.clear();
|
|
assert( dynamic_cast<const account_object*>(&before) ); // for debug only
|
|
const account_object& a = static_cast<const account_object&>(before);
|
|
before_key_members = get_key_members(a);
|
|
before_address_members = get_address_members(a);
|
|
before_account_members = get_account_members(a);
|
|
}
|
|
|
|
void account_member_index::object_modified(const object& after)
|
|
{
|
|
assert( dynamic_cast<const account_object*>(&after) ); // for debug only
|
|
const account_object& a = static_cast<const account_object&>(after);
|
|
|
|
{
|
|
set<account_id_type> after_account_members = get_account_members(a);
|
|
vector<account_id_type> removed; removed.reserve(before_account_members.size());
|
|
std::set_difference(before_account_members.begin(), before_account_members.end(),
|
|
after_account_members.begin(), after_account_members.end(),
|
|
std::inserter(removed, removed.end()));
|
|
|
|
for( auto itr = removed.begin(); itr != removed.end(); ++itr )
|
|
account_to_account_memberships[*itr].erase(after.id);
|
|
|
|
vector<object_id_type> added; added.reserve(after_account_members.size());
|
|
std::set_difference(after_account_members.begin(), after_account_members.end(),
|
|
before_account_members.begin(), before_account_members.end(),
|
|
std::inserter(added, added.end()));
|
|
|
|
for( auto itr = added.begin(); itr != added.end(); ++itr )
|
|
account_to_account_memberships[*itr].insert(after.id);
|
|
}
|
|
|
|
|
|
{
|
|
set<public_key_type, key_compare> after_key_members = get_key_members(a);
|
|
|
|
vector<public_key_type> removed; removed.reserve(before_key_members.size());
|
|
std::set_difference(before_key_members.begin(), before_key_members.end(),
|
|
after_key_members.begin(), after_key_members.end(),
|
|
std::inserter(removed, removed.end()));
|
|
|
|
for( auto itr = removed.begin(); itr != removed.end(); ++itr )
|
|
account_to_key_memberships[*itr].erase(after.id);
|
|
|
|
vector<public_key_type> added; added.reserve(after_key_members.size());
|
|
std::set_difference(after_key_members.begin(), after_key_members.end(),
|
|
before_key_members.begin(), before_key_members.end(),
|
|
std::inserter(added, added.end()));
|
|
|
|
for( auto itr = added.begin(); itr != added.end(); ++itr )
|
|
account_to_key_memberships[*itr].insert(after.id);
|
|
}
|
|
|
|
{
|
|
set<address> after_address_members = get_address_members(a);
|
|
|
|
vector<address> removed; removed.reserve(before_address_members.size());
|
|
std::set_difference(before_address_members.begin(), before_address_members.end(),
|
|
after_address_members.begin(), after_address_members.end(),
|
|
std::inserter(removed, removed.end()));
|
|
|
|
for( auto itr = removed.begin(); itr != removed.end(); ++itr )
|
|
account_to_address_memberships[*itr].erase(after.id);
|
|
|
|
vector<address> added; added.reserve(after_address_members.size());
|
|
std::set_difference(after_address_members.begin(), after_address_members.end(),
|
|
before_address_members.begin(), before_address_members.end(),
|
|
std::inserter(added, added.end()));
|
|
|
|
for( auto itr = added.begin(); itr != added.end(); ++itr )
|
|
account_to_address_memberships[*itr].insert(after.id);
|
|
}
|
|
|
|
}
|
|
|
|
void account_referrer_index::object_inserted( const object& obj )
|
|
{
|
|
}
|
|
void account_referrer_index::object_removed( const object& obj )
|
|
{
|
|
}
|
|
void account_referrer_index::about_to_modify( const object& before )
|
|
{
|
|
}
|
|
void account_referrer_index::object_modified( const object& after )
|
|
{
|
|
}
|
|
|
|
const uint8_t balances_by_account_index::bits = 20;
|
|
const uint64_t balances_by_account_index::mask = (1ULL << balances_by_account_index::bits) - 1;
|
|
|
|
void balances_by_account_index::object_inserted( const object& obj )
|
|
{
|
|
const auto& abo = dynamic_cast< const account_balance_object& >( obj );
|
|
while( balances.size() < (abo.owner.instance.value >> bits) + 1 )
|
|
{
|
|
balances.reserve( (abo.owner.instance.value >> bits) + 1 );
|
|
balances.resize( balances.size() + 1 );
|
|
balances.back().resize( 1ULL << bits );
|
|
}
|
|
balances[abo.owner.instance.value >> bits][abo.owner.instance.value & mask][abo.asset_type] = &abo;
|
|
}
|
|
|
|
void balances_by_account_index::object_removed( const object& obj )
|
|
{
|
|
const auto& abo = dynamic_cast< const account_balance_object& >( obj );
|
|
if( balances.size() < (abo.owner.instance.value >> bits) + 1 ) return;
|
|
balances[abo.owner.instance.value >> bits][abo.owner.instance.value & mask].erase( abo.asset_type );
|
|
}
|
|
|
|
void balances_by_account_index::about_to_modify( const object& before )
|
|
{
|
|
ids_being_modified.emplace( before.id );
|
|
}
|
|
|
|
void balances_by_account_index::object_modified( const object& after )
|
|
{
|
|
FC_ASSERT( ids_being_modified.top() == after.id, "Modification of ID is not supported!");
|
|
ids_being_modified.pop();
|
|
}
|
|
|
|
const map< asset_id_type, const account_balance_object* >& balances_by_account_index::get_account_balances( const account_id_type& acct )const
|
|
{
|
|
static const map< asset_id_type, const account_balance_object* > _empty;
|
|
|
|
if( balances.size() < (acct.instance.value >> bits) + 1 ) return _empty;
|
|
return balances[acct.instance.value >> bits][acct.instance.value & mask];
|
|
}
|
|
|
|
const account_balance_object* balances_by_account_index::get_account_balance( const account_id_type& acct, const asset_id_type& asset )const
|
|
{
|
|
if( balances.size() < (acct.instance.value >> bits) + 1 ) return nullptr;
|
|
const auto& mine = balances[acct.instance.value >> bits][acct.instance.value & mask];
|
|
const auto itr = mine.find( asset );
|
|
if( mine.end() == itr ) return nullptr;
|
|
return itr->second;
|
|
}
|
|
|
|
} } // graphene::chain
|
|
|
|
GRAPHENE_EXTERNAL_SERIALIZATION( /*not extern*/, graphene::chain::account_object )
|
|
GRAPHENE_EXTERNAL_SERIALIZATION( /*not extern*/, graphene::chain::account_balance_object )
|
|
GRAPHENE_EXTERNAL_SERIALIZATION( /*not extern*/, graphene::chain::account_statistics_object )
|
|
GRAPHENE_EXTERNAL_SERIALIZATION( /*not extern*/, graphene::chain::pending_dividend_payout_balance_for_holder_object )
|