From 8b9e8b9618e764d9bb2ebd9037fa52ecd643a86f Mon Sep 17 00:00:00 2001 From: vlbos <45447465+vlbos@users.noreply.github.com> Date: Fri, 1 Mar 2019 00:11:20 +0800 Subject: [PATCH] Release/v2.0.x (#46) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * state history plugin * bump version to 1.5.0-rc1 * Update README to reflect new package names * Change from 1.5.0 to 1.5.0-rc1 * Fix requires in spec file to resolve dependency resolution issues with rpms * Fix requires in spec file to resolve dependency resolution issues with rpms * Remove unneeded req_trx vector * Remove needless copy of signed_block. Only create pending_notify if needed. * Remove unused blk_buffer * separate out version suffix so that RPM packages produce an acceptable specfile * address PR review feedback * Make signed_block copy constructor private to avoid accidental copies. * add release suffix to doxygen cmake module * move signed_block instead of making copy * Avoid copy constructor for push_block * add release suffix to EOSIO_VERSION in tester cmake modules * Add which comment * Update tests for private signed_block copy constructor * Avoid making copies of signed_block * export the new bash vars * Use rvalue for signed_block * Update buildkite pipeline to use new queues * Update buildkite pipeline to use new queues * Special case msg_handler visit of signed_block to avoid hidden move from net_message * pass along trigger_send * Use move for rvalue * Added Mongo History API link * Added ZMQ Light History API * Added Chintai ZMQ Watcher * Added State History API * Stop the unix_server from listening in shutdown stage as well. * finish BOS basic functions * bump version to rc2 * update rpm names to match the real files * Fix deb package names in README * Fix package naming scheme for debs * Update LICENSE path * add a test that reduces the size of the producer set to validate that it does not create protocol level issues * promote rc2 to release * add missing release to deb packages * remove x86_64 arch dep specification on AMI2 build script I can't find any reason we need to explcitly request the x86_64 versions of packages for AMI2. Removing this apparently extraneous specification makes the build script "just work" on new ARM8 instances * Use 64-bit float printing of 128-bit floats on non x86_64 For platforms other then x86_64, have the 128-bit float console print API (printqf()) convert to a 64-bit float before printing. While this loses precision it’s enough to get the unit tests for printqf() working on ARM8, which actually was the only unit_test unit test that failed on that platform. * prebump to 1.6.0 and add develop suffix * Do not broadcast block if peer lib is larger than block number * Provide more efficient sha256_less * Simply by removing unused large_msg_notify * Remove unused node_transaction_state.packed_txn * Store serialized transaction as shared_ptr to minimize copies * Not possible for serialized_txn to be empty * Remove find_plugin overhead * Minimize shared_ptr copies * Use sha256_less for all sets/maps with ids * Add explicit constructors * Add accept_transaction that takes a packed_transaction_ptr to avoid copy * Pass id and packed_transaction by const& since never moved * Remove copy assignment operator. Remove used std::move. * Minimize packed_transaction copies. Store packed_transaction_ptr in transaction_metadata. * Cache chain_plugin lookup * Update tester for transaction_metadata packed_transaction_ptr * Remove packed_tansaction to net_message copy * Remove unused constructor * Explicitly disable copy/move construction * Remove inflight update of node_transaction_state as it is not needed * Remove connections for unused signals that only logged * Fix sync check for lib * add a test that verifies proposing an empty producer schedule does not break things * Allow disablement of net_plugin's listen socket Disable net_plugin's listen socket when p2p-listen-endpoint is empty. This is useful for security and for an easier way of running multiple nodeos without it conflicting when you don't actually need to service incoming connections. * More descriptive memo to distinguish from other transfers * Revert "Fix sync check for lib" This reverts commit 52a6f193aa3a06833165fc36d3a52407769c732f. * Update the bios-boot-tutorial.py script and readme.md: 1. args.contracts_dir doesn't end in a forward slash, therefor when it is concatenated with a subpath, the subpath has to start with a forward slash; this pattern is present in other similar variables as well 2. system contract has to be initialized before it can be used (e.g. creating staked acconts) 3. commands list updated to include the new addition stepInitSystemContract 4. readme.md updated as well to reflect the current status of the script and requirements * Release/1.0.x (#11) * boscore basic improvement (#2) * kafka_plugin code * Automatic installation librdkafka/cppkafka * Feature/ci * Feature/48 kafka plugin * add CMakeModules/FindCppkafka.cmake * Production of block in time zone sequence * P2p self discovery * P2p self discovery * add notify_plugin * add api "get_block_detail" * add free res limit and blklst code * update free res limit and blklst code * update res code * update unittest code * revert submodule version * code typo * update blklist code * update sync name list db object error code * update code * update index code * Feature/5 ramdom * Revert "Merge branch 'feature/5-ramdom' into 'develop'" This reverts merge request !8 * adjust for setup BOSCore * change description * adjust the kafka plugin dependency be more special * use boscore repository to improve security * change version tag * finish for docker/builder * pass to build docker and update readme * add actionseed, global action sequence (#5) * delete renamed old file * BOSCore v1.0.1-1.4.3 * restructure the version schema * fix __gmpn_set_str error when build bos.contract * prepare for the v1.0.1 * add README files * update info * readme for kafka & add time for action (#5) * 重启 节点,黑名单 失效，fixes #7 (#8) * restart sync list db * recovery system account bos to eosio * recovery system account bos to eosio * recovery system account bos to eosio * Fix/#3 notify plugin (#10) * Add debug info * comment log * rm log for notify_plugin * README.md refactored - correcting spelling errors, and caps - better bash commands - simpler command line to launch the script - improved prerequisites - include steps to follow after prerequisites * Correct typos * Correct link format * Add eosio.cdt steps * merge v1.0.2 (#13) * boscore basic improvement (#2) * kafka_plugin code * Automatic installation librdkafka/cppkafka * Feature/ci * Feature/48 kafka plugin * add CMakeModules/FindCppkafka.cmake * Production of block in time zone sequence * P2p self discovery * P2p self discovery * add notify_plugin * add api "get_block_detail" * add free res limit and blklst code * update free res limit and blklst code * update res code * update unittest code * revert submodule version * code typo * update blklist code * update sync name list db object error code * update code * update index code * Feature/5 ramdom * Revert "Merge branch 'feature/5-ramdom' into 'develop'" This reverts merge request !8 * adjust for setup BOSCore * change description * adjust the kafka plugin dependency be more special * use boscore repository to improve security * change version tag * finish for docker/builder * pass to build docker and update readme * add actionseed, global action sequence (#5) * delete renamed old file * BOSCore v1.0.1-1.4.3 * restructure the version schema * fix __gmpn_set_str error when build bos.contract * prepare for the v1.0.1 * add README files * update info * prepare for v1.0.2 * Better name for eosio contracts directory * dummy checkin to trigger another build * Added scrit to support recursive search for files with FC_REFLECT or FC_REFLECT_ENUM to verify order and completeness. Supports comments with @swap to support different order from definition and @ignore to ignore a specific field for reflection. Still need to support FC_REFLECT_DERIVED. GH #3127 * Added @ignore comment for field that is left out of reflect definition. GH #3127 * Fixed pull request comments. * bump version to 1.5.1 * Consolidated Security Fixes for 1.5.1 - Only allow authorizations that are satisfiable by `eosio.code` for self-addressed deferred transactions - Only allow authorizations that are satisfiable by `eosio.code` OR on the parent action for self-addressed inline actions sent from direct actions - Only allow authorizations that are satisfiable by `eosio.code` for self-addressed inline actions sent from recipient handlers Co-authored-by: arhag Co-authored-by: Bart Wyatt * Peer review changes. Fix move. * Spelling correction * Spelling correction #2 * Remove unused max-implicit-request config * Switch interface from packed_transaction_ptr to transaction_metadata_ptr * Thread pool does not need to be optional * Add transaction_metadata create_signing_keys_future method * Start transaction signature earily in thread pool * Refactor packed_transaction for better encapsulation * Add transaction_metadata create_signing_keys_future method * Start transaction signature earily in thread pool * Update txn_test_gen_plugin to overlap transaction submit @taokayan * merge 1.0.3 to develop (#16) * boscore basic improvement (#2) * kafka_plugin code * Automatic installation librdkafka/cppkafka * Feature/ci * Feature/48 kafka plugin * add CMakeModules/FindCppkafka.cmake * Production of block in time zone sequence * P2p self discovery * P2p self discovery * add notify_plugin * add api "get_block_detail" * add free res limit and blklst code * update free res limit and blklst code * update res code * update unittest code * revert submodule version * code typo * update blklist code * update sync name list db object error code * update code * update index code * Feature/5 ramdom * Revert "Merge branch 'feature/5-ramdom' into 'develop'" This reverts merge request !8 * adjust for setup BOSCore * change description * adjust the kafka plugin dependency be more special * use boscore repository to improve security * change version tag * finish for docker/builder * pass to build docker and update readme * add actionseed, global action sequence (#5) * delete renamed old file * BOSCore v1.0.1-1.4.3 * restructure the version schema * fix __gmpn_set_str error when build bos.contract * prepare for the v1.0.1 * add README files * update info * prepare for v1.0.2 * merge v1.0.2 (#12) * boscore basic improvement (#2) * kafka_plugin code * Automatic installation librdkafka/cppkafka * Feature/ci * Feature/48 kafka plugin * add CMakeModules/FindCppkafka.cmake * Production of block in time zone sequence * P2p self discovery * P2p self discovery * add notify_plugin * add api "get_block_detail" * add free res limit and blklst code * update free res limit and blklst code * update res code * update unittest code * revert submodule version * code typo * update blklist code * update sync name list db object error code * update code * update index code * Feature/5 ramdom * Revert "Merge branch 'feature/5-ramdom' into 'develop'" This reverts merge request !8 * adjust for setup BOSCore * change description * adjust the kafka plugin dependency be more special * use boscore repository to improve security * change version tag * finish for docker/builder * pass to build docker and update readme * add actionseed, global action sequence (#5) * delete renamed old file * BOSCore v1.0.1-1.4.3 * restructure the version schema * fix __gmpn_set_str error when build bos.contract * prepare for the v1.0.1 * finish BOS basic functions * add README files * update info * Release/1.0.x (#11) * boscore basic improvement (#2) * kafka_plugin code * Automatic installation librdkafka/cppkafka * Feature/ci * Feature/48 kafka plugin * add CMakeModules/FindCppkafka.cmake * Production of block in time zone sequence * P2p self discovery * P2p self discovery * add notify_plugin * add api "get_block_detail" * add free res limit and blklst code * update free res limit and blklst code * update res code * update unittest code * revert submodule version * code typo * update blklist code * update sync name list db object error code * update code * update index code * Feature/5 ramdom * Revert "Merge branch 'feature/5-ramdom' into 'develop'" This reverts merge request !8 * adjust for setup BOSCore * change description * adjust the kafka plugin dependency be more special * use boscore repository to improve security * change version tag * finish for docker/builder * pass to build docker and update readme * add actionseed, global action sequence (#5) * delete renamed old file * BOSCore v1.0.1-1.4.3 * restructure the version schema * fix __gmpn_set_str error when build bos.contract * prepare for the v1.0.1 * add README files * update info * readme for kafka & add time for action (#5) * 重启 节点,黑名单 失效，fixes #7 (#8) * restart sync list db * recovery system account bos to eosio * recovery system account bos to eosio * recovery system account bos to eosio * Fix/#3 notify plugin (#10) * Add debug info * comment log * rm log for notify_plugin * prepare for v1.0.2 * patch the EOSIO 1.5.1 security bug fixes * prepare for v1.0.3 * adjust the slogon * Remove redundant signing_keys check * state history plugin: permission_object bug #6495 * Add deadline to key recovery * Modify producer_plugin to have its own thead_pool instead of using chain-threads * Move thread_pool join/stop to plugin shutdown so that they are joined before application quit * Fix signature future deadline from starting too early * Fix overflow of deadline and deadline check * initial setup of billing CPU for signatures recovered earlier * Return 400 on get_block with uonexist block number. For issue 6374 * has_contract() : Determine whether to deploy the contract (#18) * fix issue 5488 * Fix comments and function names (#19) * Add action_trace.block_num index. Remove action_trace.trx_id index. * Fix return codes of build scripts so that buildkite can fail properly * Make recovery cache non-thread local and guard by mutex * Calculate cpu usage of signature recovery * Add signature-cpu-billable-pct option to chain_plugin * Add missing include of mutex * Assert signature-cpu-billable-pct is 0-100 * Fix capture of cpu_usage. move flat_set into attribute * clear recovered_pub_keys to preserve previous behaviour * use `assign` instead of `resize`+`memcpy` to update `shared_blob` data Co-Authored-By: Kayan * Add move into tuple creation * bump version to 1.6.0-rc1 * add explicitly defaulted move semantics * Store unpacked_trx as signed_transaction * get_uncached_id no longer needed for thread safety * get_raw_transaction no longer needed for thread safety * Remove cached signed_transaction since now cached in packed_transaction * Test should honor existing compression * Cleanup of packed_transaction interface. Fixes for comments on PR #6471 * Update to fc with unpack verify * fc renamed reflector_verify to reflector_init * bump version to 1.5.2 * Update to latest fc with updated verify_init * Consolidated Security Fixes for 1.5.3 - Add missing implementation of dtor, copy ctor, etc for blob_types of fc::variant Co-Authored-By: Matt Witherspoon <32485495+spoonincode@users.noreply.github.com> * bump version to 1.5.3 * bump version to 1.6.0-rc2 * Consolidated Security Fixes for 1.6.0-rc2 - Add missing implementation of dtor, copy ctor, etc for blob_types of fc::variant Co-Authored-By: Matt Witherspoon <32485495+spoonincode@users.noreply.github.com> * update developer portal link update the getting started link to the latest version * fix tag version typo of cppkafka (#24) * get_contract_code (#26) * fixed #20Using greylist-account while starting nodeos for the first time throws exception (#23) * restart sync list db * recovery system account bos to eosio * catch exception plugin initialize sync list before initialize database * fixed 'cleos system bidname info' cmd exec return could not parse uint64_t (#30) * recovery system account bos to eosio * catch exception plugin initialize sync list before initialize database * fixed bidnameinfo could not parse uint64_t * prepare for 2.0.1 * adjust the location paramater * apply 1.5.3 patch * modify the location type * fix cmake error * Use https url for wabt submodule A user agent that doesn't respect hsts could potentially be coerced into downloading malicious sources for wabt via a mitm attack. Prevent this by using a https upstream like the other submodules already do * Add libtinfo5 dependency to deb package. Resolves #6590 Also clean up unused variables and force control directory permissions to comply with Debian specifications regardless of umask. * fix aragument name error * Bump version to 1.6.0 * Consolidated Security Fixes for 1.6.0 - Force compilation support for c++ exceptions for the wabt submodule - Allow limiting the time a node will spend processing scheduled transactions Co-Authored-By: Matt Witherspoon <32485495+spoonincode@users.noreply.github.com> Co-Authored-By: Bart Wyatt * Consolidated Security Fixes for 1.6.1 - net_plugin security fixes - Additional checktime calls to limit cpu usage - Limit memory usage in producer_plugin Co-Authored-By: Kevin Heifner Co-Authored-By: Matt Witherspoon <32485495+spoonincode@users.noreply.github.com> Co-authored-by: Kayan * Bump version to 1.6.1 * Fix boost 1.67 brew install The latest homebrew code balks at something in the old 1.67 package file. Fix the package file and store it locally in our repo for now. We try and pin the boost version because boost upgrades invalidate nodeos data files. * Set proper directory for baked in macOS LLVM_DIR Some users (including myself) were seeing llvm@4 unpacked to 4.0.1_1 instead of 4.0.1. Stuff unpacked to the Cellar directory appears to be a kind of implementation detail — /usr/local/opt is the proper place to reference here. * Add bk step to gather brew files for automatic update * Update version to 1.6.2 * add noninteractive option for build scripts * Limit assert message to 1024 chars * Don't unlink what we install via brew unlinking eveything we install makes no sense -- it means things like cmake aren't in the path any longer like the script expects. So don't do that any more. Unfortuately this old script requires that gettext be force linked. So implement that behavior explictly for now * Make sure python-devel is installed for amazon linux builds * fc version 1.6.x * merge missed code * merge missed code * merge missed code * prepare v2.0.2 --- .buildkite/pipeline.yml | 17 + .gitmodules | 2 +- CMakeLists.txt | 4 +- Docker/README.md | 6 +- Docker/config.ini | 3 - README.md | 14 +- README_CN.md | 14 +- contracts/asserter/asserter.cpp | 2 +- contracts/asserter/asserter.hpp | 2 +- contracts/eosio.system/delegate_bandwidth.cpp | 2 +- contracts/eosio.system/eosio.system.hpp | 2 +- contracts/eosio.system/native.hpp | 2 +- contracts/eosio.system/voting.cpp | 2 +- contracts/eosio.token/eosio.token.cpp | 2 +- contracts/eosio.token/eosio.token.hpp | 2 +- contracts/eosiolib/action.h | 2 +- contracts/eosiolib/action.hpp | 2 +- contracts/eosiolib/chain.h | 2 +- contracts/eosiolib/compiler_builtins.h | 2 +- contracts/eosiolib/core_symbol.hpp.in | 2 +- contracts/eosiolib/crypto.h | 2 +- contracts/eosiolib/datastream.hpp | 2 +- contracts/eosiolib/db.h | 2 +- contracts/eosiolib/eosio.hpp | 2 +- contracts/eosiolib/fixed_key.hpp | 2 +- contracts/eosiolib/memory.h | 2 +- contracts/eosiolib/memory.hpp | 2 +- contracts/eosiolib/multi_index.hpp | 2 +- contracts/eosiolib/permission.h | 2 +- contracts/eosiolib/permission.hpp | 2 +- contracts/eosiolib/print.h | 2 +- contracts/eosiolib/print.hpp | 2 +- contracts/eosiolib/system.h | 2 +- contracts/eosiolib/transaction.h | 2 +- contracts/eosiolib/transaction.hpp | 2 +- contracts/eosiolib/types.h | 2 +- contracts/eosiolib/types.hpp | 2 +- contracts/eosiolib/varint.hpp | 2 +- contracts/noop/noop.cpp | 2 +- contracts/proxy/proxy.cpp | 2 +- contracts/proxy/proxy.hpp | 2 +- contracts/skeleton/skeleton.hpp | 2 +- contracts/stltest/stltest.cpp | 2 +- contracts/test_api/test_action.cpp | 2 +- contracts/test_api/test_api.cpp | 2 +- contracts/test_api/test_api.hpp | 2 +- contracts/test_api/test_api_common.hpp | 2 +- contracts/test_api/test_chain.cpp | 2 +- contracts/test_api/test_checktime.cpp | 2 +- contracts/test_api/test_compiler_builtins.cpp | 2 +- contracts/test_api/test_crypto.cpp | 2 +- contracts/test_api/test_permission.cpp | 2 +- contracts/test_api/test_print.cpp | 2 +- contracts/test_api/test_transaction.cpp | 2 +- contracts/test_api/test_types.cpp | 2 +- contracts/test_api_db/test_api_db.cpp | 2 +- contracts/test_api_mem/test_api_mem.cpp | 2 +- contracts/test_api_mem/test_memory.cpp | 2 +- .../test_api_multi_index.cpp | 2 +- contracts/test_ram_limit/test_ram_limit.cpp | 2 +- contracts/tic_tac_toe/tic_tac_toe.cpp | 2 +- contracts/tic_tac_toe/tic_tac_toe.hpp | 2 +- eosio_build.sh | 13 +- images/bos-workflow.png | Bin 0 -> 437365 bytes libraries/CMakeLists.txt | 3 +- libraries/chain/CMakeLists.txt | 2 +- libraries/chain/abi_serializer.cpp | 2 +- libraries/chain/apply_context.cpp | 6 +- libraries/chain/asset.cpp | 2 +- libraries/chain/authorization_manager.cpp | 2 +- libraries/chain/block_header.cpp | 2 +- libraries/chain/block_log.cpp | 4 +- libraries/chain/chain_config.cpp | 2 +- libraries/chain/chain_id_type.cpp | 4 +- libraries/chain/controller.cpp | 109 +- libraries/chain/eosio_contract.cpp | 19 +- libraries/chain/genesis_state.cpp | 2 +- libraries/chain/genesis_state_root_key.cpp.in | 2 +- .../chain/include/eosio/chain/abi_def.hpp | 2 +- .../include/eosio/chain/abi_serializer.hpp | 64 +- .../include/eosio/chain/account_object.hpp | 2 +- .../chain/include/eosio/chain/action.hpp | 2 +- .../include/eosio/chain/action_receipt.hpp | 2 +- .../include/eosio/chain/apply_context.hpp | 2 +- libraries/chain/include/eosio/chain/asset.hpp | 4 +- .../chain/include/eosio/chain/authority.hpp | 2 +- .../include/eosio/chain/authority_checker.hpp | 2 +- .../eosio/chain/authorization_manager.hpp | 2 +- libraries/chain/include/eosio/chain/block.hpp | 17 +- .../chain/include/eosio/chain/block_log.hpp | 2 +- .../chain/include/eosio/chain/block_state.hpp | 2 +- .../eosio/chain/block_summary_object.hpp | 2 +- .../include/eosio/chain/chain_config.hpp | 2 +- .../include/eosio/chain/chain_id_type.hpp | 4 +- .../include/eosio/chain/chain_snapshot.hpp | 2 +- .../chain/include/eosio/chain/config.hpp | 3 +- .../eosio/chain/contract_table_objects.hpp | 2 +- .../chain/include/eosio/chain/controller.hpp | 27 +- .../include/eosio/chain/core_symbol.hpp.in | 2 +- .../include/eosio/chain/database_utils.hpp | 2 +- .../include/eosio/chain/eosio_contract.hpp | 2 +- .../chain/include/eosio/chain/exceptions.hpp | 2 +- .../chain/include/eosio/chain/fixed_key.hpp | 2 +- .../chain/generated_transaction_object.hpp | 2 +- .../include/eosio/chain/genesis_state.hpp | 2 +- .../eosio/chain/global_property_object.hpp | 2 +- .../eosio/chain/multi_index_includes.hpp | 2 +- .../include/eosio/chain/parallel_markers.hpp | 2 +- .../eosio/chain/permission_link_object.hpp | 2 +- .../include/eosio/chain/permission_object.hpp | 2 +- .../include/eosio/chain/producer_object.hpp | 2 +- .../chain/include/eosio/chain/protocol.hpp | 2 +- .../eosio/chain/resource_limits_private.hpp | 4 +- .../eosio/chain/reversible_block_object.hpp | 2 +- .../chain/include/eosio/chain/snapshot.hpp | 2 +- .../chain/include/eosio/chain/symbol.hpp | 4 +- .../include/eosio/chain/thread_utils.hpp | 24 + libraries/chain/include/eosio/chain/trace.hpp | 2 +- .../chain/include/eosio/chain/transaction.hpp | 83 +- .../eosio/chain/transaction_context.hpp | 1 - .../eosio/chain/transaction_metadata.hpp | 53 +- .../eosio/chain/transaction_object.hpp | 2 +- libraries/chain/include/eosio/chain/types.hpp | 19 +- .../eosio/chain/wasm_eosio_injection.hpp | 11 +- .../include/eosio/chain/wast_to_wasm.hpp | 2 +- libraries/chain/transaction.cpp | 184 +-- libraries/chain/transaction_context.cpp | 1 - libraries/chain/transaction_metadata.cpp | 47 + libraries/chain/wasm_eosio_injection.cpp | 2 +- libraries/chain/wasm_interface.cpp | 17 +- libraries/chain/wast_to_wasm.cpp | 2 +- libraries/fc | 2 +- .../testing/include/eosio/testing/tester.hpp | 11 + libraries/testing/tester.cpp | 23 +- plugins/COMMUNITY.md | 4 + plugins/bnet_plugin/bnet_plugin.cpp | 17 +- .../include/eosio/bnet_plugin/bnet_plugin.hpp | 2 +- plugins/chain_api_plugin/chain_api_plugin.cpp | 2 +- .../chain_api_plugin/chain_api_plugin.hpp | 2 +- .../include/eosio/chain/plugin_interface.hpp | 8 +- plugins/chain_plugin/chain_plugin.cpp | 29 +- .../eosio/chain_plugin/chain_plugin.hpp | 5 +- .../db_size_api_plugin/db_size_api_plugin.cpp | 2 +- .../db_size_api_plugin/db_size_api_plugin.hpp | 2 +- .../faucet_testnet_plugin.cpp | 2 +- .../faucet_testnet_plugin.hpp | 2 +- .../history_api_plugin/history_api_plugin.cpp | 5 +- .../history_api_plugin/history_api_plugin.hpp | 2 +- plugins/history_plugin/history_plugin.cpp | 13 +- .../account_control_history_object.hpp | 2 +- .../eosio/history_plugin/history_plugin.hpp | 2 +- .../public_key_history_object.hpp | 2 +- .../http_client_plugin/http_client_plugin.cpp | 2 +- .../http_client_plugin/http_client_plugin.hpp | 2 +- plugins/http_plugin/http_plugin.cpp | 7 +- .../include/eosio/http_plugin/http_plugin.hpp | 2 +- .../eosio/login_plugin/login_plugin.hpp | 2 +- plugins/login_plugin/login_plugin.cpp | 2 +- .../eosio/mongo_db_plugin/mongo_db_plugin.hpp | 2 +- plugins/mongo_db_plugin/mongo_db_plugin.cpp | 32 +- .../eosio/net_api_plugin/net_api_plugin.hpp | 2 +- plugins/net_api_plugin/net_api_plugin.cpp | 2 +- .../include/eosio/net_plugin/net_plugin.hpp | 2 +- .../include/eosio/net_plugin/protocol.hpp | 7 +- plugins/net_plugin/net_plugin.cpp | 1161 ++++++++--------- .../producer_api_plugin.hpp | 2 +- .../producer_api_plugin.cpp | 2 +- .../eosio/producer_plugin/producer_plugin.hpp | 2 +- plugins/producer_plugin/producer_plugin.cpp | 390 +++--- .../state_history_log.hpp | 2 +- .../state_history_plugin.hpp | 2 +- .../state_history_serialization.hpp | 2 +- .../state_history_plugin.cpp | 2 +- .../eosio/template_plugin/template_plugin.hpp | 2 +- plugins/template_plugin/template_plugin.cpp | 2 +- .../test_control_api_plugin.hpp | 2 +- .../test_control_api_plugin.cpp | 2 +- .../test_control_plugin.hpp | 2 +- .../test_control_plugin.cpp | 2 +- .../txn_test_gen_plugin.hpp | 2 +- .../txn_test_gen_plugin.cpp | 52 +- .../wallet_api_plugin/wallet_api_plugin.hpp | 2 +- .../wallet_api_plugin/wallet_api_plugin.cpp | 2 +- .../include/eosio/wallet_plugin/wallet.hpp | 2 +- .../eosio/wallet_plugin/wallet_api.hpp | 2 +- .../eosio/wallet_plugin/wallet_manager.hpp | 2 +- .../eosio/wallet_plugin/wallet_plugin.hpp | 2 +- plugins/wallet_plugin/se_wallet.cpp | 2 +- plugins/wallet_plugin/wallet.cpp | 2 +- plugins/wallet_plugin/wallet_manager.cpp | 2 +- plugins/wallet_plugin/wallet_plugin.cpp | 2 +- plugins/wallet_plugin/yubihsm_wallet.cpp | 2 +- programs/cleos/config.hpp.in | 2 +- programs/cleos/help_text.cpp | 2 +- programs/cleos/help_text.hpp | 2 +- programs/cleos/httpc.hpp | 2 +- programs/cleos/localize.hpp | 2 +- programs/cleos/main.cpp | 2 +- programs/eosio-launcher/config.hpp.in | 2 +- programs/eosio-launcher/main.cpp | 2 +- programs/keosd/config.hpp.in | 2 +- programs/keosd/main.cpp | 2 +- programs/nodeos/config.hpp.in | 2 +- scripts/boost.rb | 131 ++ scripts/eosio_build_amazon.sh | 9 +- scripts/eosio_build_centos.sh | 4 + scripts/eosio_build_darwin.sh | 18 +- scripts/eosio_build_fedora.sh | 1 + scripts/eosio_build_ubuntu.sh | 1 + scripts/generate_deb.sh | 20 +- scripts/generate_package.sh.in | 5 + scripts/generate_rpm.sh | 3 + tests/Cluster.py | 2 +- tests/main.cpp | 2 +- tests/validate-dirty-db.py | 2 +- tests/wallet_tests.cpp | 5 +- tools/validate_reflection.py | 698 ++++++++++ tutorials/bios-boot-tutorial/README.md | 39 +- .../bios-boot-tutorial/bios-boot-tutorial.py | 44 +- unittests/abi_tests.cpp | 4 +- unittests/api_tests.cpp | 33 +- unittests/block_tests.cpp | 11 +- unittests/block_timestamp_tests.cpp | 2 +- .../contracts/deferred_test/deferred_test.cpp | 2 +- unittests/database_tests.cpp | 5 +- unittests/delay_tests.cpp | 2 +- unittests/eosio_system_tester.hpp | 2 +- unittests/forked_tests.cpp | 6 +- unittests/include/config.hpp.in | 2 +- unittests/main.cpp | 2 +- unittests/message_buffer_tests.cpp | 2 +- unittests/misc_tests.cpp | 8 +- unittests/producer_schedule_tests.cpp | 132 ++ unittests/ram_tests.cpp | 2 +- unittests/snapshot_tests.cpp | 2 +- unittests/special_accounts_tests.cpp | 2 +- 236 files changed, 2684 insertions(+), 1378 deletions(-) create mode 100644 images/bos-workflow.png create mode 100644 libraries/chain/include/eosio/chain/thread_utils.hpp create mode 100644 libraries/chain/transaction_metadata.cpp create mode 100644 scripts/boost.rb create mode 100755 tools/validate_reflection.py diff --git a/.buildkite/pipeline.yml b/.buildkite/pipeline.yml index 3c7f63def07..893a19f9ff9 100644 --- a/.buildkite/pipeline.yml +++ b/.buildkite/pipeline.yml @@ -398,6 +398,7 @@ steps: - "os=high-sierra" artifact_paths: - "build/packages/*.tar.gz" + - "build/packages/*.rb" timeout: 60 - command: | @@ -412,6 +413,7 @@ steps: - "os=mojave" artifact_paths: - "build/packages/*.tar.gz" + - "build/packages/*.rb" timeout: 60 - command: | @@ -507,3 +509,18 @@ steps: OS: "el7" PKGTYPE: "rpm" timeout: 60 + + - wait + + - command: | + echo "--- :arrow_down: Downloading brew files" && \ + buildkite-agent artifact download "build/packages/eosio.rb" . --step ":darwin: High Sierra Package Builder" && \ + mv build/packages/eosio.rb build/packages/eosio_highsierra.rb && \ + buildkite-agent artifact download "build/packages/eosio.rb" . --step ":darwin: Mojave Package Builder" + label: ":darwin: Brew Updater" + agents: + queue: "automation-large-builder-fleet" + artifact_paths: + - "build/packages/eosio_highsierra.rb" + - "build/packages/eosio.rb" + timeout: 60 diff --git a/.gitmodules b/.gitmodules index 7d0f8a37f7b..205a731ffce 100644 --- a/.gitmodules +++ b/.gitmodules @@ -29,4 +29,4 @@ url = https://github.com/EOSIO/fc [submodule "libraries/wabt"] path = libraries/wabt - url = http://github.com/EOSIO/wabt + url = https://github.com/EOSIO/wabt diff --git a/CMakeLists.txt b/CMakeLists.txt index 2303eee93b3..daacda9a0c5 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -17,7 +17,7 @@ list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/CMakeModules") if (UNIX) if (APPLE) if (LLVM_DIR STREQUAL "" OR NOT LLVM_DIR) - set(LLVM_DIR "/usr/local/Cellar/llvm@4/4.0.1/lib/cmake/llvm") + set(LLVM_DIR "/usr/local/opt/llvm@4/lib/cmake/llvm/") endif() endif() endif() @@ -35,7 +35,7 @@ set( CXX_STANDARD_REQUIRED ON) set(VERSION_MAJOR 2) set(VERSION_MINOR 0) -set(VERSION_PATCH 1) +set(VERSION_PATCH 2) if(VERSION_SUFFIX) set(VERSION_FULL "${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}-${VERSION_SUFFIX}") diff --git a/Docker/README.md b/Docker/README.md index 582b8936e0d..5be2cbe6a1f 100644 --- a/Docker/README.md +++ b/Docker/README.md @@ -20,10 +20,10 @@ cd bos/Docker docker build . -t boscore/bos -s BOS ``` -The above will build off the most recent commit to the master branch by default. If you would like to target a specific branch/tag, you may use a build argument. For example, if you wished to generate a docker image based off of the v2.0.1 tag, you could do the following: +The above will build off the most recent commit to the master branch by default. If you would like to target a specific branch/tag, you may use a build argument. For example, if you wished to generate a docker image based off of the v2.0.2 tag, you could do the following: ```bash -docker build -t boscore/bos:v2.0.1 --build-arg branch=v2.0.1 . +docker build -t boscore/bos:v2.0.2 --build-arg branch=v2.0.2 . ``` @@ -198,4 +198,4 @@ The `blocks` data are stored under `--data-dir` by default, and the wallet files ### About MongoDB Plugin -Currently, the mongodb plugin is disabled in `config.ini` by default, you have to change it manually in `config.ini` or you can mount a `config.ini` file to `/opt/eosio/bin/data-dir/config.ini` in the docker-compose file. +Currently, the mongodb plugin is disabled in `config.ini` by default, you have to change it manually in `config.ini` or you can mount a `config.ini` file to `/opt/eosio/bin/data-dir/config.ini` in the docker-compose file. \ No newline at end of file diff --git a/Docker/config.ini b/Docker/config.ini index 71ae5c6c0ed..9014d16a888 100644 --- a/Docker/config.ini +++ b/Docker/config.ini @@ -113,9 +113,6 @@ network-version-match = 0 # number of blocks to retrieve in a chunk from any individual peer during synchronization (eosio::net_plugin) sync-fetch-span = 100 -# maximum sizes of transaction or block messages that are sent without first sending a notice (eosio::net_plugin) -max-implicit-request = 1500 - # Enable block production, even if the chain is stale. (eosio::producer_plugin) enable-stale-production = false diff --git a/README.md b/README.md index a237aa1cf77..eae2abca3f3 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # BOSCore - Born for DApps. Born for Usability. -## BOSCore Version: v2.0.1 -### Basic EOSIO Version: v1.5.3-patched +## BOSCore Version: v2.0.2 +### Basic EOSIO Version: v1.6.2 # Background The emergence of EOS has brought new imagination to the blockchain. In just a few months since the main network was launched, the version has undergone dozens of upgrades, not only the stability has been greatly improved, but also the new functions have been gradually realized. The node team is also actively involved in building the EOSIO ecosystem. What is even more exciting is that EOS has attracted more and more development teams. There are already hundreds of DApp running on the EOS main network. The transaction volume and circulation market value far exceed Ethereum, and the space for development is growing broader. @@ -29,6 +29,15 @@ As BOS continues to develop, developer rewards will be appropriately adjusted to 1. Build from code : `bash ./eosio_build.sh -s BOS` 2. Docker Style，check [Docker](./Docker/README.md) +## BOSCore Workflow +BOSCore encourage community developer actively participate in contributing the code, members should follow the workflow below. +![BOSCore Workflow](./images/bos-workflow.png) + +Attention: +1. Only allow Feature Branch or bug fix to submit PR to Develop Branch. +2. Rebase is required before submitting PR to Develop Branch. +3. Treat update of eosio/eos code as new feature. +4. Emergent issues must repaired by adopting hotfixes mode. BOSCore bases on EOSIO, so you can also referer: @@ -36,4 +45,3 @@ BOSCore bases on EOSIO, so you can also referer: [EOSIO Developer Portal](https://developers.eos.io). - diff --git a/README_CN.md b/README_CN.md index e8e8d3a9d41..2c1b2434dc8 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,7 +1,7 @@ # BOSCore - 更可用的链，为DApp而生。 -## BOSCore Version: v2.0.1 -### Basic EOSIO Version: v1.5.3-patched +## BOSCore Version: v2.0.2 +### Basic EOSIO Version: v1.6.2 # 背景 EOS的出现给区块链带来了新的想象力，主网启动短短几个月以来，版本经历了几十次升级，不仅稳定性得到了很大提高，并且新功能也逐步实现，各个节点团队也积极参与建设EOSIO生态。让人更加兴奋的是，EOS已经吸引了越来越多的开发团队，当前已经有数百个DApp在EOS主网上面运行，其交易量和流通市值远超以太坊，可发展的空间愈来愈广阔。 @@ -29,6 +29,16 @@ BOS链的代码完全由社区贡献并维护，每个生态参与者都可以 1. 源码直接编译: `bash ./eosio_build.sh -s BOS` 2. Docker方式部署，参看 [Docker](./Docker/README.md) +## BOSCore 开发流程 +BOSCore 鼓励社区开发者参与代码贡献，社区成员应当遵循以下工作流： +![BOSCore Workflow](./images/bos-workflow.png) + +注意: +1. 只有待发布的 Feature Branch 或者Bug修复才应该向 Develop Branch 提交 +2. 向 Develop Branch 提交 PR 之前需要现在本地执行 rebase 操作 +3. EOSIO 主网版本作为一个 Feature Branch 来对待 +4. 紧急问题修复采用 hotfixes 模式 + BOSCore是基于EOSIO技术的扩展，所以EOSIO的相关资料也可以参考： [EOSIO 开始](https://developers.eos.io/eosio-nodeos/docs/overview-1) diff --git a/contracts/asserter/asserter.cpp b/contracts/asserter/asserter.cpp index f64ea509a1f..c89db1fc709 100644 --- a/contracts/asserter/asserter.cpp +++ b/contracts/asserter/asserter.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include /// defines assert_def struct (abi) diff --git a/contracts/asserter/asserter.hpp b/contracts/asserter/asserter.hpp index 99680870c04..01d4b343e3f 100644 --- a/contracts/asserter/asserter.hpp +++ b/contracts/asserter/asserter.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/eosio.system/delegate_bandwidth.cpp b/contracts/eosio.system/delegate_bandwidth.cpp index fd4e83fcce7..a2920d70295 100644 --- a/contracts/eosio.system/delegate_bandwidth.cpp +++ b/contracts/eosio.system/delegate_bandwidth.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include "eosio.system.hpp" diff --git a/contracts/eosio.system/eosio.system.hpp b/contracts/eosio.system/eosio.system.hpp index 66964e39659..2b6d16d3d59 100644 --- a/contracts/eosio.system/eosio.system.hpp +++ b/contracts/eosio.system/eosio.system.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosio.system/native.hpp b/contracts/eosio.system/native.hpp index e6395807395..e2bcb319575 100644 --- a/contracts/eosio.system/native.hpp +++ b/contracts/eosio.system/native.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosio.system/voting.cpp b/contracts/eosio.system/voting.cpp index feeb53fc3d8..8076f79886d 100644 --- a/contracts/eosio.system/voting.cpp +++ b/contracts/eosio.system/voting.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include "eosio.system.hpp" diff --git a/contracts/eosio.token/eosio.token.cpp b/contracts/eosio.token/eosio.token.cpp index 351d81c47c5..4570b19b5c9 100644 --- a/contracts/eosio.token/eosio.token.cpp +++ b/contracts/eosio.token/eosio.token.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include "eosio.token.hpp" diff --git a/contracts/eosio.token/eosio.token.hpp b/contracts/eosio.token/eosio.token.hpp index 15875134777..48312c9edb4 100644 --- a/contracts/eosio.token/eosio.token.hpp +++ b/contracts/eosio.token/eosio.token.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/action.h b/contracts/eosiolib/action.h index 3e686fe469d..f8deba837b8 100644 --- a/contracts/eosiolib/action.h +++ b/contracts/eosiolib/action.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/action.hpp b/contracts/eosiolib/action.hpp index 11028f09e93..d4538c2972e 100644 --- a/contracts/eosiolib/action.hpp +++ b/contracts/eosiolib/action.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/chain.h b/contracts/eosiolib/chain.h index 8477968be9e..ec4f219b4b9 100644 --- a/contracts/eosiolib/chain.h +++ b/contracts/eosiolib/chain.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/compiler_builtins.h b/contracts/eosiolib/compiler_builtins.h index 3e0d9435357..c2dc09bb356 100644 --- a/contracts/eosiolib/compiler_builtins.h +++ b/contracts/eosiolib/compiler_builtins.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/core_symbol.hpp.in b/contracts/eosiolib/core_symbol.hpp.in index 4a60220b6a9..3262d2aad10 100644 --- a/contracts/eosiolib/core_symbol.hpp.in +++ b/contracts/eosiolib/core_symbol.hpp.in @@ -1,5 +1,5 @@ /** @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See core_symbol.hpp.in for changes. */ diff --git a/contracts/eosiolib/crypto.h b/contracts/eosiolib/crypto.h index 916c25954f7..0133762c43b 100644 --- a/contracts/eosiolib/crypto.h +++ b/contracts/eosiolib/crypto.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/datastream.hpp b/contracts/eosiolib/datastream.hpp index 65666e78cc4..97aed9f4cf7 100644 --- a/contracts/eosiolib/datastream.hpp +++ b/contracts/eosiolib/datastream.hpp @@ -1,6 +1,6 @@ /** * @file datastream.hpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/db.h b/contracts/eosiolib/db.h index d2c01b6b15d..f112ef5bf6d 100644 --- a/contracts/eosiolib/db.h +++ b/contracts/eosiolib/db.h @@ -1,6 +1,6 @@ /** * @file db.h - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * @brief Defines C API for interfacing with blockchain database */ #pragma once diff --git a/contracts/eosiolib/eosio.hpp b/contracts/eosiolib/eosio.hpp index 3e850a69dea..2126abb3203 100644 --- a/contracts/eosiolib/eosio.hpp +++ b/contracts/eosiolib/eosio.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/fixed_key.hpp b/contracts/eosiolib/fixed_key.hpp index eb04a45b46c..4e8cd8241da 100644 --- a/contracts/eosiolib/fixed_key.hpp +++ b/contracts/eosiolib/fixed_key.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/memory.h b/contracts/eosiolib/memory.h index 58e5a482b3d..474e7c7b598 100644 --- a/contracts/eosiolib/memory.h +++ b/contracts/eosiolib/memory.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/memory.hpp b/contracts/eosiolib/memory.hpp index 4a4f56a1c48..f2abbf898d2 100644 --- a/contracts/eosiolib/memory.hpp +++ b/contracts/eosiolib/memory.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/multi_index.hpp b/contracts/eosiolib/multi_index.hpp index d7082559059..cba34f103a0 100644 --- a/contracts/eosiolib/multi_index.hpp +++ b/contracts/eosiolib/multi_index.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/permission.h b/contracts/eosiolib/permission.h index 8acd07fd553..743b499bca8 100644 --- a/contracts/eosiolib/permission.h +++ b/contracts/eosiolib/permission.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/permission.hpp b/contracts/eosiolib/permission.hpp index a6956f5dd28..668fa79bff9 100644 --- a/contracts/eosiolib/permission.hpp +++ b/contracts/eosiolib/permission.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/print.h b/contracts/eosiolib/print.h index 63fd1da9d54..ab7dfcc8ade 100644 --- a/contracts/eosiolib/print.h +++ b/contracts/eosiolib/print.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/print.hpp b/contracts/eosiolib/print.hpp index a90a277cf47..84bdf263aa3 100644 --- a/contracts/eosiolib/print.hpp +++ b/contracts/eosiolib/print.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/system.h b/contracts/eosiolib/system.h index 62a5cfeef51..b7d3e614107 100644 --- a/contracts/eosiolib/system.h +++ b/contracts/eosiolib/system.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/transaction.h b/contracts/eosiolib/transaction.h index 95a41322acc..0cbe0f67a57 100644 --- a/contracts/eosiolib/transaction.h +++ b/contracts/eosiolib/transaction.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/transaction.hpp b/contracts/eosiolib/transaction.hpp index 1586b92b09b..2b5e1f1fb2a 100644 --- a/contracts/eosiolib/transaction.hpp +++ b/contracts/eosiolib/transaction.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/types.h b/contracts/eosiolib/types.h index 120c896cd87..1611df2aad2 100644 --- a/contracts/eosiolib/types.h +++ b/contracts/eosiolib/types.h @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/eosiolib/types.hpp b/contracts/eosiolib/types.hpp index d535f49e922..f1e7c10dcd1 100644 --- a/contracts/eosiolib/types.hpp +++ b/contracts/eosiolib/types.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/contracts/eosiolib/varint.hpp b/contracts/eosiolib/varint.hpp index b8240839aa0..dcc444f20d6 100644 --- a/contracts/eosiolib/varint.hpp +++ b/contracts/eosiolib/varint.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/noop/noop.cpp b/contracts/noop/noop.cpp index 67f3f101f14..6699eca57c9 100644 --- a/contracts/noop/noop.cpp +++ b/contracts/noop/noop.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/proxy/proxy.cpp b/contracts/proxy/proxy.cpp index ff27e5d5af2..3d243fd4e02 100644 --- a/contracts/proxy/proxy.cpp +++ b/contracts/proxy/proxy.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/proxy/proxy.hpp b/contracts/proxy/proxy.hpp index fd439e3c274..924edd24b10 100644 --- a/contracts/proxy/proxy.hpp +++ b/contracts/proxy/proxy.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/skeleton/skeleton.hpp b/contracts/skeleton/skeleton.hpp index ec28c3d168b..2b621b6f2ed 100644 --- a/contracts/skeleton/skeleton.hpp +++ b/contracts/skeleton/skeleton.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/stltest/stltest.cpp b/contracts/stltest/stltest.cpp index 79828877f98..baf975ff703 100644 --- a/contracts/stltest/stltest.cpp +++ b/contracts/stltest/stltest.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ // include entire libc #include diff --git a/contracts/test_api/test_action.cpp b/contracts/test_api/test_action.cpp index 496b30fcc37..20eacaa1bd8 100644 --- a/contracts/test_api/test_action.cpp +++ b/contracts/test_api/test_action.cpp @@ -1,6 +1,6 @@ /** * @file action_test.cpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_api.cpp b/contracts/test_api/test_api.cpp index 9ddcb712752..ce7b44d6c9f 100644 --- a/contracts/test_api/test_api.cpp +++ b/contracts/test_api/test_api.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_api.hpp b/contracts/test_api/test_api.hpp index 4dc5711e3a1..5406dff5520 100644 --- a/contracts/test_api/test_api.hpp +++ b/contracts/test_api/test_api.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include "test_api_common.hpp" diff --git a/contracts/test_api/test_api_common.hpp b/contracts/test_api/test_api_common.hpp index 8d63a535089..d78afa29bb3 100644 --- a/contracts/test_api/test_api_common.hpp +++ b/contracts/test_api/test_api_common.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/contracts/test_api/test_chain.cpp b/contracts/test_api/test_chain.cpp index 6c71eb78eda..22f4ca4f914 100644 --- a/contracts/test_api/test_chain.cpp +++ b/contracts/test_api/test_chain.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_checktime.cpp b/contracts/test_api/test_checktime.cpp index 4f6bef4659a..a227ee91b04 100644 --- a/contracts/test_api/test_checktime.cpp +++ b/contracts/test_api/test_checktime.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/test_api/test_compiler_builtins.cpp b/contracts/test_api/test_compiler_builtins.cpp index 1492110b82e..a7571b0a2ce 100644 --- a/contracts/test_api/test_compiler_builtins.cpp +++ b/contracts/test_api/test_compiler_builtins.cpp @@ -1,6 +1,6 @@ /** * @file test_compiler_builtins.cpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/test_api/test_crypto.cpp b/contracts/test_api/test_crypto.cpp index 526ec4170af..3b96e6e6fad 100644 --- a/contracts/test_api/test_crypto.cpp +++ b/contracts/test_api/test_crypto.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_permission.cpp b/contracts/test_api/test_permission.cpp index 824e8434b7d..f26c120a0a1 100644 --- a/contracts/test_api/test_permission.cpp +++ b/contracts/test_api/test_permission.cpp @@ -1,6 +1,6 @@ /** * @file action_test.cpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_print.cpp b/contracts/test_api/test_print.cpp index 310834037b2..a042ff6f57a 100644 --- a/contracts/test_api/test_print.cpp +++ b/contracts/test_api/test_print.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/test_api/test_transaction.cpp b/contracts/test_api/test_transaction.cpp index 95030419f58..cc1128ae5f6 100644 --- a/contracts/test_api/test_transaction.cpp +++ b/contracts/test_api/test_transaction.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/test_api/test_types.cpp b/contracts/test_api/test_types.cpp index d3cf87b9614..bc9dca52e2a 100644 --- a/contracts/test_api/test_types.cpp +++ b/contracts/test_api/test_types.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/test_api_db/test_api_db.cpp b/contracts/test_api_db/test_api_db.cpp index 706734ba967..d603477a631 100644 --- a/contracts/test_api_db/test_api_db.cpp +++ b/contracts/test_api_db/test_api_db.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include "../test_api/test_api.hpp" diff --git a/contracts/test_api_mem/test_api_mem.cpp b/contracts/test_api_mem/test_api_mem.cpp index e01bba16378..ce59249425d 100644 --- a/contracts/test_api_mem/test_api_mem.cpp +++ b/contracts/test_api_mem/test_api_mem.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include "../test_api/test_api.hpp" diff --git a/contracts/test_api_mem/test_memory.cpp b/contracts/test_api_mem/test_memory.cpp index d3f387fd8b1..3e1eb52243e 100644 --- a/contracts/test_api_mem/test_memory.cpp +++ b/contracts/test_api_mem/test_memory.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/contracts/test_api_multi_index/test_api_multi_index.cpp b/contracts/test_api_multi_index/test_api_multi_index.cpp index 9c5713385ad..828a1d75b88 100644 --- a/contracts/test_api_multi_index/test_api_multi_index.cpp +++ b/contracts/test_api_multi_index/test_api_multi_index.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include "../test_api/test_api.hpp" diff --git a/contracts/test_ram_limit/test_ram_limit.cpp b/contracts/test_ram_limit/test_ram_limit.cpp index 136c27aa72c..c162cea6585 100644 --- a/contracts/test_ram_limit/test_ram_limit.cpp +++ b/contracts/test_ram_limit/test_ram_limit.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/contracts/tic_tac_toe/tic_tac_toe.cpp b/contracts/tic_tac_toe/tic_tac_toe.cpp index ebc5cc46203..a6eb62eccf6 100644 --- a/contracts/tic_tac_toe/tic_tac_toe.cpp +++ b/contracts/tic_tac_toe/tic_tac_toe.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include "tic_tac_toe.hpp" diff --git a/contracts/tic_tac_toe/tic_tac_toe.hpp b/contracts/tic_tac_toe/tic_tac_toe.hpp index 4339ab212e1..f4f32982ff6 100644 --- a/contracts/tic_tac_toe/tic_tac_toe.hpp +++ b/contracts/tic_tac_toe/tic_tac_toe.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/eosio_build.sh b/eosio_build.sh index fafdbbaeb8e..b600e0905ea 100755 --- a/eosio_build.sh +++ b/eosio_build.sh @@ -34,10 +34,14 @@ function usage() { - printf "\\tUsage: %s \\n\\t[Build Option -o ] \\n\\t[CodeCoverage -c] \\n\\t[Doxygen -d] \\n\\t[CoreSymbolName -s <1-7 characters>] \\n\\t[Avoid Compiling -a]\\n\\n" "$0" 1>&2 + printf "\\tUsage: %s \\n\\t[Build Option -o ] \\n\\t[CodeCoverage -c] \\n\\t[Doxygen -d] \\n\\t[CoreSymbolName -s <1-7 characters>] \\n\\t[Avoid Compiling -a]\\n\\t[Noninteractive -y]\\n\\n" "$0" 1>&2 exit 1 } + is_noninteractive() { + [[ -n "${EOSIO_BUILD_NONINTERACTIVE+1}" ]] + } + ARCH=$( uname ) if [ "${SOURCE_DIR}" == "${PWD}" ]; then BUILD_DIR="${PWD}/build" @@ -66,7 +70,7 @@ txtrst=$(tput sgr0) if [ $# -ne 0 ]; then - while getopts ":cdo:s:ah" opt; do + while getopts ":cdo:s:ahy" opt; do case "${opt}" in o ) options=( "Debug" "Release" "RelWithDebInfo" "MinSizeRel" ) @@ -100,6 +104,9 @@ usage exit 1 ;; + y) + EOSIO_BUILD_NONINTERACTIVE=1 + ;; \? ) printf "\\n\\tInvalid Option: %s\\n" "-${OPTARG}" 1>&2 usage @@ -238,7 +245,7 @@ . "$FILE" - printf "\\n\\n>>>>>>>> ALL dependencies sucessfully found or installed . Installing BOSCore\\n\\n" + printf "\\n\\n>>>>>>>> ALL dependencies successfully found or installed . Installing EOSIO\\n\\n" printf ">>>>>>>> CMAKE_BUILD_TYPE=%s\\n" "${CMAKE_BUILD_TYPE}" printf ">>>>>>>> ENABLE_COVERAGE_TESTING=%s\\n" "${ENABLE_COVERAGE_TESTING}" printf ">>>>>>>> DOXYGEN=%s\\n\\n" "${DOXYGEN}" diff --git a/images/bos-workflow.png b/images/bos-workflow.png new file mode 100644 index 0000000000000000000000000000000000000000..6c00b9cf715c0c449f11c037a42f21e354a67b28 GIT binary patch literal 437365 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 C2d%#V literal 0 HcmV?d00001 diff --git a/libraries/CMakeLists.txt b/libraries/CMakeLists.txt index 18013317c57..eeaf5afa771 100644 --- a/libraries/CMakeLists.txt +++ b/libraries/CMakeLists.txt @@ -7,8 +7,9 @@ add_subdirectory( appbase ) add_subdirectory( chain ) add_subdirectory( testing ) -#turn these off for now +#turn tools&tests off; not needed for library build set(BUILD_TESTS OFF CACHE BOOL "Build GTest-based tests") set(BUILD_TOOLS OFF CACHE BOOL "Build wabt tools") set(RUN_RE2C OFF CACHE BOOL "Run re2c") +set(WITH_EXCEPTIONS ON CACHE BOOL "Build with exceptions enabled" FORCE) add_subdirectory( wabt ) diff --git a/libraries/chain/CMakeLists.txt b/libraries/chain/CMakeLists.txt index ee8fe1ebab2..2c430fecea0 100644 --- a/libraries/chain/CMakeLists.txt +++ b/libraries/chain/CMakeLists.txt @@ -46,7 +46,7 @@ add_library( eosio_chain # contracts/chain_initializer.cpp -# transaction_metadata.cpp + transaction_metadata.cpp ${HEADERS} ) diff --git a/libraries/chain/abi_serializer.cpp b/libraries/chain/abi_serializer.cpp index b5f67e51059..2f453e0cf93 100644 --- a/libraries/chain/abi_serializer.cpp +++ b/libraries/chain/abi_serializer.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/libraries/chain/apply_context.cpp b/libraries/chain/apply_context.cpp index 3a0de3b1466..44a3970f230 100644 --- a/libraries/chain/apply_context.cpp +++ b/libraries/chain/apply_context.cpp @@ -525,9 +525,8 @@ int apply_context::db_store_i64( uint64_t code, uint64_t scope, uint64_t table, const auto& obj = db.create( [&]( auto& o ) { o.t_id = tableid; o.primary_key = id; - o.value.resize( buffer_size ); + o.value.assign( buffer, buffer_size ); o.payer = payer; - memcpy( o.value.data(), buffer, buffer_size ); }); db.modify( tab, [&]( auto& t ) { @@ -566,8 +565,7 @@ void apply_context::db_update_i64( int iterator, account_name payer, const char* } db.modify( obj, [&]( auto& o ) { - o.value.resize( buffer_size ); - memcpy( o.value.data(), buffer, buffer_size ); + o.value.assign( buffer, buffer_size ); o.payer = payer; }); } diff --git a/libraries/chain/asset.cpp b/libraries/chain/asset.cpp index 142e04cffa3..580156f6d21 100644 --- a/libraries/chain/asset.cpp +++ b/libraries/chain/asset.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/libraries/chain/authorization_manager.cpp b/libraries/chain/authorization_manager.cpp index 6725468cf97..e69f7129121 100644 --- a/libraries/chain/authorization_manager.cpp +++ b/libraries/chain/authorization_manager.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/libraries/chain/block_header.cpp b/libraries/chain/block_header.cpp index b73338b3ca2..bbc9de7b06b 100644 --- a/libraries/chain/block_header.cpp +++ b/libraries/chain/block_header.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/libraries/chain/block_log.cpp b/libraries/chain/block_log.cpp index dc769cc9612..41e9756483e 100644 --- a/libraries/chain/block_log.cpp +++ b/libraries/chain/block_log.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -473,7 +473,7 @@ namespace eosio { namespace chain { old_block_stream.read( reinterpret_cast(&tmp_pos), sizeof(tmp_pos) ); } if( pos != tmp_pos ) { - bad_block = tmp; + bad_block.emplace(std::move(tmp)); break; } diff --git a/libraries/chain/chain_config.cpp b/libraries/chain/chain_config.cpp index efb66bba95f..c39d89cee46 100644 --- a/libraries/chain/chain_config.cpp +++ b/libraries/chain/chain_config.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/libraries/chain/chain_id_type.cpp b/libraries/chain/chain_id_type.cpp index efddb213c6f..634d4623c98 100644 --- a/libraries/chain/chain_id_type.cpp +++ b/libraries/chain/chain_id_type.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include @@ -8,7 +8,7 @@ namespace eosio { namespace chain { - void chain_id_type::reflector_verify()const { + void chain_id_type::reflector_init()const { EOS_ASSERT( *reinterpret_cast(this) != fc::sha256(), chain_id_type_exception, "chain_id_type cannot be zero" ); } diff --git a/libraries/chain/controller.cpp b/libraries/chain/controller.cpp index 85507dea83a..5853f1ff1ec 100644 --- a/libraries/chain/controller.cpp +++ b/libraries/chain/controller.cpp @@ -17,15 +17,13 @@ #include #include #include +#include #include #include #include #include -#include -#include - namespace eosio { namespace chain { @@ -138,7 +136,7 @@ struct controller_impl { optional subjective_cpu_leeway; bool trusted_producer_light_validation = false; uint32_t snapshot_head_block = 0; - optional thread_pool; + boost::asio::thread_pool thread_pool; typedef pair handler_key; map< account_name, map > apply_handlers; @@ -148,15 +146,7 @@ struct controller_impl { * are removed from this list if they are re-applied in other blocks. Producers * can query this list when scheduling new transactions into blocks. */ - map unapplied_transactions; - - // async on thread_pool and return future - template - auto async_thread_pool( F&& f ) { - auto task = std::make_shared>( std::forward( f ) ); - boost::asio::post( *thread_pool, [task]() { (*task)(); } ); - return task->get_future(); - } + unapplied_transactions_type unapplied_transactions; void pop_block() { auto prev = fork_db.get_block( head->header.previous ); @@ -197,7 +187,8 @@ struct controller_impl { authorization( s, db ), conf( cfg ), chain_id( cfg.genesis.compute_chain_id() ), - read_mode( cfg.read_mode ) + read_mode( cfg.read_mode ), + thread_pool( cfg.thread_pool_size ) { #define SET_APP_HANDLER( receiver, contract, action) \ @@ -352,8 +343,6 @@ struct controller_impl { void init(std::function shutdown, const snapshot_reader_ptr& snapshot) { - thread_pool.emplace( conf.thread_pool_size ); - bool report_integrity_hash = !!snapshot; if (snapshot) { EOS_ASSERT( !head, fork_database_exception, "" ); @@ -426,11 +415,6 @@ struct controller_impl { ~controller_impl() { pending.reset(); - if( thread_pool ) { - thread_pool->join(); - thread_pool->stop(); - } - db.flush(); reversible_blocks.flush(); } @@ -1106,7 +1090,19 @@ struct controller_impl { transaction_trace_ptr trace; try { - transaction_context trx_context(self, trx->trx, trx->id); + auto start = fc::time_point::now(); + if( !explicit_billed_cpu_time ) { + fc::microseconds already_consumed_time( EOS_PERCENT(trx->sig_cpu_usage.count(), conf.sig_cpu_bill_pct) ); + + if( start.time_since_epoch() < already_consumed_time ) { + start = fc::time_point(); + } else { + start -= already_consumed_time; + } + } + + const signed_transaction& trn = trx->packed_trx->get_signed_transaction(); + transaction_context trx_context(self, trn, trx->id, start); if ((bool)subjective_cpu_leeway && pending->_block_status == controller::block_status::incomplete) { trx_context.leeway = *subjective_cpu_leeway; } @@ -1119,18 +1115,16 @@ struct controller_impl { trx_context.init_for_implicit_trx(); trx_context.enforce_whiteblacklist = false; } else { - bool skip_recording = replay_head_time && (time_point(trx->trx.expiration) <= *replay_head_time); - trx_context.init_for_input_trx( trx->packed_trx.get_unprunable_size(), - trx->packed_trx.get_prunable_size(), - trx->trx.signatures.size(), + bool skip_recording = replay_head_time && (time_point(trn.expiration) <= *replay_head_time); + trx_context.init_for_input_trx( trx->packed_trx->get_unprunable_size(), + trx->packed_trx->get_prunable_size(), skip_recording); } - - trx_context.delay = fc::seconds(trx->trx.delay_sec); + trx_context.delay = fc::seconds(trn.delay_sec); if( !self.skip_auth_check() && !trx->implicit ) { authorization.check_authorization( - trx->trx.actions, + trn.actions, trx->recover_keys( chain_id ), {}, trx_context.delay, @@ -1149,7 +1143,7 @@ struct controller_impl { transaction_receipt::status_enum s = (trx_context.delay == fc::seconds(0)) ? transaction_receipt::executed : transaction_receipt::delayed; - trace->receipt = push_receipt(trx->packed_trx, s, trx_context.billed_cpu_time_us, trace->net_usage); + trace->receipt = push_receipt(*trx->packed_trx, s, trx_context.billed_cpu_time_us, trace->net_usage); pending->_pending_block_state->trxs.emplace_back(trx); } else { transaction_receipt_header r; @@ -1296,15 +1290,9 @@ struct controller_impl { for( const auto& receipt : b->transactions ) { if( receipt.trx.contains()) { auto& pt = receipt.trx.get(); - auto mtrx = std::make_shared( pt ); + auto mtrx = std::make_shared( std::make_shared( pt ) ); if( !self.skip_auth_check() ) { - std::weak_ptr mtrx_wp = mtrx; - mtrx->signing_keys_future = async_thread_pool( [chain_id = this->chain_id, mtrx_wp]() { - auto mtrx = mtrx_wp.lock(); - return mtrx ? - std::make_pair( chain_id, mtrx->trx.get_signature_keys( chain_id ) ) : - std::make_pair( chain_id, decltype( mtrx->trx.get_signature_keys( chain_id ) ){} ); - } ); + transaction_metadata::create_signing_keys_future( mtrx, thread_pool, chain_id, microseconds::maximum() ); } packed_transactions.emplace_back( std::move( mtrx ) ); } @@ -1385,7 +1373,7 @@ struct controller_impl { auto prev = fork_db.get_block( b->previous ); EOS_ASSERT( prev, unlinkable_block_exception, "unlinkable block ${id}", ("id", id)("previous", b->previous) ); - return async_thread_pool( [b, prev]() { + return async_thread_pool( thread_pool, [b, prev]() { const bool skip_validate_signee = false; return std::make_shared( *prev, move( b ), skip_validate_signee ); } ); @@ -1897,6 +1885,10 @@ void controller::abort_block() { my->abort_block(); } +boost::asio::thread_pool& controller::get_thread_pool() { + return my->thread_pool; +} + std::future controller::create_block_state_future( const signed_block_ptr& b ) { return my->create_block_state_future( b ); } @@ -2241,41 +2233,12 @@ const account_object& controller::get_account( account_name name )const return my->db.get(name); } FC_CAPTURE_AND_RETHROW( (name) ) } -vector controller::get_unapplied_transactions() const { - vector result; - if ( my->read_mode == db_read_mode::SPECULATIVE ) { - result.reserve(my->unapplied_transactions.size()); - for ( const auto& entry: my->unapplied_transactions ) { - result.emplace_back(entry.second); - } - } else { - EOS_ASSERT( my->unapplied_transactions.empty(), transaction_exception, "not empty unapplied_transactions in non-speculative mode" ); //should never happen - } - return result; -} - -void controller::drop_unapplied_transaction(const transaction_metadata_ptr& trx) { - my->unapplied_transactions.erase(trx->signed_id); -} - -void controller::drop_all_unapplied_transactions() { - my->unapplied_transactions.clear(); -} - -vector controller::get_scheduled_transactions() const { - const auto& idx = db().get_index(); - - vector result; - - static const size_t max_reserve = 64; - result.reserve(std::min(idx.size(), max_reserve)); - - auto itr = idx.begin(); - while( itr != idx.end() && itr->delay_until <= pending_block_time() ) { - result.emplace_back(itr->trx_id); - ++itr; +unapplied_transactions_type& controller::get_unapplied_transactions() { + if ( my->read_mode != db_read_mode::SPECULATIVE ) { + EOS_ASSERT( my->unapplied_transactions.empty(), transaction_exception, + "not empty unapplied_transactions in non-speculative mode" ); //should never happen } - return result; + return my->unapplied_transactions; } bool controller::sender_avoids_whitelist_blacklist_enforcement( account_name sender )const { diff --git a/libraries/chain/eosio_contract.cpp b/libraries/chain/eosio_contract.cpp index e41fe815834..03e0fed7f7f 100644 --- a/libraries/chain/eosio_contract.cpp +++ b/libraries/chain/eosio_contract.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -155,10 +155,11 @@ void apply_eosio_setcode(apply_context& context) { // TODO: update setcode message to include the hash, then validate it in validate a.last_code_update = context.control.pending_block_time(); a.code_version = code_id; - a.code.resize( code_size ); - if( code_size > 0 ) - memcpy( a.code.data(), act.code.data(), code_size ); - + if ( code_size > 0 ) { + a.code.assign(act.code.data(), code_size); + } else { + a.code.resize(0); + } }); const auto& account_sequence = db.get(act.account); @@ -185,9 +186,11 @@ void apply_eosio_setabi(apply_context& context) { int64_t new_size = abi_size; db.modify( account, [&]( auto& a ) { - a.abi.resize( abi_size ); - if( abi_size > 0 ) - memcpy( a.abi.data(), act.abi.data(), abi_size ); + if (abi_size > 0) { + a.abi.assign(act.abi.data(), abi_size); + } else { + a.abi.resize(0); + } }); const auto& account_sequence = db.get(act.account); diff --git a/libraries/chain/genesis_state.cpp b/libraries/chain/genesis_state.cpp index 40257a6168b..23d8986e5bd 100644 --- a/libraries/chain/genesis_state.cpp +++ b/libraries/chain/genesis_state.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/libraries/chain/genesis_state_root_key.cpp.in b/libraries/chain/genesis_state_root_key.cpp.in index 6530698e33a..11bbde26397 100644 --- a/libraries/chain/genesis_state_root_key.cpp.in +++ b/libraries/chain/genesis_state_root_key.cpp.in @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/libraries/chain/include/eosio/chain/abi_def.hpp b/libraries/chain/include/eosio/chain/abi_def.hpp index f00dd19884d..9b1d211d623 100644 --- a/libraries/chain/include/eosio/chain/abi_def.hpp +++ b/libraries/chain/include/eosio/chain/abi_def.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/abi_serializer.hpp b/libraries/chain/include/eosio/chain/abi_serializer.hpp index 221424e041e..8f8fca4cdeb 100644 --- a/libraries/chain/include/eosio/chain/abi_serializer.hpp +++ b/libraries/chain/include/eosio/chain/abi_serializer.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -418,11 +418,11 @@ namespace impl { mutable_variant_object mvo; auto trx = ptrx.get_transaction(); mvo("id", trx.id()); - mvo("signatures", ptrx.signatures); - mvo("compression", ptrx.compression); - mvo("packed_context_free_data", ptrx.packed_context_free_data); + mvo("signatures", ptrx.get_signatures()); + mvo("compression", ptrx.get_compression()); + mvo("packed_context_free_data", ptrx.get_packed_context_free_data()); mvo("context_free_data", ptrx.get_context_free_data()); - mvo("packed_trx", ptrx.packed_trx); + mvo("packed_trx", ptrx.get_packed_transaction()); add(mvo, "transaction", trx, resolver, ctx); out(name, std::move(mvo)); @@ -577,32 +577,42 @@ namespace impl { const variant_object& vo = v.get_object(); EOS_ASSERT(vo.contains("signatures"), packed_transaction_type_exception, "Missing signatures"); EOS_ASSERT(vo.contains("compression"), packed_transaction_type_exception, "Missing compression"); - from_variant(vo["signatures"], ptrx.signatures); - from_variant(vo["compression"], ptrx.compression); + std::vector signatures; + packed_transaction::compression_type compression; + from_variant(vo["signatures"], signatures); + from_variant(vo["compression"], compression); + + bytes packed_cfd; + std::vector cfd; + bool use_packed_cfd = false; + if( vo.contains("packed_context_free_data") && vo["packed_context_free_data"].is_string() && !vo["packed_context_free_data"].as_string().empty() ) { + from_variant(vo["packed_context_free_data"], packed_cfd ); + use_packed_cfd = true; + } else if( vo.contains("context_free_data") ) { + from_variant(vo["context_free_data"], cfd); + } - // TODO: Make this nicer eventually. But for now, if it works... good enough. if( vo.contains("packed_trx") && vo["packed_trx"].is_string() && !vo["packed_trx"].as_string().empty() ) { - from_variant(vo["packed_trx"], ptrx.packed_trx); - auto trx = ptrx.get_transaction(); // Validates transaction data provided. - if( vo.contains("packed_context_free_data") && vo["packed_context_free_data"].is_string() && !vo["packed_context_free_data"].as_string().empty() ) { - from_variant(vo["packed_context_free_data"], ptrx.packed_context_free_data ); - } else if( vo.contains("context_free_data") ) { - vector context_free_data; - from_variant(vo["context_free_data"], context_free_data); - ptrx.set_transaction(trx, context_free_data, ptrx.compression); + bytes packed_trx; + from_variant(vo["packed_trx"], packed_trx); + if( use_packed_cfd ) { + ptrx = packed_transaction( std::move( packed_trx ), std::move( signatures ), std::move( packed_cfd ), compression ); + } else { + ptrx = packed_transaction( std::move( packed_trx ), std::move( signatures ), std::move( cfd ), compression ); } } else { EOS_ASSERT(vo.contains("transaction"), packed_transaction_type_exception, "Missing transaction"); - transaction trx; - vector context_free_data; - extract(vo["transaction"], trx, resolver, ctx); - if( vo.contains("packed_context_free_data") && vo["packed_context_free_data"].is_string() && !vo["packed_context_free_data"].as_string().empty() ) { - from_variant(vo["packed_context_free_data"], ptrx.packed_context_free_data ); - context_free_data = ptrx.get_context_free_data(); - } else if( vo.contains("context_free_data") ) { - from_variant(vo["context_free_data"], context_free_data); + if( use_packed_cfd ) { + transaction trx; + extract( vo["transaction"], trx, resolver, ctx ); + ptrx = packed_transaction( std::move(trx), std::move(signatures), std::move(packed_cfd), compression ); + } else { + signed_transaction trx; + extract( vo["transaction"], trx, resolver, ctx ); + trx.signatures = std::move( signatures ); + trx.context_free_data = std::move(cfd); + ptrx = packed_transaction( std::move( trx ), compression ); } - ptrx.set_transaction(trx, context_free_data, ptrx.compression); } } }; @@ -615,11 +625,11 @@ namespace impl { * @tparam Reslover - callable with the signature (const name& code_account) -> optional */ template - class abi_from_variant_visitor : reflector_verifier_visitor + class abi_from_variant_visitor : reflector_init_visitor { public: abi_from_variant_visitor( const variant_object& _vo, T& v, Resolver _resolver, abi_traverse_context& _ctx ) - : reflector_verifier_visitor(v) + : reflector_init_visitor(v) ,_vo(_vo) ,_resolver(_resolver) ,_ctx(_ctx) diff --git a/libraries/chain/include/eosio/chain/account_object.hpp b/libraries/chain/include/eosio/chain/account_object.hpp index 8a945512b3c..b995a8508a1 100644 --- a/libraries/chain/include/eosio/chain/account_object.hpp +++ b/libraries/chain/include/eosio/chain/account_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/action.hpp b/libraries/chain/include/eosio/chain/action.hpp index 9eb989bda91..9912e2f31b7 100644 --- a/libraries/chain/include/eosio/chain/action.hpp +++ b/libraries/chain/include/eosio/chain/action.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/action_receipt.hpp b/libraries/chain/include/eosio/chain/action_receipt.hpp index 9b5d138117f..17fe4f46713 100644 --- a/libraries/chain/include/eosio/chain/action_receipt.hpp +++ b/libraries/chain/include/eosio/chain/action_receipt.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/apply_context.hpp b/libraries/chain/include/eosio/chain/apply_context.hpp index 3a81b3ffc9d..3909906dbd5 100644 --- a/libraries/chain/include/eosio/chain/apply_context.hpp +++ b/libraries/chain/include/eosio/chain/apply_context.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/asset.hpp b/libraries/chain/include/eosio/chain/asset.hpp index 2c1f2bb4fc3..5c9bb9669bc 100644 --- a/libraries/chain/include/eosio/chain/asset.hpp +++ b/libraries/chain/include/eosio/chain/asset.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -84,7 +84,7 @@ struct asset friend struct fc::reflector; - void reflector_verify()const { + void reflector_init()const { EOS_ASSERT( is_amount_within_range(), asset_type_exception, "magnitude of asset amount must be less than 2^62" ); EOS_ASSERT( sym.valid(), asset_type_exception, "invalid symbol" ); } diff --git a/libraries/chain/include/eosio/chain/authority.hpp b/libraries/chain/include/eosio/chain/authority.hpp index d59382de2c9..373deb56120 100644 --- a/libraries/chain/include/eosio/chain/authority.hpp +++ b/libraries/chain/include/eosio/chain/authority.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/authority_checker.hpp b/libraries/chain/include/eosio/chain/authority_checker.hpp index 068cc5a9137..f17eeac10bf 100644 --- a/libraries/chain/include/eosio/chain/authority_checker.hpp +++ b/libraries/chain/include/eosio/chain/authority_checker.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/authorization_manager.hpp b/libraries/chain/include/eosio/chain/authorization_manager.hpp index a6df7ad2568..3e9ffd0bb42 100644 --- a/libraries/chain/include/eosio/chain/authorization_manager.hpp +++ b/libraries/chain/include/eosio/chain/authorization_manager.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/block.hpp b/libraries/chain/include/eosio/chain/block.hpp index 28c49f9772e..9cd942026cf 100644 --- a/libraries/chain/include/eosio/chain/block.hpp +++ b/libraries/chain/include/eosio/chain/block.hpp @@ -19,22 +19,22 @@ namespace eosio { namespace chain { }; transaction_receipt_header():status(hard_fail){} - transaction_receipt_header( status_enum s ):status(s){} + explicit transaction_receipt_header( status_enum s ):status(s){} friend inline bool operator ==( const transaction_receipt_header& lhs, const transaction_receipt_header& rhs ) { return std::tie(lhs.status, lhs.cpu_usage_us, lhs.net_usage_words) == std::tie(rhs.status, rhs.cpu_usage_us, rhs.net_usage_words); } fc::enum_type status; - uint32_t cpu_usage_us; ///< total billed CPU usage (microseconds) + uint32_t cpu_usage_us = 0; ///< total billed CPU usage (microseconds) fc::unsigned_int net_usage_words; ///< total billed NET usage, so we can reconstruct resource state when skipping context free data... hard failures... }; struct transaction_receipt : public transaction_receipt_header { transaction_receipt():transaction_receipt_header(){} - transaction_receipt( transaction_id_type tid ):transaction_receipt_header(executed),trx(tid){} - transaction_receipt( packed_transaction ptrx ):transaction_receipt_header(executed),trx(ptrx){} + explicit transaction_receipt( const transaction_id_type& tid ):transaction_receipt_header(executed),trx(tid){} + explicit transaction_receipt( const packed_transaction& ptrx ):transaction_receipt_header(executed),trx(ptrx){} fc::static_variant trx; @@ -58,9 +58,14 @@ namespace eosio { namespace chain { /** */ struct signed_block : public signed_block_header { - using signed_block_header::signed_block_header; + private: + signed_block( const signed_block& ) = default; + public: signed_block() = default; - signed_block( const signed_block_header& h ):signed_block_header(h){} + explicit signed_block( const signed_block_header& h ):signed_block_header(h){} + signed_block( signed_block&& ) = default; + signed_block& operator=(const signed_block&) = delete; + signed_block clone() const { return *this; } vector transactions; /// new or generated transactions extensions_type block_extensions; diff --git a/libraries/chain/include/eosio/chain/block_log.hpp b/libraries/chain/include/eosio/chain/block_log.hpp index 24ff0ad2835..26e1dcb41fa 100644 --- a/libraries/chain/include/eosio/chain/block_log.hpp +++ b/libraries/chain/include/eosio/chain/block_log.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/block_state.hpp b/libraries/chain/include/eosio/chain/block_state.hpp index 6870d04f5b2..2292392ade4 100644 --- a/libraries/chain/include/eosio/chain/block_state.hpp +++ b/libraries/chain/include/eosio/chain/block_state.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/block_summary_object.hpp b/libraries/chain/include/eosio/chain/block_summary_object.hpp index d0224c9a9d5..0bb24ee7976 100644 --- a/libraries/chain/include/eosio/chain/block_summary_object.hpp +++ b/libraries/chain/include/eosio/chain/block_summary_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/chain_config.hpp b/libraries/chain/include/eosio/chain/chain_config.hpp index 649d11a3cdd..da258010fbb 100644 --- a/libraries/chain/include/eosio/chain/chain_config.hpp +++ b/libraries/chain/include/eosio/chain/chain_config.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/chain_id_type.hpp b/libraries/chain/include/eosio/chain/chain_id_type.hpp index 3b583a65997..a16fc143ae6 100644 --- a/libraries/chain/include/eosio/chain/chain_id_type.hpp +++ b/libraries/chain/include/eosio/chain/chain_id_type.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once @@ -34,7 +34,7 @@ namespace chain { return ds; } - void reflector_verify()const; + void reflector_init()const; private: chain_id_type() = default; diff --git a/libraries/chain/include/eosio/chain/chain_snapshot.hpp b/libraries/chain/include/eosio/chain/chain_snapshot.hpp index 7174e69c5b9..3b3e64f264f 100644 --- a/libraries/chain/include/eosio/chain/chain_snapshot.hpp +++ b/libraries/chain/include/eosio/chain/chain_snapshot.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/config.hpp b/libraries/chain/include/eosio/chain/config.hpp index 4fb86f86ae8..f34b7702095 100644 --- a/libraries/chain/include/eosio/chain/config.hpp +++ b/libraries/chain/include/eosio/chain/config.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -80,6 +80,7 @@ const static uint32_t default_max_trx_delay = 45*24*3600; // const static uint32_t default_max_inline_action_size = 4 * 1024; // 4 KB const static uint16_t default_max_inline_action_depth = 4; const static uint16_t default_max_auth_depth = 6; +const static uint32_t default_sig_cpu_bill_pct = 50 * percent_1; // billable percentage of signature recovery const static uint16_t default_controller_thread_pool_size = 2; const static uint32_t min_net_usage_delta_between_base_and_max_for_trx = 10*1024; diff --git a/libraries/chain/include/eosio/chain/contract_table_objects.hpp b/libraries/chain/include/eosio/chain/contract_table_objects.hpp index 8be51a98daf..dc6b25b0501 100644 --- a/libraries/chain/include/eosio/chain/contract_table_objects.hpp +++ b/libraries/chain/include/eosio/chain/contract_table_objects.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/controller.hpp b/libraries/chain/include/eosio/chain/controller.hpp index 62251d08512..ac3581f580f 100644 --- a/libraries/chain/include/eosio/chain/controller.hpp +++ b/libraries/chain/include/eosio/chain/controller.hpp @@ -11,7 +11,9 @@ namespace chainbase { class database; } - +namespace boost { namespace asio { + class thread_pool; +}} namespace eosio { namespace chain { @@ -32,6 +34,7 @@ namespace eosio { namespace chain { class account_object; using resource_limits::resource_limits_manager; using apply_handler = std::function; + using unapplied_transactions_type = map; class fork_database; @@ -79,6 +82,7 @@ namespace eosio { namespace chain { uint64_t state_guard_size = chain::config::default_state_guard_size; uint64_t reversible_cache_size = chain::config::default_reversible_cache_size; uint64_t reversible_guard_size = chain::config::default_reversible_guard_size; + uint32_t sig_cpu_bill_pct = chain::config::default_sig_cpu_bill_pct; uint16_t thread_pool_size = chain::config::default_controller_thread_pool_size; bool read_only = false; bool force_all_checks = false; @@ -103,7 +107,7 @@ namespace eosio { namespace chain { incomplete = 3, ///< this is an incomplete block (either being produced by a producer or speculatively produced by a node) }; - controller( const config& cfg ); + explicit controller( const config& cfg ); ~controller(); void add_indices(); @@ -124,22 +128,9 @@ namespace eosio { namespace chain { * The caller is responsible for calling drop_unapplied_transaction on a failing transaction that * they never intend to retry * - * @return vector of transactions which have been unapplied + * @return map of transactions which have been unapplied */ - vector get_unapplied_transactions() const; - void drop_unapplied_transaction(const transaction_metadata_ptr& trx); - void drop_all_unapplied_transactions(); - - /** - * These transaction IDs represent transactions available in the head chain state as scheduled - * or otherwise generated transactions. - * - * calling push_scheduled_transaction with these IDs will remove the associated transaction from - * the chain state IFF it succeeds or objectively fails - * - * @return - */ - vector get_scheduled_transactions() const; + unapplied_transactions_type& get_unapplied_transactions(); /** * @@ -160,6 +151,8 @@ namespace eosio { namespace chain { std::future create_block_state_future( const signed_block_ptr& b ); void push_block( std::future& block_state_future ); + boost::asio::thread_pool& get_thread_pool(); + const chainbase::database& db()const; const fork_database& fork_db()const; diff --git a/libraries/chain/include/eosio/chain/core_symbol.hpp.in b/libraries/chain/include/eosio/chain/core_symbol.hpp.in index ee8e368296d..c07f1ae267d 100644 --- a/libraries/chain/include/eosio/chain/core_symbol.hpp.in +++ b/libraries/chain/include/eosio/chain/core_symbol.hpp.in @@ -1,5 +1,5 @@ /** @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See core_symbol.hpp.in for changes. */ diff --git a/libraries/chain/include/eosio/chain/database_utils.hpp b/libraries/chain/include/eosio/chain/database_utils.hpp index eee26bce1c0..19de97bd3da 100644 --- a/libraries/chain/include/eosio/chain/database_utils.hpp +++ b/libraries/chain/include/eosio/chain/database_utils.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/eosio_contract.hpp b/libraries/chain/include/eosio/chain/eosio_contract.hpp index 88566b30982..1bf9163827e 100644 --- a/libraries/chain/include/eosio/chain/eosio_contract.hpp +++ b/libraries/chain/include/eosio/chain/eosio_contract.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/exceptions.hpp b/libraries/chain/include/eosio/chain/exceptions.hpp index 01a42793e94..6c3e504d349 100644 --- a/libraries/chain/include/eosio/chain/exceptions.hpp +++ b/libraries/chain/include/eosio/chain/exceptions.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/fixed_key.hpp b/libraries/chain/include/eosio/chain/fixed_key.hpp index 1839225a4f9..5dd90f901ad 100644 --- a/libraries/chain/include/eosio/chain/fixed_key.hpp +++ b/libraries/chain/include/eosio/chain/fixed_key.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/generated_transaction_object.hpp b/libraries/chain/include/eosio/chain/generated_transaction_object.hpp index 6d3e74dd558..24db926b4a8 100644 --- a/libraries/chain/include/eosio/chain/generated_transaction_object.hpp +++ b/libraries/chain/include/eosio/chain/generated_transaction_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/genesis_state.hpp b/libraries/chain/include/eosio/chain/genesis_state.hpp index 7b1da43043f..364f505629e 100644 --- a/libraries/chain/include/eosio/chain/genesis_state.hpp +++ b/libraries/chain/include/eosio/chain/genesis_state.hpp @@ -1,7 +1,7 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/global_property_object.hpp b/libraries/chain/include/eosio/chain/global_property_object.hpp index 6f4f35ffd80..bdb49d3ce06 100644 --- a/libraries/chain/include/eosio/chain/global_property_object.hpp +++ b/libraries/chain/include/eosio/chain/global_property_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/multi_index_includes.hpp b/libraries/chain/include/eosio/chain/multi_index_includes.hpp index 5d2deaf04d0..2bb5485194c 100644 --- a/libraries/chain/include/eosio/chain/multi_index_includes.hpp +++ b/libraries/chain/include/eosio/chain/multi_index_includes.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/parallel_markers.hpp b/libraries/chain/include/eosio/chain/parallel_markers.hpp index c78ebdabdae..7436f970630 100644 --- a/libraries/chain/include/eosio/chain/parallel_markers.hpp +++ b/libraries/chain/include/eosio/chain/parallel_markers.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/permission_link_object.hpp b/libraries/chain/include/eosio/chain/permission_link_object.hpp index 9930b647ad8..b7b4ea76f57 100644 --- a/libraries/chain/include/eosio/chain/permission_link_object.hpp +++ b/libraries/chain/include/eosio/chain/permission_link_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/permission_object.hpp b/libraries/chain/include/eosio/chain/permission_object.hpp index ee43f0e52a7..7db580b74d8 100644 --- a/libraries/chain/include/eosio/chain/permission_object.hpp +++ b/libraries/chain/include/eosio/chain/permission_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/producer_object.hpp b/libraries/chain/include/eosio/chain/producer_object.hpp index a2bb729dcc2..61d23870280 100644 --- a/libraries/chain/include/eosio/chain/producer_object.hpp +++ b/libraries/chain/include/eosio/chain/producer_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/protocol.hpp b/libraries/chain/include/eosio/chain/protocol.hpp index 134f953fb85..389e9c08723 100644 --- a/libraries/chain/include/eosio/chain/protocol.hpp +++ b/libraries/chain/include/eosio/chain/protocol.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/resource_limits_private.hpp b/libraries/chain/include/eosio/chain/resource_limits_private.hpp index 877c77e5acb..0bbe7e0e3e1 100644 --- a/libraries/chain/include/eosio/chain/resource_limits_private.hpp +++ b/libraries/chain/include/eosio/chain/resource_limits_private.hpp @@ -287,10 +287,10 @@ CHAINBASE_SET_INDEX_TYPE(eosio::chain::resource_limits::gmr_config_object, eosio FC_REFLECT(eosio::chain::resource_limits::usage_accumulator, (last_ordinal)(value_ex)(consumed)) +// @ignore pending FC_REFLECT(eosio::chain::resource_limits::resource_limits_object, (owner)(net_weight)(cpu_weight)(ram_bytes)) FC_REFLECT(eosio::chain::resource_limits::resource_usage_object, (owner)(net_usage)(cpu_usage)(ram_usage)) FC_REFLECT(eosio::chain::resource_limits::resource_limits_config_object, (cpu_limit_parameters)(net_limit_parameters)(account_cpu_usage_average_window)(account_net_usage_average_window)) FC_REFLECT(eosio::chain::resource_limits::resource_limits_state_object, (average_block_net_usage)(average_block_cpu_usage)(pending_net_usage)(pending_cpu_usage)(total_net_weight)(total_cpu_weight)(total_ram_bytes)(virtual_net_limit)(virtual_cpu_limit)) - - FC_REFLECT(eosio::chain::resource_limits::gmr_config_object, (res_parameters)) + diff --git a/libraries/chain/include/eosio/chain/reversible_block_object.hpp b/libraries/chain/include/eosio/chain/reversible_block_object.hpp index e0502b7e72f..ea9a4c9e122 100644 --- a/libraries/chain/include/eosio/chain/reversible_block_object.hpp +++ b/libraries/chain/include/eosio/chain/reversible_block_object.hpp @@ -1,7 +1,7 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/snapshot.hpp b/libraries/chain/include/eosio/chain/snapshot.hpp index 47f69dd07e2..499fbe29960 100644 --- a/libraries/chain/include/eosio/chain/snapshot.hpp +++ b/libraries/chain/include/eosio/chain/snapshot.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/symbol.hpp b/libraries/chain/include/eosio/chain/symbol.hpp index 3d6a4f72b35..437b1d36ab7 100644 --- a/libraries/chain/include/eosio/chain/symbol.hpp +++ b/libraries/chain/include/eosio/chain/symbol.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -137,7 +137,7 @@ namespace eosio { return ds << s.to_string(); } - void reflector_verify()const { + void reflector_init()const { EOS_ASSERT( decimals() <= max_precision, symbol_type_exception, "precision ${p} should be <= 18", ("p", decimals()) ); EOS_ASSERT( valid_name(name()), symbol_type_exception, "invalid symbol: ${name}", ("name",name())); } diff --git a/libraries/chain/include/eosio/chain/thread_utils.hpp b/libraries/chain/include/eosio/chain/thread_utils.hpp new file mode 100644 index 00000000000..31b32cbd91f --- /dev/null +++ b/libraries/chain/include/eosio/chain/thread_utils.hpp @@ -0,0 +1,24 @@ +/** + * @file + * @copyright defined in eos/LICENSE.txt + */ +#pragma once + +#include +#include +#include +#include + +namespace eosio { namespace chain { + + // async on thread_pool and return future + template + auto async_thread_pool( boost::asio::thread_pool& thread_pool, F&& f ) { + auto task = std::make_shared>( std::forward( f ) ); + boost::asio::post( thread_pool, [task]() { (*task)(); } ); + return task->get_future(); + } + +} } // eosio::chain + + diff --git a/libraries/chain/include/eosio/chain/trace.hpp b/libraries/chain/include/eosio/chain/trace.hpp index 03750bd512e..58de120bdd8 100644 --- a/libraries/chain/include/eosio/chain/trace.hpp +++ b/libraries/chain/include/eosio/chain/trace.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/libraries/chain/include/eosio/chain/transaction.hpp b/libraries/chain/include/eosio/chain/transaction.hpp index 895d3ee4fb8..a8b53b98e0d 100644 --- a/libraries/chain/include/eosio/chain/transaction.hpp +++ b/libraries/chain/include/eosio/chain/transaction.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once @@ -58,11 +58,12 @@ namespace eosio { namespace chain { transaction_id_type id()const; digest_type sig_digest( const chain_id_type& chain_id, const vector& cfd = vector() )const; - flat_set get_signature_keys( const vector& signatures, + fc::microseconds get_signature_keys( const vector& signatures, const chain_id_type& chain_id, - const vector& cfd = vector(), - bool allow_duplicate_keys = false, - bool use_cache = true )const; + fc::time_point deadline, + const vector& cfd, + flat_set& recovered_pub_keys, + bool allow_duplicate_keys = false) const; uint32_t total_actions()const { return context_free_actions.size() + actions.size(); } account_name first_authorizor()const { @@ -84,15 +85,21 @@ namespace eosio { namespace chain { : transaction(std::move(trx)) , signatures(signatures) , context_free_data(context_free_data) - { - } + {} + signed_transaction( transaction&& trx, const vector& signatures, vector&& context_free_data) + : transaction(std::move(trx)) + , signatures(signatures) + , context_free_data(std::move(context_free_data)) + {} vector signatures; vector context_free_data; ///< for each context-free action, there is an entry here const signature_type& sign(const private_key_type& key, const chain_id_type& chain_id); signature_type sign(const private_key_type& key, const chain_id_type& chain_id)const; - flat_set get_signature_keys( const chain_id_type& chain_id, bool allow_duplicate_keys = false, bool use_cache = true )const; + fc::microseconds get_signature_keys( const chain_id_type& chain_id, fc::time_point deadline, + flat_set& recovered_pub_keys, + bool allow_duplicate_keys = false )const; }; struct packed_transaction { @@ -102,47 +109,65 @@ namespace eosio { namespace chain { }; packed_transaction() = default; - - explicit packed_transaction(const transaction& t, compression_type _compression = none) - { - set_transaction(t, _compression); - } + packed_transaction(packed_transaction&&) = default; + explicit packed_transaction(const packed_transaction&) = default; + packed_transaction& operator=(const packed_transaction&) = delete; + packed_transaction& operator=(packed_transaction&&) = default; explicit packed_transaction(const signed_transaction& t, compression_type _compression = none) - :signatures(t.signatures) + :signatures(t.signatures), compression(_compression), unpacked_trx(t) { - set_transaction(t, t.context_free_data, _compression); + local_pack_transaction(); + local_pack_context_free_data(); } explicit packed_transaction(signed_transaction&& t, compression_type _compression = none) - :signatures(std::move(t.signatures)) + :signatures(t.signatures), compression(_compression), unpacked_trx(std::move(t)) { - set_transaction(t, std::move(t.context_free_data), _compression); + local_pack_transaction(); + local_pack_context_free_data(); } + // used by abi_serializer + packed_transaction( bytes&& packed_txn, vector&& sigs, bytes&& packed_cfd, compression_type _compression ); + packed_transaction( bytes&& packed_txn, vector&& sigs, vector&& cfd, compression_type _compression ); + packed_transaction( transaction&& t, vector&& sigs, bytes&& packed_cfd, compression_type _compression ); + uint32_t get_unprunable_size()const; uint32_t get_prunable_size()const; digest_type packed_digest()const; + transaction_id_type id()const { return unpacked_trx.id(); } + bytes get_raw_transaction()const; + + time_point_sec expiration()const { return unpacked_trx.expiration; } + const vector& get_context_free_data()const { return unpacked_trx.context_free_data; } + const transaction& get_transaction()const { return unpacked_trx; } + const signed_transaction& get_signed_transaction()const { return unpacked_trx; } + const vector& get_signatures()const { return signatures; } + const fc::enum_type& get_compression()const { return compression; } + const bytes& get_packed_context_free_data()const { return packed_context_free_data; } + const bytes& get_packed_transaction()const { return packed_trx; } + + private: + void local_unpack_transaction(vector&& context_free_data); + void local_unpack_context_free_data(); + void local_pack_transaction(); + void local_pack_context_free_data(); + + friend struct fc::reflector; + friend struct fc::reflector_init_visitor; + void reflector_init(); + private: vector signatures; fc::enum_type compression; bytes packed_context_free_data; bytes packed_trx; - time_point_sec expiration()const; - transaction_id_type id()const; - transaction_id_type get_uncached_id()const; // thread safe - bytes get_raw_transaction()const; // thread safe - vector get_context_free_data()const; - transaction get_transaction()const; - signed_transaction get_signed_transaction()const; - void set_transaction(const transaction& t, compression_type _compression = none); - void set_transaction(const transaction& t, const vector& cfd, compression_type _compression = none); - private: - mutable optional unpacked_trx; // <-- intermediate buffer used to retrieve values - void local_unpack()const; + // cache unpacked trx, for thread safety do not modify after construction + signed_transaction unpacked_trx; }; using packed_transaction_ptr = std::shared_ptr; diff --git a/libraries/chain/include/eosio/chain/transaction_context.hpp b/libraries/chain/include/eosio/chain/transaction_context.hpp index 2e215f00ec2..b0327dafb18 100644 --- a/libraries/chain/include/eosio/chain/transaction_context.hpp +++ b/libraries/chain/include/eosio/chain/transaction_context.hpp @@ -33,7 +33,6 @@ namespace eosio { namespace chain { void init_for_input_trx( uint64_t packed_trx_unprunable_size, uint64_t packed_trx_prunable_size, - uint32_t num_signatures, bool skip_recording); void init_for_deferred_trx( fc::time_point published ); diff --git a/libraries/chain/include/eosio/chain/transaction_metadata.hpp b/libraries/chain/include/eosio/chain/transaction_metadata.hpp index c5eb0c790f4..6136580fa44 100644 --- a/libraries/chain/include/eosio/chain/transaction_metadata.hpp +++ b/libraries/chain/include/eosio/chain/transaction_metadata.hpp @@ -1,14 +1,20 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include #include #include +namespace boost { namespace asio { + class thread_pool; +}} + namespace eosio { namespace chain { +class transaction_metadata; +using transaction_metadata_ptr = std::shared_ptr; /** * This data structure should store context-free cached data about a transaction such as * packed/unpacked/compressed and recovered keys @@ -17,45 +23,38 @@ class transaction_metadata { public: transaction_id_type id; transaction_id_type signed_id; - signed_transaction trx; - packed_transaction packed_trx; + packed_transaction_ptr packed_trx; + fc::microseconds sig_cpu_usage; optional>> signing_keys; - std::future>> signing_keys_future; + std::future>> + signing_keys_future; bool accepted = false; bool implicit = false; bool scheduled = false; + transaction_metadata() = delete; + transaction_metadata(const transaction_metadata&) = delete; + transaction_metadata(transaction_metadata&&) = delete; + transaction_metadata operator=(transaction_metadata&) = delete; + transaction_metadata operator=(transaction_metadata&&) = delete; + explicit transaction_metadata( const signed_transaction& t, packed_transaction::compression_type c = packed_transaction::none ) - :trx(t),packed_trx(t, c) { - id = trx.id(); + :id(t.id()), packed_trx(std::make_shared(t, c)) { //raw_packed = fc::raw::pack( static_cast(trx) ); - signed_id = digest_type::hash(packed_trx); + signed_id = digest_type::hash(*packed_trx); } - explicit transaction_metadata( const packed_transaction& ptrx ) - :trx( ptrx.get_signed_transaction() ), packed_trx(ptrx) { - id = trx.id(); + explicit transaction_metadata( const packed_transaction_ptr& ptrx ) + :id(ptrx->id()), packed_trx(ptrx) { //raw_packed = fc::raw::pack( static_cast(trx) ); - signed_id = digest_type::hash(packed_trx); + signed_id = digest_type::hash(*packed_trx); } - const flat_set& recover_keys( const chain_id_type& chain_id ) { - // Unlikely for more than one chain_id to be used in one nodeos instance - if( !signing_keys || signing_keys->first != chain_id ) { - if( signing_keys_future.valid() ) { - signing_keys = signing_keys_future.get(); - if( signing_keys->first == chain_id ) { - return signing_keys->second; - } - } - signing_keys = std::make_pair( chain_id, trx.get_signature_keys( chain_id )); - } - return signing_keys->second; - } + const flat_set& recover_keys( const chain_id_type& chain_id ); - uint32_t total_actions()const { return trx.context_free_actions.size() + trx.actions.size(); } -}; + static void create_signing_keys_future( const transaction_metadata_ptr& mtrx, boost::asio::thread_pool& thread_pool, + const chain_id_type& chain_id, fc::microseconds time_limit ); -using transaction_metadata_ptr = std::shared_ptr; +}; } } // eosio::chain diff --git a/libraries/chain/include/eosio/chain/transaction_object.hpp b/libraries/chain/include/eosio/chain/transaction_object.hpp index 0d049267e8e..50a7eb62cdd 100644 --- a/libraries/chain/include/eosio/chain/transaction_object.hpp +++ b/libraries/chain/include/eosio/chain/transaction_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/include/eosio/chain/types.hpp b/libraries/chain/include/eosio/chain/types.hpp index 028b050a595..bddeb1dd553 100644 --- a/libraries/chain/include/eosio/chain/types.hpp +++ b/libraries/chain/include/eosio/chain/types.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -103,7 +103,22 @@ namespace eosio { namespace chain { */ class shared_blob : public shared_string { public: - shared_blob() = default; + shared_blob() = delete; + shared_blob(shared_blob&&) = default; + + shared_blob(const shared_blob& s) + :shared_string(s.get_allocator()) + { + assign(s.c_str(), s.size()); + } + + + shared_blob& operator=(const shared_blob& s) { + assign(s.c_str(), s.size()); + return *this; + } + + shared_blob& operator=(shared_blob&& ) = default; template shared_blob(InputIterator f, InputIterator l, const allocator_type& a) diff --git a/libraries/chain/include/eosio/chain/wasm_eosio_injection.hpp b/libraries/chain/include/eosio/chain/wasm_eosio_injection.hpp index f5ebf01c1f7..a67ca9ef696 100644 --- a/libraries/chain/include/eosio/chain/wasm_eosio_injection.hpp +++ b/libraries/chain/include/eosio/chain/wasm_eosio_injection.hpp @@ -272,7 +272,7 @@ namespace eosio { namespace chain { namespace wasm_injections { }; - struct call_depth_check { + struct call_depth_check_and_insert_checktime { static constexpr bool kills = true; static constexpr bool post = false; static int32_t global_idx; @@ -290,6 +290,7 @@ namespace eosio { namespace chain { namespace wasm_injections { injector_utils::add_import(*(arg.module), "call_depth_assert", assert_idx); wasm_ops::op_types<>::call_t call_assert; + wasm_ops::op_types<>::call_t call_checktime; wasm_ops::op_types<>::get_global_t get_global_inst; wasm_ops::op_types<>::set_global_t set_global_inst; @@ -301,6 +302,7 @@ namespace eosio { namespace chain { namespace wasm_injections { wasm_ops::op_types<>::else__t else_inst; call_assert.field = assert_idx; + call_checktime.field = checktime_injection::chktm_idx; get_global_inst.field = global_idx; set_global_inst.field = global_idx; const_inst.field = -1; @@ -334,6 +336,7 @@ namespace eosio { namespace chain { namespace wasm_injections { INSERT_INJECTED(const_inst); INSERT_INJECTED(add_inst); INSERT_INJECTED(set_global_inst); + INSERT_INJECTED(call_checktime); #undef INSERT_INJECTED } @@ -679,8 +682,8 @@ namespace eosio { namespace chain { namespace wasm_injections { }; struct pre_op_injectors : wasm_ops::op_types { - using call_t = wasm_ops::call ; - using call_indirect_t = wasm_ops::call_indirect ; + using call_t = wasm_ops::call ; + using call_indirect_t = wasm_ops::call_indirect ; // float binops using f32_add_t = wasm_ops::f32_add >; @@ -785,7 +788,7 @@ namespace eosio { namespace chain { namespace wasm_injections { // initialize static fields of injectors injector_utils::init( mod ); checktime_injection::init(); - call_depth_check::init(); + call_depth_check_and_insert_checktime::init(); } void inject() { diff --git a/libraries/chain/include/eosio/chain/wast_to_wasm.hpp b/libraries/chain/include/eosio/chain/wast_to_wasm.hpp index e77d23b1360..1493f2f99f7 100644 --- a/libraries/chain/include/eosio/chain/wast_to_wasm.hpp +++ b/libraries/chain/include/eosio/chain/wast_to_wasm.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/libraries/chain/transaction.cpp b/libraries/chain/transaction.cpp index 6e6639bac52..2724a31b28d 100644 --- a/libraries/chain/transaction.cpp +++ b/libraries/chain/transaction.cpp @@ -1,11 +1,12 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include #include #include +#include #include #include @@ -28,6 +29,7 @@ struct cached_pub_key { transaction_id_type trx_id; public_key_type pub_key; signature_type sig; + fc::microseconds cpu_usage; cached_pub_key(const cached_pub_key&) = delete; cached_pub_key() = delete; cached_pub_key& operator=(const cached_pub_key&) = delete; @@ -81,43 +83,55 @@ digest_type transaction::sig_digest( const chain_id_type& chain_id, const vector return enc.result(); } -flat_set transaction::get_signature_keys( const vector& signatures, - const chain_id_type& chain_id, const vector& cfd, bool allow_duplicate_keys, bool use_cache )const +fc::microseconds transaction::get_signature_keys( const vector& signatures, + const chain_id_type& chain_id, fc::time_point deadline, const vector& cfd, + flat_set& recovered_pub_keys, bool allow_duplicate_keys)const { try { using boost::adaptors::transformed; - constexpr size_t recovery_cache_size = 1000; - static thread_local recovery_cache_type recovery_cache; + constexpr size_t recovery_cache_size = 10000; + static recovery_cache_type recovery_cache; + static std::mutex cache_mtx; + + auto start = fc::time_point::now(); + recovered_pub_keys.clear(); const digest_type digest = sig_digest(chain_id, cfd); - flat_set recovered_pub_keys; + std::unique_lock lock(cache_mtx, std::defer_lock); + fc::microseconds sig_cpu_usage; for(const signature_type& sig : signatures) { + auto now = fc::time_point::now(); + EOS_ASSERT( now < deadline, tx_cpu_usage_exceeded, "transaction signature verification executed for too long", + ("now", now)("deadline", deadline)("start", start) ); public_key_type recov; - if( use_cache ) { - recovery_cache_type::index::type::iterator it = recovery_cache.get().find( sig ); - if( it == recovery_cache.get().end() || it->trx_id != id()) { - recov = public_key_type( sig, digest ); - recovery_cache.emplace_back(cached_pub_key{id(), recov, sig} ); //could fail on dup signatures; not a problem - } else { - recov = it->pub_key; - } - } else { + const auto& tid = id(); + lock.lock(); + recovery_cache_type::index::type::iterator it = recovery_cache.get().find( sig ); + if( it == recovery_cache.get().end() || it->trx_id != tid ) { + lock.unlock(); recov = public_key_type( sig, digest ); + fc::microseconds cpu_usage = fc::time_point::now() - start; + lock.lock(); + recovery_cache.emplace_back( cached_pub_key{tid, recov, sig, cpu_usage} ); //could fail on dup signatures; not a problem + sig_cpu_usage += cpu_usage; + } else { + recov = it->pub_key; + sig_cpu_usage += it->cpu_usage; } + lock.unlock(); bool successful_insertion = false; std::tie(std::ignore, successful_insertion) = recovered_pub_keys.insert(recov); EOS_ASSERT( allow_duplicate_keys || successful_insertion, tx_duplicate_sig, "transaction includes more than one signature signed using the same key associated with public key: ${key}", - ("key", recov) - ); + ("key", recov) ); } - if( use_cache ) { - while ( recovery_cache.size() > recovery_cache_size ) - recovery_cache.erase( recovery_cache.begin() ); - } + lock.lock(); + while ( recovery_cache.size() > recovery_cache_size ) + recovery_cache.erase( recovery_cache.begin()); + lock.unlock(); - return recovered_pub_keys; + return sig_cpu_usage; } FC_CAPTURE_AND_RETHROW() } @@ -130,9 +144,12 @@ signature_type signed_transaction::sign(const private_key_type& key, const chain return key.sign(sig_digest(chain_id, context_free_data)); } -flat_set signed_transaction::get_signature_keys( const chain_id_type& chain_id, bool allow_duplicate_keys, bool use_cache )const +fc::microseconds +signed_transaction::get_signature_keys( const chain_id_type& chain_id, fc::time_point deadline, + flat_set& recovered_pub_keys, + bool allow_duplicate_keys)const { - return transaction::get_signature_keys(signatures, chain_id, context_free_data, allow_duplicate_keys, use_cache); + return transaction::get_signature_keys(signatures, chain_id, deadline, context_free_data, recovered_pub_keys, allow_duplicate_keys); } uint32_t packed_transaction::get_unprunable_size()const { @@ -272,112 +289,115 @@ bytes packed_transaction::get_raw_transaction() const } FC_CAPTURE_AND_RETHROW((compression)(packed_trx)) } -vector packed_transaction::get_context_free_data()const +packed_transaction::packed_transaction( bytes&& packed_txn, vector&& sigs, bytes&& packed_cfd, compression_type _compression ) +:signatures(std::move(sigs)) +,compression(_compression) +,packed_context_free_data(std::move(packed_cfd)) +,packed_trx(std::move(packed_txn)) { - try { - switch(compression) { - case none: - return unpack_context_free_data(packed_context_free_data); - case zlib: - return zlib_decompress_context_free_data(packed_context_free_data); - default: - EOS_THROW(unknown_transaction_compression, "Unknown transaction compression algorithm"); - } - } FC_CAPTURE_AND_RETHROW((compression)(packed_context_free_data)) + local_unpack_transaction({}); + if( !packed_context_free_data.empty() ) { + local_unpack_context_free_data(); + } } -time_point_sec packed_transaction::expiration()const +packed_transaction::packed_transaction( bytes&& packed_txn, vector&& sigs, vector&& cfd, compression_type _compression ) +:signatures(std::move(sigs)) +,compression(_compression) +,packed_trx(std::move(packed_txn)) { - local_unpack(); - return unpacked_trx->expiration; + local_unpack_transaction( std::move( cfd ) ); + if( !unpacked_trx.context_free_data.empty() ) { + local_pack_context_free_data(); + } } -transaction_id_type packed_transaction::id()const +packed_transaction::packed_transaction( transaction&& t, vector&& sigs, bytes&& packed_cfd, compression_type _compression ) +:signatures(std::move(sigs)) +,compression(_compression) +,packed_context_free_data(std::move(packed_cfd)) +,unpacked_trx(std::move(t), signatures, {}) { - local_unpack(); - return get_transaction().id(); + local_pack_transaction(); + if( !packed_context_free_data.empty() ) { + local_unpack_context_free_data(); + } } -transaction_id_type packed_transaction::get_uncached_id()const +void packed_transaction::reflector_init() { - const auto raw = get_raw_transaction(); - return fc::raw::unpack( raw ).id(); + // called after construction, but always on the same thread and before packed_transaction passed to any other threads + static_assert(&fc::reflector_init_visitor::reflector_init, "FC with reflector_init required"); + static_assert(fc::raw::has_feature_reflector_init_on_unpacked_reflected_types, + "FC unpack needs to call reflector_init otherwise unpacked_trx will not be initialized"); + EOS_ASSERT( unpacked_trx.expiration == time_point_sec(), tx_decompression_error, "packed_transaction already unpacked" ); + local_unpack_transaction({}); + local_unpack_context_free_data(); } -void packed_transaction::local_unpack()const +void packed_transaction::local_unpack_transaction(vector&& context_free_data) { - if (!unpacked_trx) { - try { - switch(compression) { + try { + switch( compression ) { case none: - unpacked_trx = unpack_transaction(packed_trx); + unpacked_trx = signed_transaction( unpack_transaction( packed_trx ), signatures, std::move(context_free_data) ); break; case zlib: - unpacked_trx = zlib_decompress_transaction(packed_trx); + unpacked_trx = signed_transaction( zlib_decompress_transaction( packed_trx ), signatures, std::move(context_free_data) ); break; default: - EOS_THROW(unknown_transaction_compression, "Unknown transaction compression algorithm"); - } - } FC_CAPTURE_AND_RETHROW((compression)(packed_trx)) - } -} - -transaction packed_transaction::get_transaction()const -{ - local_unpack(); - return transaction(*unpacked_trx); + EOS_THROW( unknown_transaction_compression, "Unknown transaction compression algorithm" ); + } + } FC_CAPTURE_AND_RETHROW( (compression) ) } -signed_transaction packed_transaction::get_signed_transaction() const +void packed_transaction::local_unpack_context_free_data() { try { - switch(compression) { + EOS_ASSERT(unpacked_trx.context_free_data.empty(), tx_decompression_error, "packed_transaction.context_free_data not empty"); + switch( compression ) { case none: - return signed_transaction(get_transaction(), signatures, unpack_context_free_data(packed_context_free_data)); + unpacked_trx.context_free_data = unpack_context_free_data( packed_context_free_data ); + break; case zlib: - return signed_transaction(get_transaction(), signatures, zlib_decompress_context_free_data(packed_context_free_data)); + unpacked_trx.context_free_data = zlib_decompress_context_free_data( packed_context_free_data ); + break; default: - EOS_THROW(unknown_transaction_compression, "Unknown transaction compression algorithm"); + EOS_THROW( unknown_transaction_compression, "Unknown transaction compression algorithm" ); } - } FC_CAPTURE_AND_RETHROW((compression)(packed_trx)(packed_context_free_data)) - + } FC_CAPTURE_AND_RETHROW( (compression) ) } -void packed_transaction::set_transaction(const transaction& t, packed_transaction::compression_type _compression) +void packed_transaction::local_pack_transaction() { try { - switch(_compression) { + switch(compression) { case none: - packed_trx = pack_transaction(t); + packed_trx = pack_transaction(unpacked_trx); break; case zlib: - packed_trx = zlib_compress_transaction(t); + packed_trx = zlib_compress_transaction(unpacked_trx); break; default: EOS_THROW(unknown_transaction_compression, "Unknown transaction compression algorithm"); } - } FC_CAPTURE_AND_RETHROW((_compression)(t)) - packed_context_free_data.clear(); - compression = _compression; + } FC_CAPTURE_AND_RETHROW((compression)) } -void packed_transaction::set_transaction(const transaction& t, const vector& cfd, packed_transaction::compression_type _compression) +void packed_transaction::local_pack_context_free_data() { try { - switch(_compression) { + switch(compression) { case none: - packed_trx = pack_transaction(t); - packed_context_free_data = pack_context_free_data(cfd); + packed_context_free_data = pack_context_free_data(unpacked_trx.context_free_data); break; case zlib: - packed_trx = zlib_compress_transaction(t); - packed_context_free_data = zlib_compress_context_free_data(cfd); + packed_context_free_data = zlib_compress_context_free_data(unpacked_trx.context_free_data); break; default: EOS_THROW(unknown_transaction_compression, "Unknown transaction compression algorithm"); } - } FC_CAPTURE_AND_RETHROW((_compression)(t)) - compression = _compression; + } FC_CAPTURE_AND_RETHROW((compression)) } diff --git a/libraries/chain/transaction_context.cpp b/libraries/chain/transaction_context.cpp index 989905ef9a0..d5da8ca279b 100644 --- a/libraries/chain/transaction_context.cpp +++ b/libraries/chain/transaction_context.cpp @@ -284,7 +284,6 @@ namespace bacc = boost::accumulators; void transaction_context::init_for_input_trx( uint64_t packed_trx_unprunable_size, uint64_t packed_trx_prunable_size, - uint32_t num_signatures, bool skip_recording ) { const auto& cfg = control.get_global_properties().configuration; diff --git a/libraries/chain/transaction_metadata.cpp b/libraries/chain/transaction_metadata.cpp new file mode 100644 index 00000000000..2053669c0d7 --- /dev/null +++ b/libraries/chain/transaction_metadata.cpp @@ -0,0 +1,47 @@ +#include +#include +#include + +namespace eosio { namespace chain { + + +const flat_set& transaction_metadata::recover_keys( const chain_id_type& chain_id ) { + // Unlikely for more than one chain_id to be used in one nodeos instance + if( !signing_keys || signing_keys->first != chain_id ) { + if( signing_keys_future.valid() ) { + std::tuple> sig_keys = signing_keys_future.get(); + if( std::get<0>( sig_keys ) == chain_id ) { + sig_cpu_usage = std::get<1>( sig_keys ); + signing_keys.emplace( std::get<0>( sig_keys ), std::move( std::get<2>( sig_keys ))); + return signing_keys->second; + } + } + flat_set recovered_pub_keys; + sig_cpu_usage = packed_trx->get_signed_transaction().get_signature_keys( chain_id, fc::time_point::maximum(), recovered_pub_keys ); + signing_keys.emplace( chain_id, std::move( recovered_pub_keys )); + } + return signing_keys->second; +} + +void transaction_metadata::create_signing_keys_future( const transaction_metadata_ptr& mtrx, + boost::asio::thread_pool& thread_pool, const chain_id_type& chain_id, fc::microseconds time_limit ) { + if( mtrx->signing_keys.valid() ) // already created + return; + + std::weak_ptr mtrx_wp = mtrx; + mtrx->signing_keys_future = async_thread_pool( thread_pool, [time_limit, chain_id, mtrx_wp]() { + fc::time_point deadline = time_limit == fc::microseconds::maximum() ? + fc::time_point::maximum() : fc::time_point::now() + time_limit; + auto mtrx = mtrx_wp.lock(); + fc::microseconds cpu_usage; + flat_set recovered_pub_keys; + if( mtrx ) { + const signed_transaction& trn = mtrx->packed_trx->get_signed_transaction(); + cpu_usage = trn.get_signature_keys( chain_id, deadline, recovered_pub_keys ); + } + return std::make_tuple( chain_id, cpu_usage, std::move( recovered_pub_keys )); + } ); +} + + +} } // eosio::chain diff --git a/libraries/chain/wasm_eosio_injection.cpp b/libraries/chain/wasm_eosio_injection.cpp index a4afa44d46d..2c627e13ea7 100644 --- a/libraries/chain/wasm_eosio_injection.cpp +++ b/libraries/chain/wasm_eosio_injection.cpp @@ -35,7 +35,7 @@ void max_memory_injection_visitor::inject( Module& m ) { } void max_memory_injection_visitor::initializer() {} -int32_t call_depth_check::global_idx = -1; +int32_t call_depth_check_and_insert_checktime::global_idx = -1; uint32_t instruction_counter::icnt = 0; uint32_t instruction_counter::tcnt = 0; uint32_t instruction_counter::bcnt = 0; diff --git a/libraries/chain/wasm_interface.cpp b/libraries/chain/wasm_interface.cpp index 9204f3d27bb..7d3553e379b 100644 --- a/libraries/chain/wasm_interface.cpp +++ b/libraries/chain/wasm_interface.cpp @@ -22,6 +22,7 @@ #include #include #include +#include namespace eosio { namespace chain { using namespace webassembly; @@ -937,6 +938,8 @@ class system_api : public context_aware_api { }; +constexpr size_t max_assert_message = 1024; + class context_free_system_api : public context_aware_api { public: explicit context_free_system_api( apply_context& ctx ) @@ -949,14 +952,16 @@ class context_free_system_api : public context_aware_api { // Kept as intrinsic rather than implementing on WASM side (using eosio_assert_message and strlen) because strlen is faster on native side. void eosio_assert( bool condition, null_terminated_ptr msg ) { if( BOOST_UNLIKELY( !condition ) ) { - std::string message( msg ); + const size_t sz = strnlen( msg, max_assert_message ); + std::string message( msg, sz ); EOS_THROW( eosio_assert_message_exception, "assertion failure with message: ${s}", ("s",message) ); } } void eosio_assert_message( bool condition, array_ptr msg, size_t msg_len ) { if( BOOST_UNLIKELY( !condition ) ) { - std::string message( msg, msg_len ); + const size_t sz = msg_len > max_assert_message ? max_assert_message : msg_len; + std::string message( msg, sz ); EOS_THROW( eosio_assert_message_exception, "assertion failure with message: ${s}", ("s",message) ); } } @@ -1099,12 +1104,16 @@ class console_api : public context_aware_api { auto& console = context.get_console_stream(); auto orig_prec = console.precision(); +#ifdef __x86_64__ console.precision( std::numeric_limits::digits10 ); - extFloat80_t val_approx; f128M_to_extF80M(&val, &val_approx); context.console_append( *(long double*)(&val_approx) ); - +#else + console.precision( std::numeric_limits::digits10 ); + double val_approx = from_softfloat64( f128M_to_f64(&val) ); + context.console_append(val_approx); +#endif console.precision( orig_prec ); } } diff --git a/libraries/chain/wast_to_wasm.cpp b/libraries/chain/wast_to_wasm.cpp index 6a2ca2e1bbc..09add7a0b6e 100644 --- a/libraries/chain/wast_to_wasm.cpp +++ b/libraries/chain/wast_to_wasm.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/libraries/fc b/libraries/fc index e5ad1ad65b0..b2fa419ddf6 160000 --- a/libraries/fc +++ b/libraries/fc @@ -1 +1 @@ -Subproject commit e5ad1ad65b012103222a113239a28fc1e4bddbb4 +Subproject commit b2fa419ddf68c6b5fc902de53cf8e691206cc8f3 diff --git a/libraries/testing/include/eosio/testing/tester.hpp b/libraries/testing/include/eosio/testing/tester.hpp index 906d2cb3c44..5f0a5206fdc 100644 --- a/libraries/testing/include/eosio/testing/tester.hpp +++ b/libraries/testing/include/eosio/testing/tester.hpp @@ -99,6 +99,17 @@ namespace eosio { namespace testing { void produce_min_num_of_blocks_to_spend_time_wo_inactive_prod(const fc::microseconds target_elapsed_time = fc::microseconds()); signed_block_ptr push_block(signed_block_ptr b); + /** + * These transaction IDs represent transactions available in the head chain state as scheduled + * or otherwise generated transactions. + * + * calling push_scheduled_transaction with these IDs will remove the associated transaction from + * the chain state IFF it succeeds or objectively fails + * + * @return + */ + vector get_scheduled_transactions() const; + transaction_trace_ptr push_transaction( packed_transaction& trx, fc::time_point deadline = fc::time_point::maximum(), uint32_t billed_cpu_time_us = DEFAULT_BILLED_CPU_TIME_US ); transaction_trace_ptr push_transaction( signed_transaction& trx, fc::time_point deadline = fc::time_point::maximum(), uint32_t billed_cpu_time_us = DEFAULT_BILLED_CPU_TIME_US ); action_result push_action(action&& cert_act, uint64_t authorizer); // TODO/QUESTION: Is this needed? diff --git a/libraries/testing/tester.cpp b/libraries/testing/tester.cpp index a2307904da3..a632cb40643 100644 --- a/libraries/testing/tester.cpp +++ b/libraries/testing/tester.cpp @@ -3,6 +3,7 @@ #include #include #include +#include #include #include @@ -163,16 +164,16 @@ namespace eosio { namespace testing { } if( !skip_pending_trxs ) { - auto unapplied_trxs = control->get_unapplied_transactions(); - for (const auto& trx : unapplied_trxs ) { - auto trace = control->push_transaction(trx, fc::time_point::maximum()); + unapplied_transactions_type unapplied_trxs = control->get_unapplied_transactions(); // make copy of map + for (const auto& entry : unapplied_trxs ) { + auto trace = control->push_transaction(entry.second, fc::time_point::maximum()); if(trace->except) { trace->except->dynamic_rethrow_exception(); } } vector scheduled_trxs; - while( (scheduled_trxs = control->get_scheduled_transactions() ).size() > 0 ) { + while( (scheduled_trxs = get_scheduled_transactions() ).size() > 0 ) { for (const auto& trx : scheduled_trxs ) { auto trace = control->push_scheduled_transaction(trx, fc::time_point::maximum()); if(trace->except) { @@ -237,6 +238,18 @@ namespace eosio { namespace testing { } } + vector base_tester::get_scheduled_transactions() const { + const auto& idx = control->db().get_index(); + + vector result; + + auto itr = idx.begin(); + while( itr != idx.end() && itr->delay_until <= control->pending_block_time() ) { + result.emplace_back(itr->trx_id); + ++itr; + } + return result; + } void base_tester::produce_blocks_until_end_of_round() { uint64_t blocks_per_round; @@ -333,7 +346,7 @@ namespace eosio { namespace testing { { try { if( !control->pending_block_state() ) _start_block(control->head_block_time() + fc::microseconds(config::block_interval_us)); - auto r = control->push_transaction( std::make_shared(trx), deadline, billed_cpu_time_us ); + auto r = control->push_transaction( std::make_shared(std::make_shared(trx)), deadline, billed_cpu_time_us ); if( r->except_ptr ) std::rethrow_exception( r->except_ptr ); if( r->except ) throw *r->except; return r; diff --git a/plugins/COMMUNITY.md b/plugins/COMMUNITY.md index db7d2139d83..55cce74a33b 100644 --- a/plugins/COMMUNITY.md +++ b/plugins/COMMUNITY.md @@ -13,6 +13,10 @@ Third parties are encouraged to make pull requests to this file (`develop` branc | SQL | https://github.com/asiniscalchi/eosio_sql_plugin | | Watch for specific actions and send them to an HTTP URL | https://github.com/eosauthority/eosio-watcher-plugin | | ZMQ / history | https://github.com/cc32d9/eos_zmq_plugin | +| ZMQ Light History API | https://github.com/cc32d9/eos_zmq_light_api | +| Chintai ZMQ Watcher | https://github.com/acoutts/chintai-zeromq-watcher-plugin | +| Mongo History API | https://github.com/CryptoLions/EOS-mongo-history-API | +| State History API | https://github.com/acoutts/EOS-state-history-API | ## DISCLAIMER: diff --git a/plugins/bnet_plugin/bnet_plugin.cpp b/plugins/bnet_plugin/bnet_plugin.cpp index 392df4b31eb..b25631cbabc 100644 --- a/plugins/bnet_plugin/bnet_plugin.cpp +++ b/plugins/bnet_plugin/bnet_plugin.cpp @@ -441,7 +441,7 @@ namespace eosio { if( itr != _transaction_status.end() ) { if( !itr->known_by_peer() ) { _transaction_status.modify( itr, [&]( auto& stat ) { - stat.expired = std::min( fc::time_point::now() + fc::seconds(5), t->trx.expiration ); + stat.expired = std::min( fc::time_point::now() + fc::seconds(5), t->packed_trx->expiration() ); }); } return; @@ -555,8 +555,7 @@ namespace eosio { for( const auto& receipt : s->block->transactions ) { if( receipt.trx.which() == 1 ) { const auto& pt = receipt.trx.get(); - // get id via get_uncached_id() as packed_transaction.id() mutates internal transaction state - const auto& tid = pt.get_uncached_id(); + const auto& tid = pt.id(); auto itr = _transaction_status.find( tid ); if( itr != _transaction_status.end() ) _transaction_status.erase(itr); @@ -765,7 +764,7 @@ namespace eosio { return false; - auto ptrx_ptr = std::make_shared( start->trx->packed_trx ); + auto ptrx_ptr = start->trx->packed_trx; idx.modify( start, [&]( auto& stat ) { stat.mark_known_by_peer(); @@ -1014,8 +1013,7 @@ namespace eosio { for( const auto& receipt : b->transactions ) { if( receipt.trx.which() == 1 ) { const auto& pt = receipt.trx.get(); - // get id via get_uncached_id() as packed_transaction.id() mutates internal transaction state - const auto& id = pt.get_uncached_id(); + const auto& id = pt.id(); mark_transaction_known_by_peer(id); } } @@ -1552,12 +1550,13 @@ namespace eosio { // ilog( "recv trx ${n}", ("n", id) ); if( p->expiration() < fc::time_point::now() ) return; - // get id via get_uncached_id() as packed_transaction.id() mutates internal transaction state - const auto& id = p->get_uncached_id(); + const auto& id = p->id(); if( mark_transaction_known_by_peer( id ) ) return; - app().get_channel().publish(p); + auto ptr = std::make_shared(p); + + app().get_channel().publish(ptr); } } /// namespace eosio diff --git a/plugins/bnet_plugin/include/eosio/bnet_plugin/bnet_plugin.hpp b/plugins/bnet_plugin/include/eosio/bnet_plugin/bnet_plugin.hpp index 5a749ea44ef..9eb3a54c9a4 100644 --- a/plugins/bnet_plugin/include/eosio/bnet_plugin/bnet_plugin.hpp +++ b/plugins/bnet_plugin/include/eosio/bnet_plugin/bnet_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/chain_api_plugin/chain_api_plugin.cpp b/plugins/chain_api_plugin/chain_api_plugin.cpp index f07e48a7f04..8b9fd3f843c 100644 --- a/plugins/chain_api_plugin/chain_api_plugin.cpp +++ b/plugins/chain_api_plugin/chain_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/chain_api_plugin/include/eosio/chain_api_plugin/chain_api_plugin.hpp b/plugins/chain_api_plugin/include/eosio/chain_api_plugin/chain_api_plugin.hpp index ad64fcaa1d3..9a854cf0b56 100644 --- a/plugins/chain_api_plugin/include/eosio/chain_api_plugin/chain_api_plugin.hpp +++ b/plugins/chain_api_plugin/include/eosio/chain_api_plugin/chain_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/chain_interface/include/eosio/chain/plugin_interface.hpp b/plugins/chain_interface/include/eosio/chain/plugin_interface.hpp index 7303768cab4..b62915b5220 100644 --- a/plugins/chain_interface/include/eosio/chain/plugin_interface.hpp +++ b/plugins/chain_interface/include/eosio/chain/plugin_interface.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once @@ -45,19 +45,19 @@ namespace eosio { namespace chain { namespace plugin_interface { namespace incoming { namespace channels { using block = channel_decl; - using transaction = channel_decl; + using transaction = channel_decl; } namespace methods { // synchronously push a block/trx to a single provider using block_sync = method_decl; - using transaction_async = method_decl), first_provider_policy>; + using transaction_async = method_decl), first_provider_policy>; } } namespace compat { namespace channels { - using transaction_ack = channel_decl>; + using transaction_ack = channel_decl>; } } diff --git a/plugins/chain_plugin/chain_plugin.cpp b/plugins/chain_plugin/chain_plugin.cpp index ad67318528b..91d130d3ec5 100644 --- a/plugins/chain_plugin/chain_plugin.cpp +++ b/plugins/chain_plugin/chain_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -218,6 +218,8 @@ void chain_plugin::set_program_options(options_description& cli, options_descrip ("chain-state-db-guard-size-mb", bpo::value()->default_value(config::default_state_guard_size / (1024 * 1024)), "Safely shut down node when free space remaining in the chain state database drops below this size (in MiB).") ("reversible-blocks-db-size-mb", bpo::value()->default_value(config::default_reversible_cache_size / (1024 * 1024)), "Maximum size (in MiB) of the reversible blocks database") ("reversible-blocks-db-guard-size-mb", bpo::value()->default_value(config::default_reversible_guard_size / (1024 * 1024)), "Safely shut down node when free space remaining in the reverseible blocks database drops below this size (in MiB).") + ("signature-cpu-billable-pct", bpo::value()->default_value(config::default_sig_cpu_bill_pct / config::percent_1), + "Percentage of actual signature recovery cpu to bill. Whole number percentages, e.g. 50 for 50%") ("chain-threads", bpo::value()->default_value(config::default_controller_thread_pool_size), "Number of worker threads in controller thread pool") ("contracts-console", bpo::bool_switch()->default_value(false), @@ -426,6 +428,11 @@ void chain_plugin::plugin_initialize(const variables_map& options) { "chain-threads ${num} must be greater than 0", ("num", my->chain_config->thread_pool_size) ); } + my->chain_config->sig_cpu_bill_pct = options.at("signature-cpu-billable-pct").as(); + EOS_ASSERT( my->chain_config->sig_cpu_bill_pct >= 0 && my->chain_config->sig_cpu_bill_pct <= 100, plugin_config_exception, + "signature-cpu-billable-pct must be 0 - 100, ${pct}", ("pct", my->chain_config->sig_cpu_bill_pct) ); + my->chain_config->sig_cpu_bill_pct *= config::percent_1; + if( my->wasm_runtime ) my->chain_config->wasm_runtime = *my->wasm_runtime; @@ -738,6 +745,8 @@ void chain_plugin::plugin_shutdown() { my->accepted_transaction_connection.reset(); my->applied_transaction_connection.reset(); my->accepted_confirmation_connection.reset(); + my->chain->get_thread_pool().stop(); + my->chain->get_thread_pool().join(); my->chain.reset(); } @@ -756,7 +765,11 @@ void chain_plugin::accept_block(const signed_block_ptr& block ) { } void chain_plugin::accept_transaction(const chain::packed_transaction& trx, next_function next) { - my->incoming_transaction_async_method(std::make_shared(trx), false, std::forward(next)); + my->incoming_transaction_async_method(std::make_shared(std::make_shared(trx)), false, std::forward(next)); +} + +void chain_plugin::accept_transaction(const chain::transaction_metadata_ptr& trx, next_function next) { + my->incoming_transaction_async_method(trx, false, std::forward(next)); } bool chain_plugin::block_is_on_preferred_chain(const block_id_type& block_id) { @@ -901,7 +914,7 @@ bool chain_plugin::import_reversible_blocks( const fc::path& reversible_dir, new_reversible.create( [&]( auto& ubo ) { ubo.blocknum = num; - ubo.set_block( std::make_shared(tmp) ); + ubo.set_block( std::make_shared(std::move(tmp)) ); }); end = num; } @@ -1526,9 +1539,9 @@ fc::variant read_only::get_block_header_state(const get_block_header_state_param return vo; } -void read_write::push_block(const read_write::push_block_params& params, next_function next) { +void read_write::push_block(read_write::push_block_params&& params, next_function next) { try { - app().get_method()(std::make_shared(params)); + app().get_method()(std::make_shared(std::move(params))); next(read_write::push_block_results{}); } catch ( boost::interprocess::bad_alloc& ) { chain_plugin::handle_db_exhaustion(); @@ -1540,18 +1553,19 @@ void read_write::push_transaction(const read_write::push_transaction_params& par try { auto pretty_input = std::make_shared(); auto resolver = make_resolver(this, abi_serializer_max_time); + transaction_metadata_ptr ptrx; try { abi_serializer::from_variant(params, *pretty_input, resolver, abi_serializer_max_time); + ptrx = std::make_shared( pretty_input ); } EOS_RETHROW_EXCEPTIONS(chain::packed_transaction_type_exception, "Invalid packed transaction") - app().get_method()(pretty_input, true, [this, next](const fc::static_variant& result) -> void{ + app().get_method()(ptrx, true, [this, next](const fc::static_variant& result) -> void{ if (result.contains()) { next(result.get()); } else { auto trx_trace_ptr = result.get(); try { - chain::transaction_id_type id = trx_trace_ptr->id; fc::variant output; try { output = db.to_variant_with_abi( *trx_trace_ptr, abi_serializer_max_time ); @@ -1559,6 +1573,7 @@ void read_write::push_transaction(const read_write::push_transaction_params& par output = *trx_trace_ptr; } + const chain::transaction_id_type& id = trx_trace_ptr->id; next(read_write::push_transaction_results{id, output}); } CATCH_AND_CALL(next); } diff --git a/plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp b/plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp index 832f0b24485..4a41d99455c 100644 --- a/plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp +++ b/plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -569,7 +569,7 @@ class read_write { using push_block_params = chain::signed_block; using push_block_results = empty; - void push_block(const push_block_params& params, chain::plugin_interface::next_function next); + void push_block(push_block_params&& params, chain::plugin_interface::next_function next); using push_transaction_params = fc::variant_object; struct push_transaction_results { @@ -664,6 +664,7 @@ class chain_plugin : public plugin { void accept_block( const chain::signed_block_ptr& block ); void accept_transaction(const chain::packed_transaction& trx, chain::plugin_interface::next_function next); + void accept_transaction(const chain::transaction_metadata_ptr& trx, chain::plugin_interface::next_function next); bool block_is_on_preferred_chain(const chain::block_id_type& block_id); diff --git a/plugins/db_size_api_plugin/db_size_api_plugin.cpp b/plugins/db_size_api_plugin/db_size_api_plugin.cpp index 13b717c0789..8eed8b388ed 100644 --- a/plugins/db_size_api_plugin/db_size_api_plugin.cpp +++ b/plugins/db_size_api_plugin/db_size_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/db_size_api_plugin/include/eosio/db_size_api_plugin/db_size_api_plugin.hpp b/plugins/db_size_api_plugin/include/eosio/db_size_api_plugin/db_size_api_plugin.hpp index 2b0b46bc7ff..54a2d8ef63b 100644 --- a/plugins/db_size_api_plugin/include/eosio/db_size_api_plugin/db_size_api_plugin.hpp +++ b/plugins/db_size_api_plugin/include/eosio/db_size_api_plugin/db_size_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/faucet_testnet_plugin/faucet_testnet_plugin.cpp b/plugins/faucet_testnet_plugin/faucet_testnet_plugin.cpp index 39374e692cd..d6f8f53e7b3 100644 --- a/plugins/faucet_testnet_plugin/faucet_testnet_plugin.cpp +++ b/plugins/faucet_testnet_plugin/faucet_testnet_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/faucet_testnet_plugin/include/eosio/faucet_testnet_plugin/faucet_testnet_plugin.hpp b/plugins/faucet_testnet_plugin/include/eosio/faucet_testnet_plugin/faucet_testnet_plugin.hpp index 849745044a1..f59b1ef9bb3 100644 --- a/plugins/faucet_testnet_plugin/include/eosio/faucet_testnet_plugin/faucet_testnet_plugin.hpp +++ b/plugins/faucet_testnet_plugin/include/eosio/faucet_testnet_plugin/faucet_testnet_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/history_api_plugin/history_api_plugin.cpp b/plugins/history_api_plugin/history_api_plugin.cpp index 286e97f6e54..67321fa58d0 100644 --- a/plugins/history_api_plugin/history_api_plugin.cpp +++ b/plugins/history_api_plugin/history_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -32,12 +32,15 @@ void history_api_plugin::plugin_initialize(const variables_map&) {} }} #define CHAIN_RO_CALL(call_name) CALL(history, ro_api, history_apis::read_only, call_name) +//#define CHAIN_RW_CALL(call_name) CALL(history, rw_api, history_apis::read_write, call_name) void history_api_plugin::plugin_startup() { ilog( "starting history_api_plugin" ); auto ro_api = app().get_plugin().get_read_only_api(); + //auto rw_api = app().get_plugin().get_read_write_api(); app().get_plugin().add_api({ +// CHAIN_RO_CALL(get_transaction), CHAIN_RO_CALL(get_actions), CHAIN_RO_CALL(get_transaction), CHAIN_RO_CALL(get_block_detail), diff --git a/plugins/history_api_plugin/include/eosio/history_api_plugin/history_api_plugin.hpp b/plugins/history_api_plugin/include/eosio/history_api_plugin/history_api_plugin.hpp index 52ac764a45d..5e6dd936e24 100644 --- a/plugins/history_api_plugin/include/eosio/history_api_plugin/history_api_plugin.hpp +++ b/plugins/history_api_plugin/include/eosio/history_api_plugin/history_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/history_plugin/history_plugin.cpp b/plugins/history_plugin/history_plugin.cpp index f3838726726..5ce12dba17f 100644 --- a/plugins/history_plugin/history_plugin.cpp +++ b/plugins/history_plugin/history_plugin.cpp @@ -505,10 +505,9 @@ namespace eosio { for (const auto &receipt: blk->transactions) { if (receipt.trx.contains()) { auto &pt = receipt.trx.get(); - auto mtrx = transaction_metadata(pt); - if (mtrx.id == result.id) { + if (pt.id() == result.id) { fc::mutable_variant_object r("receipt", receipt); - r("trx", chain.to_variant_with_abi(mtrx.trx, abi_serializer_max_time)); + r("trx", chain.to_variant_with_abi(pt.get_signed_transaction(), abi_serializer_max_time)); result.trx = move(r); break; } @@ -529,14 +528,14 @@ namespace eosio { for (const auto& receipt: blk->transactions) { if (receipt.trx.contains()) { auto& pt = receipt.trx.get(); - auto mtrx = transaction_metadata(pt); - if( txn_id_matched(mtrx.id) ) { - result.id = mtrx.id; + const auto& id = pt.id(); + if( txn_id_matched(id) ) { + result.id = id; result.last_irreversible_block = chain.last_irreversible_block_num(); result.block_num = *p.block_num_hint; result.block_time = blk->timestamp; fc::mutable_variant_object r("receipt", receipt); - r("trx", chain.to_variant_with_abi(mtrx.trx, abi_serializer_max_time)); + r("trx", chain.to_variant_with_abi(pt.get_signed_transaction(), abi_serializer_max_time)); result.trx = move(r); found = true; break; diff --git a/plugins/history_plugin/include/eosio/history_plugin/account_control_history_object.hpp b/plugins/history_plugin/include/eosio/history_plugin/account_control_history_object.hpp index 55aec70abe5..5005c279f5a 100644 --- a/plugins/history_plugin/include/eosio/history_plugin/account_control_history_object.hpp +++ b/plugins/history_plugin/include/eosio/history_plugin/account_control_history_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/history_plugin/include/eosio/history_plugin/history_plugin.hpp b/plugins/history_plugin/include/eosio/history_plugin/history_plugin.hpp index 838f9b24662..337bf97c239 100644 --- a/plugins/history_plugin/include/eosio/history_plugin/history_plugin.hpp +++ b/plugins/history_plugin/include/eosio/history_plugin/history_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/history_plugin/include/eosio/history_plugin/public_key_history_object.hpp b/plugins/history_plugin/include/eosio/history_plugin/public_key_history_object.hpp index 996aff7c04b..2e8e37f0049 100644 --- a/plugins/history_plugin/include/eosio/history_plugin/public_key_history_object.hpp +++ b/plugins/history_plugin/include/eosio/history_plugin/public_key_history_object.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/http_client_plugin/http_client_plugin.cpp b/plugins/http_client_plugin/http_client_plugin.cpp index dc27ac34681..cb9d7c8e580 100644 --- a/plugins/http_client_plugin/http_client_plugin.cpp +++ b/plugins/http_client_plugin/http_client_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/http_client_plugin/include/eosio/http_client_plugin/http_client_plugin.hpp b/plugins/http_client_plugin/include/eosio/http_client_plugin/http_client_plugin.hpp index b4bb8a5740e..95803bed1f8 100644 --- a/plugins/http_client_plugin/include/eosio/http_client_plugin/http_client_plugin.hpp +++ b/plugins/http_client_plugin/include/eosio/http_client_plugin/http_client_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/http_plugin/http_plugin.cpp b/plugins/http_plugin/http_plugin.cpp index d9be006bb45..c808c5bb99f 100644 --- a/plugins/http_plugin/http_plugin.cpp +++ b/plugins/http_plugin/http_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -548,6 +548,8 @@ namespace eosio { my->server.stop_listening(); if(my->https_server.is_listening()) my->https_server.stop_listening(); + if(my->unix_server.is_listening()) + my->unix_server.stop_listening(); } void http_plugin::add_handler(const string& url, const url_handler& handler) { @@ -561,6 +563,9 @@ namespace eosio { try { try { throw; + } catch (chain::unknown_block_exception& e) { + error_results results{400, "Unknown Block", error_results::error_info(e, verbose_http_errors)}; + cb( 400, fc::json::to_string( results )); } catch (chain::unsatisfied_authorization& e) { error_results results{401, "UnAuthorized", error_results::error_info(e, verbose_http_errors)}; cb( 401, fc::json::to_string( results )); diff --git a/plugins/http_plugin/include/eosio/http_plugin/http_plugin.hpp b/plugins/http_plugin/include/eosio/http_plugin/http_plugin.hpp index 7f9aedb01e4..c7bc1ebb2b6 100644 --- a/plugins/http_plugin/include/eosio/http_plugin/http_plugin.hpp +++ b/plugins/http_plugin/include/eosio/http_plugin/http_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/login_plugin/include/eosio/login_plugin/login_plugin.hpp b/plugins/login_plugin/include/eosio/login_plugin/login_plugin.hpp index 0bd5d59efed..29c2660c6f3 100644 --- a/plugins/login_plugin/include/eosio/login_plugin/login_plugin.hpp +++ b/plugins/login_plugin/include/eosio/login_plugin/login_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/login_plugin/login_plugin.cpp b/plugins/login_plugin/login_plugin.cpp index 5a7bc5eae3e..0aeac67dce4 100644 --- a/plugins/login_plugin/login_plugin.cpp +++ b/plugins/login_plugin/login_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/mongo_db_plugin/include/eosio/mongo_db_plugin/mongo_db_plugin.hpp b/plugins/mongo_db_plugin/include/eosio/mongo_db_plugin/mongo_db_plugin.hpp index b9456898b6d..3b636651056 100644 --- a/plugins/mongo_db_plugin/include/eosio/mongo_db_plugin/mongo_db_plugin.hpp +++ b/plugins/mongo_db_plugin/include/eosio/mongo_db_plugin/mongo_db_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/mongo_db_plugin/mongo_db_plugin.cpp b/plugins/mongo_db_plugin/mongo_db_plugin.cpp index 3ef0ee252ac..70327c3d96b 100644 --- a/plugins/mongo_db_plugin/mongo_db_plugin.cpp +++ b/plugins/mongo_db_plugin/mongo_db_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -570,6 +570,15 @@ void handle_mongo_exception( const std::string& desc, int line_num ) { } } +// custom oid to avoid monotonic throttling +// https://docs.mongodb.com/master/core/bulk-write-operations/#avoid-monotonic-throttling +bsoncxx::oid make_custom_oid() { + bsoncxx::oid x = bsoncxx::oid(); + const char* p = x.bytes(); + std::swap((short&)p[0], (short&)p[10]); + return x; +} + } // anonymous namespace void mongo_db_plugin_impl::purge_abi_cache() { @@ -725,7 +734,7 @@ void mongo_db_plugin_impl::_process_accepted_transaction( const chain::transacti using bsoncxx::builder::basic::make_array; namespace bbb = bsoncxx::builder::basic; - const auto& trx = t->trx; + const signed_transaction& trx = t->packed_trx->get_signed_transaction(); if( !filter_include( trx ) ) return; @@ -761,9 +770,10 @@ void mongo_db_plugin_impl::_process_accepted_transaction( const chain::transacti if( t->signing_keys.valid() ) { signing_keys_json = fc::json::to_string( t->signing_keys->second ); } else { - auto signing_keys = trx.get_signature_keys( *chain_id, false, false ); - if( !signing_keys.empty() ) { - signing_keys_json = fc::json::to_string( signing_keys ); + flat_set keys; + trx.get_signature_keys( *chain_id, fc::time_point::maximum(), keys, false ); + if( !keys.empty() ) { + signing_keys_json = fc::json::to_string( keys ); } } @@ -818,6 +828,9 @@ mongo_db_plugin_impl::add_action_trace( mongocxx::bulk_write& bulk_action_traces auto action_traces_doc = bsoncxx::builder::basic::document{}; const chain::base_action_trace& base = atrace; // without inline action traces + // improve data distributivity when using mongodb sharding + action_traces_doc.append( kvp( "_id", make_custom_oid() ) ); + auto v = to_variant_with_abi( base ); string json = fc::json::to_string( v ); try { @@ -1082,11 +1095,8 @@ void mongo_db_plugin_impl::_process_irreversible_block(const chain::block_state_ string trx_id_str; if( receipt.trx.contains() ) { const auto& pt = receipt.trx.get(); - // get id via get_raw_transaction() as packed_transaction.id() mutates internal transaction state - const auto& raw = pt.get_raw_transaction(); - const auto& trx = fc::raw::unpack( raw ); - if( !filter_include( trx ) ) continue; - const auto& id = trx.id(); + if( !filter_include( pt.get_signed_transaction() ) ) continue; + const auto& id = pt.id(); trx_id_str = id.str(); } else { const auto& id = receipt.trx.get(); @@ -1426,7 +1436,7 @@ void mongo_db_plugin_impl::init() { // action traces indexes auto action_traces = mongo_conn[db_name][action_traces_col]; - action_traces.create_index( bsoncxx::from_json( R"xxx({ "trx_id" : 1 })xxx" )); + action_traces.create_index( bsoncxx::from_json( R"xxx({ "block_num" : 1 })xxx" )); // pub_keys indexes auto pub_keys = mongo_conn[db_name][pub_keys_col]; diff --git a/plugins/net_api_plugin/include/eosio/net_api_plugin/net_api_plugin.hpp b/plugins/net_api_plugin/include/eosio/net_api_plugin/net_api_plugin.hpp index 57c5929777e..3c7e1e232ac 100644 --- a/plugins/net_api_plugin/include/eosio/net_api_plugin/net_api_plugin.hpp +++ b/plugins/net_api_plugin/include/eosio/net_api_plugin/net_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/net_api_plugin/net_api_plugin.cpp b/plugins/net_api_plugin/net_api_plugin.cpp index caa31bdad63..3b7327c4313 100644 --- a/plugins/net_api_plugin/net_api_plugin.cpp +++ b/plugins/net_api_plugin/net_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/net_plugin/include/eosio/net_plugin/net_plugin.hpp b/plugins/net_plugin/include/eosio/net_plugin/net_plugin.hpp index 2c7683ccb5e..d732b18cf0c 100644 --- a/plugins/net_plugin/include/eosio/net_plugin/net_plugin.hpp +++ b/plugins/net_plugin/include/eosio/net_plugin/net_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/net_plugin/include/eosio/net_plugin/protocol.hpp b/plugins/net_plugin/include/eosio/net_plugin/protocol.hpp index bbdd357eec7..76f11da2411 100644 --- a/plugins/net_plugin/include/eosio/net_plugin/protocol.hpp +++ b/plugins/net_plugin/include/eosio/net_plugin/protocol.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include @@ -147,11 +147,10 @@ struct request_p2p_message{ notice_message, request_message, sync_request_message, - signed_block, - packed_transaction, + signed_block, // which = 7 + packed_transaction, // which = 8 response_p2p_message, request_p2p_message>; - } // namespace eosio FC_REFLECT( eosio::select_ids, (mode)(pending)(ids) ) diff --git a/plugins/net_plugin/net_plugin.cpp b/plugins/net_plugin/net_plugin.cpp index 23b0c0ddb62..889eefb9ed0 100644 --- a/plugins/net_plugin/net_plugin.cpp +++ b/plugins/net_plugin/net_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include @@ -18,7 +18,6 @@ #include #include #include -#include #include #include #include @@ -26,7 +25,6 @@ #include #include #include -#include using namespace eosio::chain::plugin_interface::compat; @@ -42,13 +40,11 @@ namespace eosio { using boost::asio::ip::tcp; using boost::asio::ip::address_v4; using boost::asio::ip::host_name; - using boost::intrusive::rbtree; using boost::multi_index_container; using fc::time_point; using fc::time_point_sec; using eosio::chain::transaction_id_type; - namespace bip = boost::interprocess; class connection; @@ -60,40 +56,24 @@ namespace eosio { using socket_ptr = std::shared_ptr; - using net_message_ptr = shared_ptr; - struct node_transaction_state { transaction_id_type id; time_point_sec expires; /// time after which this may be purged. - /// Expires increased while the txn is - /// "in flight" to anoher peer - packed_transaction packed_txn; - vector serialized_txn; /// the received raw bundle uint32_t block_num = 0; /// block transaction was included in - uint32_t true_block = 0; /// used to reset block_uum when request is 0 - uint16_t requests = 0; /// the number of "in flight" requests for this txn + std::shared_ptr> serialized_txn; /// the received raw bundle }; - struct update_in_flight { - int32_t incr; - update_in_flight (int32_t delta) : incr (delta) {} - void operator() (node_transaction_state& nts) { - int32_t exp = nts.expires.sec_since_epoch(); - nts.expires = fc::time_point_sec (exp + incr * 60); - if( nts.requests == 0 ) { - nts.true_block = nts.block_num; - nts.block_num = 0; - } - nts.requests += incr; - if( nts.requests == 0 ) { - nts.block_num = nts.true_block; - } - } - } incr_in_flight(1), decr_in_flight(-1); - struct by_expiry; struct by_block_num; + struct sha256_less { + bool operator()( const sha256& lhs, const sha256& rhs ) const { + return + std::tie(lhs._hash[0], lhs._hash[1], lhs._hash[2], lhs._hash[3]) < + std::tie(rhs._hash[0], rhs._hash[1], rhs._hash[2], rhs._hash[3]); + } + }; + typedef multi_index_container< node_transaction_state, indexed_by< @@ -101,7 +81,8 @@ namespace eosio { tag< by_id >, member < node_transaction_state, transaction_id_type, - &node_transaction_state::id > >, + &node_transaction_state::id >, + sha256_less >, ordered_non_unique< tag< by_expiry >, member< node_transaction_state, @@ -149,7 +130,7 @@ namespace eosio { }; possible_connections allowed_connections{None}; - connection_ptr find_connection( string host )const; + connection_ptr find_connection(const string& host)const; std::set< connection_ptr > connections; bool done = false; @@ -173,6 +154,7 @@ namespace eosio { string user_agent_name; chain_plugin* chain_plug = nullptr; + producer_plugin* producer_plug = nullptr; int started_sessions = 0; node_transaction_index local_txns; @@ -183,34 +165,30 @@ namespace eosio { channels::transaction_ack::channel_type::handle incoming_transaction_ack_subscription; - void connect( connection_ptr c ); - void connect( connection_ptr c, tcp::resolver::iterator endpoint_itr ); - bool start_session( connection_ptr c ); - void start_listen_loop( ); - void start_read_message( connection_ptr c); + void connect(const connection_ptr& c); + void connect(const connection_ptr& c, tcp::resolver::iterator endpoint_itr); + bool start_session(const connection_ptr& c); + void start_listen_loop(); + void start_read_message(const connection_ptr& c); - void close( connection_ptr c ); + void close(const connection_ptr& c); size_t count_open_sockets() const; template - void send_all( const net_message &msg, VerifierFunc verify ); + void send_all( const std::shared_ptr>& send_buffer, VerifierFunc verify ); - void accepted_block_header(const block_state_ptr&); void accepted_block(const block_state_ptr&); - void irreversible_block(const block_state_ptr&); - void accepted_transaction(const transaction_metadata_ptr&); - void applied_transaction(const transaction_trace_ptr&); - void accepted_confirmation(const header_confirmation&); - - void transaction_ack(const std::pair&); + void transaction_ack(const std::pair&); bool is_valid( const handshake_message &msg); + void send_p2p_request(connection_ptr c); - void handle_message( connection_ptr c, const handshake_message &msg); - void handle_message( connection_ptr c, const chain_size_message &msg); - void handle_message( connection_ptr c, const go_away_message &msg ); + void handle_message(const connection_ptr& c, const handshake_message& msg); + void handle_message(const connection_ptr& c, const chain_size_message& msg); + void handle_message(const connection_ptr& c, const go_away_message& msg ); + /** \name Peer Timestamps * Time message handling * @{ @@ -224,21 +202,24 @@ namespace eosio { * floating-double arithmetic with rounding done by the hardware. * This is necessary in order to avoid overflow and preserve precision. */ - void handle_message( connection_ptr c, const time_message &msg); + void handle_message(const connection_ptr& c, const time_message& msg); /** @} */ - void handle_message( connection_ptr c, const notice_message &msg); - void handle_message( connection_ptr c, const request_message &msg); - void handle_message( connection_ptr c, const sync_request_message &msg); - void handle_message( connection_ptr c, const signed_block &msg); - void handle_message( connection_ptr c, const packed_transaction &msg); + void handle_message(const connection_ptr& c, const notice_message& msg); + void handle_message(const connection_ptr& c, const request_message& msg); + void handle_message(const connection_ptr& c, const sync_request_message& msg); + void handle_message(const connection_ptr& c, const signed_block& msg) = delete; // signed_block_ptr overload used instead + void handle_message(const connection_ptr& c, const signed_block_ptr& msg); + void handle_message(const connection_ptr& c, const packed_transaction& msg) = delete; // packed_transaction_ptr overload used instead + void handle_message(const connection_ptr& c, const packed_transaction_ptr& msg); void handle_message( connection_ptr c, const request_p2p_message &msg); void handle_message( connection_ptr c, const response_p2p_message &msg); void start_conn_timer(boost::asio::steady_timer::duration du, std::weak_ptr from_connection); - void start_txn_timer( ); - void start_monitors( ); + void start_txn_timer(); + void start_monitors(); - void expire_txns( ); + void expire_txns(); + void expire_local_txns(); void connection_monitor(std::weak_ptr from_connection); /** \name Peer Timestamps * Time message handling @@ -318,14 +299,16 @@ namespace eosio { */ constexpr auto def_send_buffer_size_mb = 4; constexpr auto def_send_buffer_size = 1024*1024*def_send_buffer_size_mb; + constexpr auto def_max_write_queue_size = def_send_buffer_size*10; + constexpr boost::asio::chrono::milliseconds def_read_delay_for_full_write_queue{100}; + constexpr auto def_max_reads_in_flight = 1000; + constexpr auto def_max_trx_in_progress_size = 100*1024*1024; // 100 MB constexpr auto def_max_clients = 25; // 0 for unlimited clients constexpr auto def_max_nodes_per_host = 1; constexpr auto def_conn_retry_wait = 30; constexpr auto def_txn_expire_wait = std::chrono::seconds(3); constexpr auto def_resp_expected_wait = std::chrono::seconds(5); constexpr auto def_sync_fetch_span = 100; - constexpr uint32_t def_max_just_send = 1500; // roughly 1 "mtu" - constexpr bool large_msg_notify = false; constexpr auto message_header_size = 4; @@ -352,34 +335,16 @@ namespace eosio { constexpr uint16_t net_version = proto_explicit_sync; - /** - * Index by id - * Index by is_known, block_num, validated_time, this is the order we will broadcast - * to peer. - * Index by is_noticed, validated_time - * - */ struct transaction_state { transaction_id_type id; - bool is_known_by_peer = false; ///< true if we sent or received this trx to this peer or received notice from peer - bool is_noticed_to_peer = false; ///< have we sent peer notice we know it (true if we receive from this peer) uint32_t block_num = 0; ///< the block number the transaction was included in time_point_sec expires; - time_point requested_time; /// in case we fetch large trx - }; - - struct update_txn_expiry { - time_point_sec new_expiry; - update_txn_expiry(time_point_sec e) : new_expiry(e) {} - void operator() (transaction_state& ts) { - ts.expires = new_expiry; - } }; typedef multi_index_container< transaction_state, indexed_by< - ordered_unique< tag, member >, + ordered_unique< tag, member, sha256_less >, ordered_non_unique< tag< by_expiry >, member< transaction_state,fc::time_point_sec,&transaction_state::expires >>, ordered_non_unique< tag, @@ -402,10 +367,7 @@ namespace eosio { }; struct update_request_time { - void operator() (struct transaction_state &ts) { - ts.requested_time = time_point::now(); - } - void operator () (struct eosio::peer_block_state &bs) { + void operator() (struct eosio::peer_block_state &bs) { bs.requested_time = time_point::now(); } } set_request_time; @@ -413,7 +375,7 @@ namespace eosio { typedef multi_index_container< eosio::peer_block_state, indexed_by< - ordered_unique< tag, member >, + ordered_unique< tag, member, sha256_less >, ordered_unique< tag, member > > > peer_block_state_index; @@ -423,9 +385,6 @@ namespace eosio { void operator() (eosio::peer_block_state& bs) { bs.is_known = true; } - void operator() (transaction_state& ts) { - ts.is_known_by_peer = true; - } } set_is_known; @@ -433,12 +392,7 @@ namespace eosio { uint32_t new_bnum; update_block_num(uint32_t bnum) : new_bnum(bnum) {} void operator() (node_transaction_state& nts) { - if (nts.requests ) { - nts.true_block = new_bnum; - } - else { - nts.block_num = new_bnum; - } + nts.block_num = new_bnum; } void operator() (transaction_state& ts) { ts.block_num = new_bnum; @@ -466,6 +420,86 @@ namespace eosio { static void populate(handshake_message &hello); }; + class queued_buffer : boost::noncopyable { + public: + void clear_write_queue() { + _write_queue.clear(); + _sync_write_queue.clear(); + _write_queue_size = 0; + } + + void clear_out_queue() { + while ( _out_queue.size() > 0 ) { + _out_queue.pop_front(); + } + } + + uint32_t write_queue_size() const { return _write_queue_size; } + + bool is_out_queue_empty() const { return _out_queue.empty(); } + + bool ready_to_send() const { + // if out_queue is not empty then async_write is in progress + return ((!_sync_write_queue.empty() || !_write_queue.empty()) && _out_queue.empty()); + } + + bool add_write_queue( const std::shared_ptr>& buff, + std::function callback, + bool to_sync_queue ) { + if( to_sync_queue ) { + _sync_write_queue.push_back( {buff, callback} ); + } else { + _write_queue.push_back( {buff, callback} ); + } + _write_queue_size += buff->size(); + if( _write_queue_size > 2 * def_max_write_queue_size ) { + return false; + } + return true; + } + + void fill_out_buffer( std::vector& bufs ) { + if( _sync_write_queue.size() > 0 ) { // always send msgs from sync_write_queue first + fill_out_buffer( bufs, _sync_write_queue ); + } else { // postpone real_time write_queue if sync queue is not empty + fill_out_buffer( bufs, _write_queue ); + EOS_ASSERT( _write_queue_size == 0, plugin_exception, "write queue size expected to be zero" ); + } + } + + void out_callback( boost::system::error_code ec, std::size_t w ) { + for( auto& m : _out_queue ) { + m.callback( ec, w ); + } + } + + private: + struct queued_write; + void fill_out_buffer( std::vector& bufs, + deque& w_queue ) { + while ( w_queue.size() > 0 ) { + auto& m = w_queue.front(); + bufs.push_back( boost::asio::buffer( *m.buff )); + _write_queue_size -= m.buff->size(); + _out_queue.emplace_back( m ); + w_queue.pop_front(); + } + } + + private: + struct queued_write { + std::shared_ptr> buff; + std::function callback; + }; + + uint32_t _write_queue_size = 0; + deque _write_queue; + deque _sync_write_queue; // sync_write_queue will be sent first + deque _out_queue; + + }; // queued_buffer + + class connection : public std::enable_shared_from_this { public: explicit connection( string endpoint ); @@ -481,14 +515,12 @@ namespace eosio { fc::message_buffer<1024*1024> pending_message_buffer; fc::optional outstanding_read_bytes; - vector blk_buffer; - struct queued_write { - std::shared_ptr> buff; - std::function callback; - }; - deque write_queue; - deque out_queue; + + queued_buffer buffer_queue; + + uint32_t reads_in_flight = 0; + uint32_t trx_in_progress_size = 0; fc::sha256 node_id; handshake_message last_handshake_recv; handshake_message last_handshake_sent; @@ -498,6 +530,7 @@ namespace eosio { uint16_t protocol_version = 0; string peer_addr; unique_ptr response_expected; + unique_ptr read_delay_timer; optional pending_fetch; go_away_reason no_retry = no_reason; block_id_type fork_head; @@ -539,10 +572,6 @@ namespace eosio { /** \name Peer Timestamps * Time message handling */ - /** @{ */ - /** \brief Convert an std::chrono nanosecond rep to a human readable string - */ - char* convert_tstamp(const tstamp& t); /** \brief Populate and queue time_message */ void send_time(); @@ -564,18 +593,22 @@ namespace eosio { const string peer_name(); - void txn_send_pending(const vector &ids); - void txn_send(const vector &txn_lis); + void txn_send_pending(const vector& ids); + void txn_send(const vector& txn_lis); void blk_send_branch(); - void blk_send(const vector &txn_lis); + void blk_send(const block_id_type& blkid); void stop_send(); void enqueue( const net_message &msg, bool trigger_send = true ); + void enqueue_block( const signed_block_ptr& sb, bool trigger_send = true, bool to_sync_queue = false ); + void enqueue_buffer( const std::shared_ptr>& send_buffer, + bool trigger_send, go_away_reason close_after_send, + bool to_sync_queue = false); void cancel_sync(go_away_reason); void flush_queues(); bool enqueue_sync_block(); - void request_sync_blocks (uint32_t start, uint32_t end); + void request_sync_blocks(uint32_t start, uint32_t end); void cancel_wait(); void sync_wait(); @@ -583,9 +616,10 @@ namespace eosio { void sync_timeout(boost::system::error_code ec); void fetch_timeout(boost::system::error_code ec); - void queue_write(std::shared_ptr> buff, + void queue_write(const std::shared_ptr>& buff, bool trigger_send, - std::function callback); + std::function callback, + bool to_sync_queue = false); void do_queue_write(); void send_p2p_request(bool discoverable); @@ -601,7 +635,7 @@ namespace eosio { */ bool process_next_message(net_plugin_impl& impl, uint32_t message_length); - bool add_peer_block(const peer_block_state &pbs); + bool add_peer_block(const peer_block_state& pbs); fc::optional _logger_variant; const fc::variant_object& get_logger_variant() { @@ -629,15 +663,35 @@ namespace eosio { } }; - struct msgHandler : public fc::visitor { + struct msg_handler : public fc::visitor { net_plugin_impl &impl; connection_ptr c; - msgHandler( net_plugin_impl &imp, connection_ptr conn) : impl(imp), c(conn) {} + msg_handler( net_plugin_impl &imp, const connection_ptr& conn) : impl(imp), c(conn) {} + + void operator()( const signed_block& msg ) const { + EOS_ASSERT( false, plugin_config_exception, "operator()(signed_block&&) should be called" ); + } + void operator()( signed_block& msg ) const { + EOS_ASSERT( false, plugin_config_exception, "operator()(signed_block&&) should be called" ); + } + void operator()( const packed_transaction& msg ) const { + EOS_ASSERT( false, plugin_config_exception, "operator()(packed_transaction&&) should be called" ); + } + void operator()( packed_transaction& msg ) const { + EOS_ASSERT( false, plugin_config_exception, "operator()(packed_transaction&&) should be called" ); + } + + void operator()( signed_block&& msg ) const { + impl.handle_message( c, std::make_shared( std::move( msg ) ) ); + } + void operator()( packed_transaction&& msg ) const { + impl.handle_message( c, std::make_shared( std::move( msg ) ) ); + } template - void operator()(const T &msg) const + void operator()( T&& msg ) const { - impl.handle_message( c, msg); + impl.handle_message( c, std::forward(msg) ); } }; @@ -665,37 +719,33 @@ namespace eosio { void set_state(stages s); bool sync_required(); void send_handshakes(); - bool is_active(connection_ptr conn); - void reset_lib_num(connection_ptr conn); - void request_next_chunk(connection_ptr conn = connection_ptr() ); - void start_sync(connection_ptr c, uint32_t target); - void reassign_fetch(connection_ptr c, go_away_reason reason); - void verify_catchup(connection_ptr c, uint32_t num, block_id_type id); - void rejected_block(connection_ptr c, uint32_t blk_num); - void recv_block(connection_ptr c, const block_id_type &blk_id, uint32_t blk_num); - void recv_handshake(connection_ptr c, const handshake_message& msg); - void recv_notice(connection_ptr c, const notice_message& msg); + bool is_active(const connection_ptr& conn); + void reset_lib_num(const connection_ptr& conn); + void request_next_chunk(const connection_ptr& conn = connection_ptr()); + void start_sync(const connection_ptr& c, uint32_t target); + void reassign_fetch(const connection_ptr& c, go_away_reason reason); + void verify_catchup(const connection_ptr& c, uint32_t num, const block_id_type& id); + void rejected_block(const connection_ptr& c, uint32_t blk_num); + void recv_block(const connection_ptr& c, const block_id_type& blk_id, uint32_t blk_num); + void recv_handshake(const connection_ptr& c, const handshake_message& msg); + void recv_notice(const connection_ptr& c, const notice_message& msg); }; class dispatch_manager { public: - uint32_t just_send_it_max = 0; + std::multimap received_blocks; + std::multimap received_transactions; - vector req_trx; + void bcast_transaction(const transaction_metadata_ptr& trx); + void rejected_transaction(const transaction_id_type& msg); + void bcast_block(const block_state_ptr& bs); + void rejected_block(const block_id_type& id); - std::multimap received_blocks; - std::multimap received_transactions; + void recv_block(const connection_ptr& conn, const block_id_type& msg, uint32_t bnum); + void recv_transaction(const connection_ptr& conn, const transaction_id_type& id); + void recv_notice(const connection_ptr& conn, const notice_message& msg, bool generated); - void bcast_transaction (const packed_transaction& msg); - void rejected_transaction (const transaction_id_type& msg); - void bcast_block (const signed_block& msg); - void rejected_block (const block_id_type &id); - - void recv_block (connection_ptr conn, const block_id_type& msg, uint32_t bnum); - void recv_transaction(connection_ptr conn, const transaction_id_type& id); - void recv_notice (connection_ptr conn, const notice_message& msg, bool generated); - - void retry_fetch (connection_ptr conn); + void retry_fetch(const connection_ptr& conn); }; //--------------------------------------------------------------------------- @@ -714,6 +764,7 @@ namespace eosio { protocol_version(0), peer_addr(endpoint), response_expected(), + read_delay_timer(), pending_fetch(), no_retry(no_reason), fork_head(), @@ -738,6 +789,7 @@ namespace eosio { protocol_version(0), peer_addr(), response_expected(), + read_delay_timer(), pending_fetch(), no_retry(no_reason), fork_head(), @@ -754,6 +806,7 @@ namespace eosio { auto *rnd = node_id.data(); rnd[0] = 0; response_expected.reset(new boost::asio::steady_timer(app().get_io_service())); + read_delay_timer.reset(new boost::asio::steady_timer(app().get_io_service())); } bool connection::connected() { @@ -771,7 +824,7 @@ namespace eosio { } void connection::flush_queues() { - write_queue.clear(); + buffer_queue.clear_write_queue(); } void connection::close() { @@ -785,7 +838,7 @@ namespace eosio { connecting = false; syncing = false; if( last_req ) { - my_impl->dispatcher->retry_fetch (shared_from_this()); + my_impl->dispatcher->retry_fetch(shared_from_this()); } reset(); sent_handshake_count = 0; @@ -794,60 +847,33 @@ namespace eosio { my_impl->sync_master->reset_lib_num(shared_from_this()); fc_dlog(logger, "canceling wait on ${p}", ("p",peer_name())); cancel_wait(); + if( read_delay_timer ) read_delay_timer->cancel(); pending_message_buffer.reset(); } - void connection::txn_send_pending(const vector &ids) { + void connection::txn_send_pending(const vector& ids) { + const std::set known_ids(ids.cbegin(), ids.cend()); + my_impl->expire_local_txns(); for(auto tx = my_impl->local_txns.begin(); tx != my_impl->local_txns.end(); ++tx ){ - if(tx->serialized_txn.size() && tx->block_num == 0) { - bool found = false; - for(auto known : ids) { - if( known == tx->id) { - found = true; - break; - } - } - if(!found) { - my_impl->local_txns.modify(tx,incr_in_flight); - queue_write(std::make_shared>(tx->serialized_txn), - true, - [tx_id=tx->id](boost::system::error_code ec, std::size_t ) { - auto& local_txns = my_impl->local_txns; - auto tx = local_txns.get().find(tx_id); - if (tx != local_txns.end()) { - local_txns.modify(tx, decr_in_flight); - } else { - fc_wlog(logger, "Local pending TX erased before queued_write called callback"); - } - }); - } + const bool found = known_ids.find( tx->id ) != known_ids.cend(); + if( !found ) { + queue_write( tx->serialized_txn, true, []( boost::system::error_code ec, std::size_t ) {} ); } } } - void connection::txn_send(const vector &ids) { - for(auto t : ids) { + void connection::txn_send(const vector& ids) { + for(const auto& t : ids) { auto tx = my_impl->local_txns.get().find(t); - if( tx != my_impl->local_txns.end() && tx->serialized_txn.size()) { - my_impl->local_txns.modify( tx,incr_in_flight); - queue_write(std::make_shared>(tx->serialized_txn), - true, - [t](boost::system::error_code ec, std::size_t ) { - auto& local_txns = my_impl->local_txns; - auto tx = local_txns.get().find(t); - if (tx != local_txns.end()) { - local_txns.modify(tx, decr_in_flight); - } else { - fc_wlog(logger, "Local TX erased before queued_write called callback"); - } - }); + if( tx != my_impl->local_txns.end() ) { + queue_write( tx->serialized_txn, true, []( boost::system::error_code ec, std::size_t ) {} ); } } } void connection::blk_send_branch() { - controller &cc = my_impl->chain_plug->chain(); - uint32_t head_num = cc.fork_db_head_block_num (); + controller& cc = my_impl->chain_plug->chain(); + uint32_t head_num = cc.fork_db_head_block_num(); notice_message note; note.known_blocks.mode = normal; note.known_blocks.pending = 0; @@ -876,85 +902,53 @@ namespace eosio { } head_id = cc.fork_db_head_block_id(); } - catch (const assert_exception &ex) { + catch (const assert_exception& ex) { elog( "unable to retrieve block info: ${n} for ${p}",("n",ex.to_string())("p",peer_name())); enqueue(note); return; } - catch (const fc::exception &ex) { + catch (const fc::exception& ex) { } catch (...) { } - vector bstack; - block_id_type null_id; - for (auto bid = head_id; bid != null_id && bid != lib_id; ) { - try { - - // if the last handshake received indicates that we are catching up on a fork - // that the peer is already partially aware of, no need to resend blocks - if (remote_head_id == bid) { - break; - } - - signed_block_ptr b = cc.fetch_block_by_id(bid); - if ( b ) { - bid = b->previous; - bstack.push_back(b); - } - else { - break; - } - } catch (...) { - break; - } - } - size_t count = 0; - if (!bstack.empty()) { - if (bstack.back()->previous == lib_id || bstack.back()->previous == remote_head_id) { - count = bstack.size(); - while (bstack.size()) { - enqueue(*bstack.back()); - bstack.pop_back(); - } - } - fc_ilog(logger, "Sent ${n} blocks on my fork",("n",count)); + if( !peer_requested ) { + peer_requested = sync_state( block_header::num_from_id(lib_id)+1, + block_header::num_from_id(head_id), + block_header::num_from_id(lib_id) ); } else { - fc_ilog(logger, "Nothing to send on fork request"); + uint32_t start = std::min( peer_requested->last + 1, block_header::num_from_id(lib_id)+1 ); + uint32_t end = std::max( peer_requested->end_block, block_header::num_from_id(head_id) ); + peer_requested = sync_state( start, end, start - 1 ); } + enqueue_sync_block(); + // still want to send transactions along during blk branch sync syncing = false; } - void connection::blk_send(const vector &ids) { + void connection::blk_send(const block_id_type& blkid) { controller &cc = my_impl->chain_plug->chain(); - int count = 0; - for(auto &blkid : ids) { - ++count; - try { - signed_block_ptr b = cc.fetch_block_by_id(blkid); - if(b) { - fc_dlog(logger,"found block for id at num ${n}",("n",b->block_num())); - enqueue(net_message(*b)); - } - else { - ilog("fetch block by id returned null, id ${id} on block ${c} of ${s} for ${p}", - ("id",blkid)("c",count)("s",ids.size())("p",peer_name())); - break; - } - } - catch (const assert_exception &ex) { - elog( "caught assert on fetch_block_by_id, ${ex}, id ${id} on block ${c} of ${s} for ${p}", - ("ex",ex.to_string())("id",blkid)("c",count)("s",ids.size())("p",peer_name())); - break; - } - catch (...) { - elog( "caught othser exception fetching block id ${id} on block ${c} of ${s} for ${p}", - ("id",blkid)("c",count)("s",ids.size())("p",peer_name())); - break; + try { + signed_block_ptr b = cc.fetch_block_by_id(blkid); + if(b) { + fc_dlog(logger,"found block for id at num ${n}",("n",b->block_num())); + peer_block_state pbstate = {blkid, block_header::num_from_id(blkid), true, true, time_point()}; + add_peer_block(pbstate); + enqueue_block( b ); + } else { + ilog("fetch block by id returned null, id ${id} for ${p}", + ("id",blkid)("p",peer_name())); } } - + catch (const assert_exception &ex) { + elog( "caught assert on fetch_block_by_id, ${ex}, id ${id} for ${p}", + ("ex",ex.to_string())("id",blkid)("p",peer_name())); + } + catch (...) { + elog( "caught other exception fetching block id ${id} for ${p}", + ("id",blkid)("p",peer_name())); + } } void connection::send_p2p_request(bool discoverable) @@ -984,7 +978,7 @@ namespace eosio { syncing = false; } - void connection::send_handshake( ) { + void connection::send_handshake() { handshake_initializer::populate(last_handshake_sent); last_handshake_sent.generation = ++sent_handshake_count; fc_dlog(logger, "Sending handshake generation ${g} to ${ep}", @@ -992,15 +986,6 @@ namespace eosio { enqueue(last_handshake_sent); } - char* connection::convert_tstamp(const tstamp& t) - { - const long long NsecPerSec{1000000000}; - time_t seconds = t / NsecPerSec; - strftime(ts, ts_buffer_size, "%F %T", localtime(&seconds)); - snprintf(ts+19, ts_buffer_size-19, ".%lld", t % NsecPerSec); - return ts; - } - void connection::send_time() { time_message xpkt; xpkt.org = rec; @@ -1018,16 +1003,23 @@ namespace eosio { enqueue(xpkt); } - void connection::queue_write(std::shared_ptr> buff, + void connection::queue_write(const std::shared_ptr>& buff, bool trigger_send, - std::function callback) { - write_queue.push_back({buff, callback}); - if(out_queue.empty() && trigger_send) + std::function callback, + bool to_sync_queue) { + if( !buffer_queue.add_write_queue( buff, callback, to_sync_queue )) { + fc_wlog( logger, "write_queue full ${s} bytes, giving up on connection ${p}", + ("s", buffer_queue.write_queue_size())("p", peer_name()) ); + my_impl->close( shared_from_this() ); + return; + } + if( buffer_queue.is_out_queue_empty() && trigger_send) { do_queue_write(); + } } void connection::do_queue_write() { - if(write_queue.empty() || !out_queue.empty()) + if( !buffer_queue.ready_to_send() ) return; connection_wptr c(shared_from_this()); if(!socket->is_open()) { @@ -1036,21 +1028,14 @@ namespace eosio { return; } std::vector bufs; - while (write_queue.size() > 0) { - auto& m = write_queue.front(); - bufs.push_back(boost::asio::buffer(*m.buff)); - out_queue.push_back(m); - write_queue.pop_front(); - } + buffer_queue.fill_out_buffer( bufs ); boost::asio::async_write(*socket, bufs, [c](boost::system::error_code ec, std::size_t w) { try { auto conn = c.lock(); if(!conn) return; - for (auto& m: conn->out_queue) { - m.callback(ec, w); - } + conn->buffer_queue.out_callback( ec, w ); if(ec) { string pname = conn ? conn->peer_name() : "no connection name"; @@ -1063,9 +1048,7 @@ namespace eosio { my_impl->close(conn); return; } - while (conn->out_queue.size() > 0) { - conn->out_queue.pop_front(); - } + conn->buffer_queue.clear_out_queue(); conn->enqueue_sync_block(); conn->do_queue_write(); } @@ -1088,8 +1071,8 @@ namespace eosio { } void connection::cancel_sync(go_away_reason reason) { - fc_dlog(logger,"cancel sync reason = ${m}, write queue size ${o} peer ${p}", - ("m",reason_str(reason)) ("o", write_queue.size())("p", peer_name())); + fc_dlog(logger,"cancel sync reason = ${m}, write queue size ${o} bytes peer ${p}", + ("m",reason_str(reason)) ("o", buffer_queue.write_queue_size())("p", peer_name())); cancel_wait(); flush_queues(); switch (reason) { @@ -1106,7 +1089,6 @@ namespace eosio { } bool connection::enqueue_sync_block() { - controller& cc = app().find_plugin()->chain(); if (!peer_requested) return false; uint32_t num = ++peer_requested->last; @@ -1115,9 +1097,10 @@ namespace eosio { peer_requested.reset(); } try { + controller& cc = my_impl->chain_plug->chain(); signed_block_ptr sb = cc.fetch_block_by_number(num); if(sb) { - enqueue( *sb, trigger_send); + enqueue_block( sb, trigger_send, true); return true; } } catch ( ... ) { @@ -1126,22 +1109,50 @@ namespace eosio { return false; } - void connection::enqueue( const net_message &m, bool trigger_send ) { + void connection::enqueue( const net_message& m, bool trigger_send ) { go_away_reason close_after_send = no_reason; if (m.contains()) { close_after_send = m.get().reason; } uint32_t payload_size = fc::raw::pack_size( m ); - char * header = reinterpret_cast(&payload_size); - size_t header_size = sizeof(payload_size); + char* header = reinterpret_cast(&payload_size); + size_t header_size = sizeof(payload_size); size_t buffer_size = header_size + payload_size; auto send_buffer = std::make_shared>(buffer_size); fc::datastream ds( send_buffer->data(), buffer_size); ds.write( header, header_size ); fc::raw::pack( ds, m ); + + enqueue_buffer( send_buffer, trigger_send, close_after_send ); + } + + void connection::enqueue_block( const signed_block_ptr& sb, bool trigger_send, bool to_sync_queue ) { + // this implementation is to avoid copy of signed_block to net_message + int which = 7; // matches which of net_message for signed_block + + uint32_t which_size = fc::raw::pack_size( unsigned_int( which )); + uint32_t payload_size = which_size + fc::raw::pack_size( *sb ); + + char* header = reinterpret_cast(&payload_size); + size_t header_size = sizeof(payload_size); + size_t buffer_size = header_size + payload_size; + + auto send_buffer = std::make_shared>(buffer_size); + fc::datastream ds( send_buffer->data(), buffer_size); + ds.write( header, header_size ); + fc::raw::pack( ds, unsigned_int( which )); + fc::raw::pack( ds, *sb ); + + enqueue_buffer( send_buffer, trigger_send, no_reason, to_sync_queue ); + } + + void connection::enqueue_buffer( const std::shared_ptr>& send_buffer, bool trigger_send, + go_away_reason close_after_send, + bool to_sync_queue ) + { connection_wptr weak_this = shared_from_this(); queue_write(send_buffer,trigger_send, [weak_this, close_after_send](boost::system::error_code ec, std::size_t ) { @@ -1155,7 +1166,8 @@ namespace eosio { } else { fc_wlog(logger, "connection expired before enqueued net_message called callback!"); } - }); + }, + to_sync_queue); } void connection::cancel_wait() { @@ -1163,7 +1175,7 @@ namespace eosio { response_expected->cancel(); } - void connection::sync_wait( ) { + void connection::sync_wait() { response_expected->expires_from_now( my_impl->resp_expected_period); connection_wptr c(shared_from_this()); response_expected->async_wait( [c]( boost::system::error_code ec){ @@ -1177,7 +1189,7 @@ namespace eosio { } ); } - void connection::fetch_wait( ) { + void connection::fetch_wait() { response_expected->expires_from_now( my_impl->resp_expected_period); connection_wptr c(shared_from_this()); response_expected->async_wait( [c]( boost::system::error_code ec){ @@ -1193,12 +1205,12 @@ namespace eosio { void connection::sync_timeout( boost::system::error_code ec ) { if( !ec ) { - my_impl->sync_master->reassign_fetch (shared_from_this(),benign_other); + my_impl->sync_master->reassign_fetch(shared_from_this(), benign_other); } else if( ec == boost::asio::error::operation_aborted) { } else { - elog ("setting timer for sync request got error ${ec}",("ec", ec.message())); + elog("setting timer for sync request got error ${ec}",("ec", ec.message())); } } @@ -1214,21 +1226,21 @@ namespace eosio { void connection::fetch_timeout( boost::system::error_code ec ) { if( !ec ) { - if( pending_fetch.valid() && !( pending_fetch->req_trx.empty( ) || pending_fetch->req_blocks.empty( ) ) ) { - my_impl->dispatcher->retry_fetch (shared_from_this() ); + if( pending_fetch.valid() && !( pending_fetch->req_trx.empty() || pending_fetch->req_blocks.empty() ) ) { + my_impl->dispatcher->retry_fetch(shared_from_this()); } } else if( ec == boost::asio::error::operation_aborted ) { - if( !connected( ) ) { + if( !connected() ) { fc_dlog(logger, "fetch timeout was cancelled due to dead connection"); } } else { - elog( "setting timer for fetch request got error ${ec}", ("ec", ec.message( ) ) ); + elog( "setting timer for fetch request got error ${ec}", ("ec", ec.message() ) ); } } - void connection::request_sync_blocks (uint32_t start, uint32_t end) { + void connection::request_sync_blocks(uint32_t start, uint32_t end) { sync_request_message srm = {start,end}; enqueue( net_message(srm)); sync_wait(); @@ -1236,27 +1248,17 @@ namespace eosio { bool connection::process_next_message(net_plugin_impl& impl, uint32_t message_length) { try { - // If it is a signed_block, then save the raw message for the cache - // This must be done before we unpack the message. - // This code is copied from fc::io::unpack(..., unsigned_int) - auto index = pending_message_buffer.read_index(); - uint64_t which = 0; char b = 0; uint8_t by = 0; - do { - pending_message_buffer.peek(&b, 1, index); - which |= uint32_t(uint8_t(b) & 0x7f) << by; - by += 7; - } while( uint8_t(b) & 0x80 && by < 32); - - if (which == uint64_t(net_message::tag::value)) { - blk_buffer.resize(message_length); - auto index = pending_message_buffer.read_index(); - pending_message_buffer.peek(blk_buffer.data(), message_length, index); - } auto ds = pending_message_buffer.create_datastream(); net_message msg; fc::raw::unpack(ds, msg); - msgHandler m(impl, shared_from_this() ); - msg.visit(m); + msg_handler m(impl, shared_from_this() ); + if( msg.contains() ) { + m( std::move( msg.get() ) ); + } else if( msg.contains() ) { + m( std::move( msg.get() ) ); + } else { + msg.visit( m ); + } } catch( const fc::exception& e ) { edump((e.to_detail_string() )); impl.close( shared_from_this() ); @@ -1265,7 +1267,7 @@ namespace eosio { return true; } - bool connection::add_peer_block(const peer_block_state &entry) { + bool connection::add_peer_block(const peer_block_state& entry) { auto bptr = blk_state.get().find(entry.id); bool added = (bptr == blk_state.end()); if (added){ @@ -1293,11 +1295,11 @@ namespace eosio { ,source() ,state(in_sync) { - chain_plug = app( ).find_plugin( ); + chain_plug = app().find_plugin(); EOS_ASSERT( chain_plug, chain::missing_chain_plugin_exception, "" ); } - constexpr auto sync_manager::stage_str(stages s ) { + constexpr auto sync_manager::stage_str(stages s) { switch (s) { case in_sync : return "in sync"; case lib_catchup: return "lib catchup"; @@ -1310,11 +1312,11 @@ namespace eosio { if (state == newstate) { return; } - fc_dlog(logger, "old state ${os} becoming ${ns}",("os",stage_str (state))("ns",stage_str (newstate))); + fc_dlog(logger, "old state ${os} becoming ${ns}",("os",stage_str(state))("ns",stage_str(newstate))); state = newstate; } - bool sync_manager::is_active(connection_ptr c) { + bool sync_manager::is_active(const connection_ptr& c) { if (state == head_catchup && c) { bool fhset = c->fork_head != block_id_type(); fc_dlog(logger, "fork_head_num = ${fn} fork_head set = ${s}", @@ -1324,7 +1326,7 @@ namespace eosio { return state != in_sync; } - void sync_manager::reset_lib_num(connection_ptr c) { + void sync_manager::reset_lib_num(const connection_ptr& c) { if(state == in_sync) { source.reset(); } @@ -1338,19 +1340,19 @@ namespace eosio { } } - bool sync_manager::sync_required( ) { + bool sync_manager::sync_required() { fc_dlog(logger, "last req = ${req}, last recv = ${recv} known = ${known} our head = ${head}", - ("req",sync_last_requested_num)("recv",sync_next_expected_num)("known",sync_known_lib_num)("head",chain_plug->chain( ).fork_db_head_block_num( ))); + ("req",sync_last_requested_num)("recv",sync_next_expected_num)("known",sync_known_lib_num)("head",chain_plug->chain().fork_db_head_block_num())); return( sync_last_requested_num < sync_known_lib_num || - chain_plug->chain( ).fork_db_head_block_num( ) < sync_last_requested_num ); + chain_plug->chain().fork_db_head_block_num() < sync_last_requested_num ); } - void sync_manager::request_next_chunk( connection_ptr conn ) { + void sync_manager::request_next_chunk( const connection_ptr& conn ) { uint32_t head_block = chain_plug->chain().fork_db_head_block_num(); if (head_block < sync_last_requested_num && source && source->current()) { - fc_ilog (logger, "ignoring request, head is ${h} last req = ${r} source is ${p}", + fc_ilog(logger, "ignoring request, head is ${h} last req = ${r} source is ${p}", ("h",head_block)("r",sync_last_requested_num)("p",source->peer_name())); return; } @@ -1429,7 +1431,7 @@ namespace eosio { } } - void sync_manager::send_handshakes () + void sync_manager::send_handshakes() { for( auto &ci : my_impl->connections) { if( ci->current()) { @@ -1438,7 +1440,7 @@ namespace eosio { } } - void sync_manager::start_sync( connection_ptr c, uint32_t target) { + void sync_manager::start_sync(const connection_ptr& c, uint32_t target) { if( target > sync_known_lib_num) { sync_known_lib_num = target; } @@ -1462,20 +1464,20 @@ namespace eosio { request_next_chunk(c); } - void sync_manager::reassign_fetch(connection_ptr c, go_away_reason reason) { + void sync_manager::reassign_fetch(const connection_ptr& c, go_away_reason reason) { fc_ilog(logger, "reassign_fetch, our last req is ${cc}, next expected is ${ne} peer ${p}", ( "cc",sync_last_requested_num)("ne",sync_next_expected_num)("p",c->peer_name())); if (c == source) { - c->cancel_sync (reason); + c->cancel_sync(reason); sync_last_requested_num = 0; request_next_chunk(); } } - void sync_manager::recv_handshake (connection_ptr c, const handshake_message &msg) { + void sync_manager::recv_handshake(const connection_ptr& c, const handshake_message& msg) { controller& cc = chain_plug->chain(); - uint32_t lib_num = cc.last_irreversible_block_num( ); + uint32_t lib_num = cc.last_irreversible_block_num(); uint32_t peer_lib = msg.last_irreversible_block_num; reset_lib_num(c); c->syncing = false; @@ -1483,16 +1485,16 @@ namespace eosio { //-------------------------------- // sync need checks; (lib == last irreversible block) // - // 0. my head block id == peer head id means we are all caugnt up block wise + // 0. my head block id == peer head id means we are all caught up block wise // 1. my head block num < peer lib - start sync locally // 2. my lib > peer head num - send an last_irr_catch_up notice if not the first generation // // 3 my head block num <= peer head block num - update sync state and send a catchup request - // 4 my head block num > peer block num ssend a notice catchup if this is not the first generation + // 4 my head block num > peer block num send a notice catchup if this is not the first generation // //----------------------------- - uint32_t head = cc.fork_db_head_block_num( ); + uint32_t head = cc.fork_db_head_block_num(); block_id_type head_id = cc.fork_db_head_block_id(); if (head_id == msg.head_id) { fc_dlog(logger, "sync check state 0"); @@ -1528,7 +1530,7 @@ namespace eosio { if (head <= msg.head_num ) { fc_dlog(logger, "sync check state 3"); - verify_catchup (c, msg.head_num, msg.head_id); + verify_catchup(c, msg.head_num, msg.head_id); return; } else { @@ -1544,13 +1546,13 @@ namespace eosio { c->syncing = true; return; } - elog ("sync check failed to resolve status"); + elog("sync check failed to resolve status"); } - void sync_manager::verify_catchup(connection_ptr c, uint32_t num, block_id_type id) { + void sync_manager::verify_catchup(const connection_ptr& c, uint32_t num, const block_id_type& id) { request_message req; req.req_blocks.mode = catch_up; - for (auto cc : my_impl->connections) { + for (const auto& cc : my_impl->connections) { if (cc->fork_head == id || cc->fork_head_num > num) { req.req_blocks.mode = none; @@ -1560,7 +1562,8 @@ namespace eosio { if( req.req_blocks.mode == catch_up ) { c->fork_head = id; c->fork_head_num = num; - ilog ("got a catch_up notice while in ${s}, fork head num = ${fhn} target LIB = ${lib} next_expected = ${ne}", ("s",stage_str(state))("fhn",num)("lib",sync_known_lib_num)("ne", sync_next_expected_num)); + ilog("got a catch_up notice while in ${s}, fork head num = ${fhn} target LIB = ${lib} next_expected = ${ne}", + ("s",stage_str(state))("fhn",num)("lib",sync_known_lib_num)("ne", sync_next_expected_num)); if (state == lib_catchup) return; set_state(head_catchup); @@ -1573,26 +1576,30 @@ namespace eosio { c->enqueue( req ); } - void sync_manager::recv_notice (connection_ptr c, const notice_message &msg) { - fc_ilog (logger, "sync_manager got ${m} block notice",("m",modes_str(msg.known_blocks.mode))); + void sync_manager::recv_notice(const connection_ptr& c, const notice_message& msg) { + fc_ilog(logger, "sync_manager got ${m} block notice",("m",modes_str(msg.known_blocks.mode))); + if( msg.known_blocks.ids.size() > 1 ) { + elog( "Invalid notice_message, known_blocks.ids.size ${s}", ("s", msg.known_blocks.ids.size()) ); + my_impl->close(c); + return; + } if (msg.known_blocks.mode == catch_up) { if (msg.known_blocks.ids.size() == 0) { - elog ("got a catch up with ids size = 0"); - } - else { - verify_catchup(c, msg.known_blocks.pending, msg.known_blocks.ids.back()); + elog("got a catch up with ids size = 0"); + } else { + verify_catchup(c, msg.known_blocks.pending, msg.known_blocks.ids.back()); } } else { c->last_handshake_recv.last_irreversible_block_num = msg.known_trx.pending; - reset_lib_num (c); + reset_lib_num(c); start_sync(c, msg.known_trx.pending); } } - void sync_manager::rejected_block (connection_ptr c, uint32_t blk_num) { + void sync_manager::rejected_block(const connection_ptr& c, uint32_t blk_num) { if (state != in_sync ) { - fc_ilog (logger, "block ${bn} not accepted from ${p}",("bn",blk_num)("p",c->peer_name())); + fc_ilog(logger, "block ${bn} not accepted from ${p}",("bn",blk_num)("p",c->peer_name())); sync_last_requested_num = 0; source.reset(); my_impl->close(c); @@ -1600,23 +1607,23 @@ namespace eosio { send_handshakes(); } } - void sync_manager::recv_block (connection_ptr c, const block_id_type &blk_id, uint32_t blk_num) { + void sync_manager::recv_block(const connection_ptr& c, const block_id_type& blk_id, uint32_t blk_num) { fc_dlog(logger," got block ${bn} from ${p}",("bn",blk_num)("p",c->peer_name())); if (state == lib_catchup) { if (blk_num != sync_next_expected_num) { - fc_ilog (logger, "expected block ${ne} but got ${bn}",("ne",sync_next_expected_num)("bn",blk_num)); + fc_ilog(logger, "expected block ${ne} but got ${bn}",("ne",sync_next_expected_num)("bn",blk_num)); my_impl->close(c); return; } sync_next_expected_num = blk_num + 1; } if (state == head_catchup) { - fc_dlog (logger, "sync_manager in head_catchup state"); + fc_dlog(logger, "sync_manager in head_catchup state"); set_state(in_sync); source.reset(); block_id_type null_id; - for (auto cp : my_impl->connections) { + for (const auto& cp : my_impl->connections) { if (cp->fork_head == null_id) { continue; } @@ -1647,52 +1654,34 @@ namespace eosio { //------------------------------------------------------------------------ - void dispatch_manager::bcast_block (const signed_block &bsum) { + void dispatch_manager::bcast_block(const block_state_ptr& bs) { std::set skips; - auto range = received_blocks.equal_range(bsum.id()); + auto range = received_blocks.equal_range(bs->id); for (auto org = range.first; org != range.second; ++org) { skips.insert(org->second); } received_blocks.erase(range.first, range.second); - net_message msg(bsum); - uint32_t packsiz = fc::raw::pack_size(msg); - uint32_t msgsiz = packsiz + sizeof(packsiz); - notice_message pending_notify; - block_id_type bid = bsum.id(); - uint32_t bnum = bsum.block_num(); - pending_notify.known_blocks.mode = normal; - pending_notify.known_blocks.ids.push_back( bid ); - pending_notify.known_trx.mode = none; - - peer_block_state pbstate = {bid, bnum, false,true,time_point()}; - // skip will be empty if our producer emitted this block so just send it - if (( large_msg_notify && msgsiz > just_send_it_max) && !skips.empty()) { - fc_ilog(logger, "block size is ${ms}, sending notify",("ms", msgsiz)); - my_impl->send_all(pending_notify, [&skips, pbstate](connection_ptr c) -> bool { - if (skips.find(c) != skips.end() || !c->current()) - return false; - - bool unknown = c->add_peer_block(pbstate); - if (!unknown) { - elog("${p} already has knowledge of block ${b}", ("p",c->peer_name())("b",pbstate.block_num)); - } - return unknown; - }); - } - else { - pbstate.is_known = true; - for (auto cp : my_impl->connections) { - if (skips.find(cp) != skips.end() || !cp->current()) { - continue; - } - cp->add_peer_block(pbstate); - cp->enqueue( bsum ); + block_id_type bid = bs->id; + uint32_t bnum = bs->block_num; + peer_block_state pbstate = {bid, bnum, false, true, time_point()}; + + pbstate.is_known = true; + for( auto& cp : my_impl->connections ) { + if( skips.find( cp ) != skips.end() || !cp->current() ) { + continue; + } + bool has_block = cp->last_handshake_recv.last_irreversible_block_num >= bnum; + if( !has_block ) { + fc_dlog(logger, "bcast block ${b} to ${p}", ("b", bnum)("p", cp->peer_name())); + cp->add_peer_block( pbstate ); + cp->enqueue_block( bs->block ); } } + } - void dispatch_manager::recv_block (connection_ptr c, const block_id_type& id, uint32_t bnum) { + void dispatch_manager::recv_block(const connection_ptr& c, const block_id_type& id, uint32_t bnum) { received_blocks.insert(std::make_pair(id, c)); if (c && c->last_req && @@ -1707,15 +1696,15 @@ namespace eosio { c->cancel_wait(); } - void dispatch_manager::rejected_block (const block_id_type& id) { + void dispatch_manager::rejected_block(const block_id_type& id) { fc_dlog(logger,"not sending rejected transaction ${tid}",("tid",id)); auto range = received_blocks.equal_range(id); received_blocks.erase(range.first, range.second); } - void dispatch_manager::bcast_transaction (const packed_transaction& trx) { + void dispatch_manager::bcast_transaction(const transaction_metadata_ptr& ptrx) { std::set skips; - transaction_id_type id = trx.id(); + const auto& id = ptrx->id; auto range = received_transactions.equal_range(id); for (auto org = range.first; org != range.second; ++org) { @@ -1723,78 +1712,49 @@ namespace eosio { } received_transactions.erase(range.first, range.second); - for (auto ref = req_trx.begin(); ref != req_trx.end(); ++ref) { - if (*ref == id) { - req_trx.erase(ref); - break; - } - } - - if( my_impl->local_txns.get().find( id ) != my_impl->local_txns.end( ) ) { //found + if( my_impl->local_txns.get().find( id ) != my_impl->local_txns.end() ) { //found fc_dlog(logger, "found trxid in local_trxs" ); return; } - uint32_t packsiz = 0; - uint32_t bufsiz = 0; - - time_point_sec trx_expiration = trx.expiration(); - - net_message msg(trx); - packsiz = fc::raw::pack_size(msg); - bufsiz = packsiz + sizeof(packsiz); - vector buff(bufsiz); - fc::datastream ds( buff.data(), bufsiz); - ds.write( reinterpret_cast(&packsiz), sizeof(packsiz) ); - fc::raw::pack( ds, msg ); - node_transaction_state nts = {id, - trx_expiration, - trx, - std::move(buff), - 0, 0, 0}; + + time_point_sec trx_expiration = ptrx->packed_trx->expiration(); + const packed_transaction& trx = *ptrx->packed_trx; + + // this implementation is to avoid copy of packed_transaction to net_message + int which = 8; // matches which of net_message for packed_transaction + + uint32_t which_size = fc::raw::pack_size( unsigned_int( which )); + uint32_t payload_size = which_size + fc::raw::pack_size( trx ); + + char* header = reinterpret_cast(&payload_size); + size_t header_size = sizeof(payload_size); + size_t buffer_size = header_size + payload_size; + + auto buff = std::make_shared>(buffer_size); + fc::datastream ds( buff->data(), buffer_size); + ds.write( header, header_size ); + fc::raw::pack( ds, unsigned_int( which )); + fc::raw::pack( ds, trx ); + + node_transaction_state nts = {id, trx_expiration, 0, buff}; my_impl->local_txns.insert(std::move(nts)); - if( !large_msg_notify || bufsiz <= just_send_it_max) { - my_impl->send_all( trx, [id, &skips, trx_expiration](connection_ptr c) -> bool { - if( skips.find(c) != skips.end() || c->syncing ) { - return false; - } - const auto& bs = c->trx_state.find(id); - bool unknown = bs == c->trx_state.end(); - if( unknown) { - c->trx_state.insert(transaction_state({id,true,true,0,trx_expiration,time_point() })); - fc_dlog(logger, "sending whole trx to ${n}", ("n",c->peer_name() ) ); - } else { - update_txn_expiry ute(trx_expiration); - c->trx_state.modify(bs, ute); - } - return unknown; - }); - } - else { - notice_message pending_notify; - pending_notify.known_trx.mode = normal; - pending_notify.known_trx.ids.push_back( id ); - pending_notify.known_blocks.mode = none; - my_impl->send_all(pending_notify, [id, &skips, trx_expiration](connection_ptr c) -> bool { - if (skips.find(c) != skips.end() || c->syncing) { - return false; - } - const auto& bs = c->trx_state.find(id); - bool unknown = bs == c->trx_state.end(); - if( unknown) { - fc_dlog(logger, "sending notice to ${n}", ("n",c->peer_name() ) ); - c->trx_state.insert(transaction_state({id,false,true,0,trx_expiration,time_point() })); - } else { - update_txn_expiry ute(trx_expiration); - c->trx_state.modify(bs, ute); - } - return unknown; - }); - } + my_impl->send_all( buff, [&id, &skips, trx_expiration](const connection_ptr& c) -> bool { + if( skips.find(c) != skips.end() || c->syncing ) { + return false; + } + const auto& bs = c->trx_state.find(id); + bool unknown = bs == c->trx_state.end(); + if( unknown ) { + c->trx_state.insert(transaction_state({id,0,trx_expiration})); + fc_dlog(logger, "sending trx to ${n}", ("n",c->peer_name() ) ); + } + return unknown; + }); } - void dispatch_manager::recv_transaction (connection_ptr c, const transaction_id_type& id) { + void dispatch_manager::recv_transaction(const connection_ptr& c, const transaction_id_type& id) { received_transactions.insert(std::make_pair(id, c)); if (c && c->last_req && @@ -1808,50 +1768,32 @@ namespace eosio { c->cancel_wait(); } - void dispatch_manager::rejected_transaction (const transaction_id_type& id) { + void dispatch_manager::rejected_transaction(const transaction_id_type& id) { fc_dlog(logger,"not sending rejected transaction ${tid}",("tid",id)); auto range = received_transactions.equal_range(id); received_transactions.erase(range.first, range.second); } - void dispatch_manager::recv_notice (connection_ptr c, const notice_message& msg, bool generated) { + void dispatch_manager::recv_notice(const connection_ptr& c, const notice_message& msg, bool generated) { request_message req; req.req_trx.mode = none; req.req_blocks.mode = none; bool send_req = false; - controller &cc = my_impl->chain_plug->chain(); if (msg.known_trx.mode == normal) { req.req_trx.mode = normal; req.req_trx.pending = 0; - for( const auto& t : msg.known_trx.ids ) { - const auto &tx = my_impl->local_txns.get( ).find( t ); - - if( tx == my_impl->local_txns.end( ) ) { - fc_dlog(logger,"did not find ${id}",("id",t)); - - //At this point the details of the txn are not known, just its id. This - //effectively gives 120 seconds to learn of the details of the txn which - //will update the expiry in bcast_transaction - c->trx_state.insert( (transaction_state){t,true,true,0,time_point_sec(time_point::now()) + 120, - time_point()} ); - - req.req_trx.ids.push_back( t ); - req_trx.push_back( t ); - } - else { - fc_dlog(logger,"big msg manager found txn id in table, ${id}",("id", t)); - } - } - send_req = !req.req_trx.ids.empty(); - fc_dlog(logger,"big msg manager send_req ids list has ${ids} entries", ("ids", req.req_trx.ids.size())); + send_req = false; } else if (msg.known_trx.mode != none) { - elog ("passed a notice_message with something other than a normal on none known_trx"); + elog("passed a notice_message with something other than a normal on none known_trx"); return; } if (msg.known_blocks.mode == normal) { req.req_blocks.mode = normal; - for( const auto& blkid : msg.known_blocks.ids) { + controller& cc = my_impl->chain_plug->chain(); + // known_blocks.ids is never > 1 + if( !msg.known_blocks.ids.empty() ) { + const block_id_type& blkid = msg.known_blocks.ids.back(); signed_block_ptr b; peer_block_state entry = {blkid,0,true,true,fc::time_point()}; try { @@ -1873,7 +1815,7 @@ namespace eosio { } } else if (msg.known_blocks.mode != none) { - elog ("passed a notice_message with something other than a normal on none known_blocks"); + elog("passed a notice_message with something other than a normal on none known_blocks"); return; } fc_dlog( logger, "send req = ${sr}", ("sr",send_req)); @@ -1884,7 +1826,7 @@ namespace eosio { } } - void dispatch_manager::retry_fetch( connection_ptr c ) { + void dispatch_manager::retry_fetch(const connection_ptr& c) { if (!c->last_req) { return; } @@ -1904,14 +1846,14 @@ namespace eosio { ("b",modes_str(c->last_req->req_blocks.mode))("t",modes_str(c->last_req->req_trx.mode))); return; } - for (auto conn : my_impl->connections) { + for (auto& conn : my_impl->connections) { if (conn == c || conn->last_req) { continue; } bool sendit = false; if (is_txn) { auto trx = conn->trx_state.get().find(tid); - sendit = trx != conn->trx_state.end() && trx->is_known_by_peer; + sendit = trx != conn->trx_state.end(); } else { auto blk = conn->blk_state.get().find(bid); @@ -1934,7 +1876,7 @@ namespace eosio { //------------------------------------------------------------------------ - void net_plugin_impl::connect( connection_ptr c ) { + void net_plugin_impl::connect(const connection_ptr& c) { if( c->no_retry != go_away_reason::no_reason) { fc_dlog( logger, "Skipping connect due to go_away reason ${r}",("r", reason_str( c->no_retry ))); return; @@ -1943,7 +1885,7 @@ namespace eosio { auto colon = c->peer_addr.find(':'); if (colon == std::string::npos || colon == 0) { - elog ("Invalid peer address. must be \"host:port\": ${p}", ("p",c->peer_addr)); + elog("Invalid peer address. must be \"host:port\": ${p}", ("p",c->peer_addr)); for ( auto itr : connections ) { if((*itr).peer_addr == c->peer_addr) { (*itr).reset(); @@ -1976,7 +1918,7 @@ namespace eosio { }); } - void net_plugin_impl::connect( connection_ptr c, tcp::resolver::iterator endpoint_itr ) { + void net_plugin_impl::connect(const connection_ptr& c, tcp::resolver::iterator endpoint_itr) { if( c->no_retry != go_away_reason::no_reason) { string rsn = reason_str(c->no_retry); return; @@ -2039,7 +1981,9 @@ namespace eosio { } } } - bool net_plugin_impl::start_session( connection_ptr con ) { + + bool net_plugin_impl::start_session(const connection_ptr& con) { + boost::asio::ip::tcp::no_delay nodelay( true ); boost::system::error_code ec; con->socket->set_option( nodelay, ec ); @@ -2061,7 +2005,7 @@ namespace eosio { } - void net_plugin_impl::start_listen_loop( ) { + void net_plugin_impl::start_listen_loop() { auto socket = std::make_shared( std::ref( app().get_io_service() ) ); acceptor->async_accept( *socket, [socket,this]( boost::system::error_code ec ) { if( !ec ) { @@ -2084,7 +2028,7 @@ namespace eosio { } } if (num_clients != visitors) { - ilog ("checking max client, visitors = ${v} num clients ${n}",("v",visitors)("n",num_clients)); + ilog("checking max client, visitors = ${v} num clients ${n}",("v",visitors)("n",num_clients)); num_clients = visitors; } if( from_addr < max_nodes_per_host && (max_client_count == 0 || num_clients < max_client_count )) { @@ -2103,7 +2047,7 @@ namespace eosio { fc_elog(logger, "Error max_client_count ${m} exceeded", ( "m", max_client_count) ); } - socket->close( ); + socket->close(); } } } else { @@ -2125,7 +2069,7 @@ namespace eosio { }); } - void net_plugin_impl::start_read_message( connection_ptr conn ) { + void net_plugin_impl::start_read_message(const connection_ptr& conn) { try { if(!conn->socket) { @@ -2150,6 +2094,37 @@ namespace eosio { } }; + if( conn->buffer_queue.write_queue_size() > def_max_write_queue_size || + conn->reads_in_flight > def_max_reads_in_flight || + conn->trx_in_progress_size > def_max_trx_in_progress_size ) + { + // too much queued up, reschedule + if( conn->buffer_queue.write_queue_size() > def_max_write_queue_size ) { + peer_wlog( conn, "write_queue full ${s} bytes", ("s", conn->buffer_queue.write_queue_size()) ); + } else if( conn->reads_in_flight > def_max_reads_in_flight ) { + peer_wlog( conn, "max reads in flight ${s}", ("s", conn->reads_in_flight) ); + } else { + peer_wlog( conn, "max trx in progress ${s} bytes", ("s", conn->trx_in_progress_size) ); + } + if( conn->buffer_queue.write_queue_size() > 2*def_max_write_queue_size || + conn->reads_in_flight > 2*def_max_reads_in_flight || + conn->trx_in_progress_size > 2*def_max_trx_in_progress_size ) + { + fc_wlog( logger, "queues over full, giving up on connection ${p}", ("p", conn->peer_name()) ); + my_impl->close( conn ); + return; + } + if( !conn->read_delay_timer ) return; + conn->read_delay_timer->expires_from_now( def_read_delay_for_full_write_queue ); + conn->read_delay_timer->async_wait([this, weak_conn]( boost::system::error_code ) { + auto conn = weak_conn.lock(); + if( !conn ) return; + start_read_message( conn ); + } ); + return; + } + + ++conn->reads_in_flight; boost::asio::async_read(*conn->socket, conn->pending_message_buffer.get_buffer_sequence_for_boost_async_read(), completion_handler, [this,weak_conn]( boost::system::error_code ec, std::size_t bytes_transferred ) { @@ -2158,6 +2133,7 @@ namespace eosio { return; } + --conn->reads_in_flight; conn->outstanding_read_bytes.reset(); try { @@ -2180,7 +2156,8 @@ namespace eosio { conn->pending_message_buffer.peek(&message_length, sizeof(message_length), index); if(message_length > def_send_buffer_size*2 || message_length == 0) { boost::system::error_code ec; - elog("incoming message length unexpected (${i}), from ${p}", ("i", message_length)("p",boost::lexical_cast(conn->socket->remote_endpoint(ec)))); + elog("incoming message length unexpected (${i}), from ${p}", + ("i", message_length)("p",boost::lexical_cast(conn->socket->remote_endpoint(ec)))); close(conn); return; } @@ -2250,15 +2227,15 @@ namespace eosio { template - void net_plugin_impl::send_all( const net_message &msg, VerifierFunc verify) { + void net_plugin_impl::send_all(const std::shared_ptr>& send_buffer, VerifierFunc verify) { for( auto &c : connections) { - if( c->current() && verify( c)) { - c->enqueue( msg ); + if( c->current() && verify( c )) { + c->enqueue_buffer( send_buffer, true, no_reason ); } } } - bool net_plugin_impl::is_valid( const handshake_message &msg) { + bool net_plugin_impl::is_valid(const handshake_message& msg) { // Do some basic validation of an incoming handshake_message, so things // that really aren't handshake messages can be quickly discarded without // affecting state. @@ -2283,11 +2260,11 @@ namespace eosio { return valid; } - void net_plugin_impl::handle_message( connection_ptr c, const chain_size_message &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const chain_size_message& msg) { peer_ilog(c, "received chain_size_message"); - } + void net_plugin_impl::handle_message( connection_ptr c, const request_p2p_message &msg){ peer_ilog(c, "received request_p2p_message"); string rspm; @@ -2338,7 +2315,9 @@ namespace eosio { }}} } - void net_plugin_impl::handle_message( connection_ptr c, const handshake_message &msg) { + + void net_plugin_impl::handle_message(const connection_ptr& c, const handshake_message& msg) { + peer_ilog(c, "received handshake_message"); if (!is_valid(msg)) { peer_elog( c, "bad handshake message"); @@ -2346,7 +2325,7 @@ namespace eosio { return; } controller& cc = chain_plug->chain(); - uint32_t lib_num = cc.last_irreversible_block_num( ); + uint32_t lib_num = cc.last_irreversible_block_num(); uint32_t peer_lib = msg.last_irreversible_block_num; if( c->connecting ) { c->connecting = false; @@ -2445,7 +2424,7 @@ namespace eosio { sync_master->recv_handshake(c,msg); } - void net_plugin_impl::handle_message( connection_ptr c, const go_away_message &msg ) { + void net_plugin_impl::handle_message(const connection_ptr& c, const go_away_message& msg) { string rsn = reason_str( msg.reason ); peer_ilog(c, "received go_away_message"); ilog( "received a go away message from ${p}, reason = ${r}", @@ -2455,10 +2434,10 @@ namespace eosio { c->node_id = msg.node_id; } c->flush_queues(); - close (c); + close(c); } - void net_plugin_impl::handle_message(connection_ptr c, const time_message &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const time_message& msg) { peer_ilog(c, "received time_message"); /* We've already lost however many microseconds it took to dispatch * the message, but it can't be helped. @@ -2491,7 +2470,7 @@ namespace eosio { c->rec = 0; } - void net_plugin_impl::handle_message( connection_ptr c, const notice_message &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const notice_message& msg) { // peer tells us about one or more blocks or txns. When done syncing, forward on // notices of previously unknown blocks or txns, // @@ -2517,7 +2496,7 @@ namespace eosio { send_req = true; size_t known_sum = local_txns.size(); if( known_sum ) { - for( const auto& t : local_txns.get( ) ) { + for( const auto& t : local_txns.get() ) { req.req_trx.ids.push_back( t.id ); } } @@ -2525,7 +2504,7 @@ namespace eosio { break; } case normal: { - dispatcher->recv_notice (c, msg, false); + dispatcher->recv_notice(c, msg, false); } } @@ -2542,7 +2521,7 @@ namespace eosio { break; } case normal : { - dispatcher->recv_notice (c, msg, false); + dispatcher->recv_notice(c, msg, false); break; } default: { @@ -2555,15 +2534,23 @@ namespace eosio { } } - void net_plugin_impl::handle_message( connection_ptr c, const request_message &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const request_message& msg) { + if( msg.req_blocks.ids.size() > 1 ) { + elog( "Invalid request_message, req_blocks.ids.size ${s}", ("s", msg.req_blocks.ids.size()) ); + close(c); + return; + } + switch (msg.req_blocks.mode) { case catch_up : peer_ilog(c, "received request_message:catch_up"); - c->blk_send_branch( ); + c->blk_send_branch(); break; case normal : peer_ilog(c, "received request_message:normal"); - c->blk_send(msg.req_blocks.ids); + if( !msg.req_blocks.ids.empty() ) { + c->blk_send(msg.req_blocks.ids.back()); + } break; default:; } @@ -2585,7 +2572,7 @@ namespace eosio { } - void net_plugin_impl::handle_message( connection_ptr c, const sync_request_message &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const sync_request_message& msg) { if( msg.end_block == 0) { c->peer_requested.reset(); c->flush_queues(); @@ -2595,7 +2582,14 @@ namespace eosio { } } - void net_plugin_impl::handle_message( connection_ptr c, const packed_transaction &msg) { + size_t calc_trx_size( const packed_transaction_ptr& trx ) { + // transaction is stored packed and unpacked, double packed_size and size of signed as an approximation of use + return (trx->get_packed_transaction().size() * 2 + sizeof(trx->get_signed_transaction())) * 2 + + trx->get_packed_context_free_data().size() * 4 + + trx->get_signatures().size() * sizeof(signature_type); + } + + void net_plugin_impl::handle_message(const connection_ptr& c, const packed_transaction_ptr& trx) { fc_dlog(logger, "got a packed transaction, cancel wait"); peer_ilog(c, "received packed_transaction"); controller& cc = my_impl->chain_plug->chain(); @@ -2607,35 +2601,40 @@ namespace eosio { fc_dlog(logger, "got a txn during sync - dropping"); return; } - transaction_id_type tid = msg.id(); + + auto ptrx = std::make_shared( trx ); + const auto& tid = ptrx->id; + c->cancel_wait(); if(local_txns.get().find(tid) != local_txns.end()) { fc_dlog(logger, "got a duplicate transaction - dropping"); return; } dispatcher->recv_transaction(c, tid); - chain_plug->accept_transaction(msg, [=](const static_variant& result) { + c->trx_in_progress_size += calc_trx_size( ptrx->packed_trx ); + chain_plug->accept_transaction(ptrx, [c, this, ptrx](const static_variant& result) { + c->trx_in_progress_size -= calc_trx_size( ptrx->packed_trx ); if (result.contains()) { peer_dlog(c, "bad packed_transaction : ${m}", ("m",result.get()->what())); } else { auto trace = result.get(); if (!trace->except) { fc_dlog(logger, "chain accepted transaction"); - dispatcher->bcast_transaction(msg); + this->dispatcher->bcast_transaction(ptrx); return; } peer_elog(c, "bad packed_transaction : ${m}", ("m",trace->except->what())); } - dispatcher->rejected_transaction(tid); + dispatcher->rejected_transaction(ptrx->id); }); } - void net_plugin_impl::handle_message( connection_ptr c, const signed_block &msg) { + void net_plugin_impl::handle_message(const connection_ptr& c, const signed_block_ptr& msg) { controller &cc = chain_plug->chain(); - block_id_type blk_id = msg.id(); - uint32_t blk_num = msg.block_num(); + block_id_type blk_id = msg->id(); + uint32_t blk_num = msg->block_num(); fc_dlog(logger, "canceling wait on ${p}", ("p",c->peer_name())); c->cancel_wait(); @@ -2650,14 +2649,13 @@ namespace eosio { } dispatcher->recv_block(c, blk_id, blk_num); - fc::microseconds age( fc::time_point::now() - msg.timestamp); + fc::microseconds age( fc::time_point::now() - msg->timestamp); peer_ilog(c, "received signed_block : #${n} block age in secs = ${age}", ("n",blk_num)("age",age.to_seconds())); go_away_reason reason = fatal_other; try { - signed_block_ptr sbp = std::make_shared(msg); - chain_plug->accept_block(sbp); //, sync_master->is_active(c)); + chain_plug->accept_block(msg); //, sync_master->is_active(c)); reason = no_reason; } catch( const unlinkable_block_exception &ex) { peer_elog(c, "bad signed_block : ${m}", ("m",ex.what())); @@ -2680,7 +2678,7 @@ namespace eosio { update_block_num ubn(blk_num); if( reason == no_reason ) { - for (const auto &recpt : msg.transactions) { + for (const auto &recpt : msg->transactions) { auto id = (recpt.trx.which() == 0) ? recpt.trx.get() : recpt.trx.get().id(); auto ltx = local_txns.get().find(id); if( ltx != local_txns.end()) { @@ -2715,21 +2713,21 @@ namespace eosio { transaction_check->expires_from_now( txn_exp_period); transaction_check->async_wait( [this](boost::system::error_code ec) { if( !ec) { - expire_txns( ); + expire_txns(); } else { elog( "Error from transaction check monitor: ${m}",( "m", ec.message())); - start_txn_timer( ); + start_txn_timer(); } }); } void net_plugin_impl::ticker() { - keepalive_timer->expires_from_now (keepalive_interval); - keepalive_timer->async_wait ([this](boost::system::error_code ec) { - ticker (); + keepalive_timer->expires_from_now(keepalive_interval); + keepalive_timer->async_wait([this](boost::system::error_code ec) { + ticker(); if (ec) { - wlog ("Peer keepalive ticked sooner than expected: ${m}", ("m", ec.message())); + wlog("Peer keepalive ticked sooner than expected: ${m}", ("m", ec.message())); } for (auto &c : connections ) { if (c->socket->is_open()) { @@ -2747,24 +2745,37 @@ namespace eosio { } void net_plugin_impl::expire_txns() { - start_txn_timer( ); - auto &old = local_txns.get(); - auto ex_up = old.upper_bound( time_point::now()); - auto ex_lo = old.lower_bound( fc::time_point_sec( 0)); - old.erase( ex_lo, ex_up); + start_txn_timer(); - auto &stale = local_txns.get(); - controller &cc = chain_plug->chain(); - uint32_t bn = cc.last_irreversible_block_num(); - stale.erase( stale.lower_bound(1), stale.upper_bound(bn) ); + auto now = time_point::now(); + auto start_size = local_txns.size(); + + expire_local_txns(); + + controller& cc = chain_plug->chain(); + uint32_t lib = cc.last_irreversible_block_num(); for ( auto &c : connections ) { auto &stale_txn = c->trx_state.get(); - stale_txn.erase( stale_txn.lower_bound(1), stale_txn.upper_bound(bn) ); + stale_txn.erase( stale_txn.lower_bound(1), stale_txn.upper_bound(lib) ); auto &stale_txn_e = c->trx_state.get(); stale_txn_e.erase(stale_txn_e.lower_bound(time_point_sec()), stale_txn_e.upper_bound(time_point::now())); auto &stale_blk = c->blk_state.get(); - stale_blk.erase( stale_blk.lower_bound(1), stale_blk.upper_bound(bn) ); + stale_blk.erase( stale_blk.lower_bound(1), stale_blk.upper_bound(lib) ); } + fc_dlog(logger, "expire_txns ${n}us size ${s} removed ${r}", + ("n", time_point::now() - now)("s", start_size)("r", start_size - local_txns.size()) ); + } + + void net_plugin_impl::expire_local_txns() { + auto& old = local_txns.get(); + auto ex_lo = old.lower_bound( fc::time_point_sec(0) ); + auto ex_up = old.upper_bound( time_point::now() ); + old.erase( ex_lo, ex_up ); + + auto& stale = local_txns.get(); + controller& cc = chain_plug->chain(); + uint32_t lib = cc.last_irreversible_block_num(); + stale.erase( stale.lower_bound(1), stale.upper_bound(lib) ); } void net_plugin_impl::connection_monitor(std::weak_ptr from_connection) { @@ -2792,8 +2803,8 @@ namespace eosio { start_conn_timer(connector_period, std::weak_ptr()); } - void net_plugin_impl::close( connection_ptr c ) { - if( c->peer_addr.empty( ) && c->socket->is_open() ) { + void net_plugin_impl::close(const connection_ptr& c) { + if( c->peer_addr.empty() && c->socket->is_open() ) { if (num_clients == 0) { fc_wlog( logger, "num_clients already at 0"); } @@ -2804,40 +2815,19 @@ namespace eosio { c->close(); } - void net_plugin_impl::accepted_block_header(const block_state_ptr& block) { - fc_dlog(logger,"signaled, id = ${id}",("id", block->id)); - } - void net_plugin_impl::accepted_block(const block_state_ptr& block) { fc_dlog(logger,"signaled, id = ${id}",("id", block->id)); - dispatcher->bcast_block(*block->block); + dispatcher->bcast_block(block); } - void net_plugin_impl::irreversible_block(const block_state_ptr&block) { - fc_dlog(logger,"signaled, id = ${id}",("id", block->id)); - } - - void net_plugin_impl::accepted_transaction(const transaction_metadata_ptr& md) { - fc_dlog(logger,"signaled, id = ${id}",("id", md->id)); -// dispatcher->bcast_transaction(md->packed_trx); - } - - void net_plugin_impl::applied_transaction(const transaction_trace_ptr& txn) { - fc_dlog(logger,"signaled, id = ${id}",("id", txn->id)); - } - - void net_plugin_impl::accepted_confirmation(const header_confirmation& head) { - fc_dlog(logger,"signaled, id = ${id}",("id", head.block_id)); - } - - void net_plugin_impl::transaction_ack(const std::pair& results) { - transaction_id_type id = results.second->id(); + void net_plugin_impl::transaction_ack(const std::pair& results) { + const auto& id = results.second->id; if (results.first) { fc_ilog(logger,"signaled NACK, trx-id = ${id} : ${why}",("id", id)("why", results.first->to_detail_string())); dispatcher->rejected_transaction(id); } else { fc_ilog(logger,"signaled ACK, trx-id = ${id}",("id", id)); - dispatcher->bcast_transaction(*results.second); + dispatcher->bcast_transaction(results.second); } } @@ -2852,9 +2842,8 @@ namespace eosio { auto allowed_it = std::find(allowed_peers.begin(), allowed_peers.end(), msg.key); auto private_it = private_keys.find(msg.key); bool found_producer_key = false; - producer_plugin* pp = app().find_plugin(); - if(pp != nullptr) - found_producer_key = pp->is_producer_key(msg.key); + if(producer_plug != nullptr) + found_producer_key = producer_plug->is_producer_key(msg.key); if( allowed_it == allowed_peers.end() && private_it == private_keys.end() && !found_producer_key) { elog( "Peer ${peer} sent a handshake with an unauthorized key: ${key}.", ("peer", msg.p2p_address)("key", msg.key)); @@ -2914,9 +2903,8 @@ namespace eosio { auto private_key_itr = private_keys.find(signer); if(private_key_itr != private_keys.end()) return private_key_itr->second.sign(digest); - producer_plugin* pp = app().find_plugin(); - if(pp != nullptr && pp->get_state() == abstract_plugin::started) - return pp->sign_compact(signer, digest); + if(producer_plug != nullptr && producer_plug->get_state() == abstract_plugin::started) + return producer_plug->sign_compact(signer, digest); return chain::signature_type(); } @@ -2995,7 +2983,6 @@ namespace eosio { ( "network-version-match", bpo::value()->default_value(false), "True to require exact match of peer network version.") ( "sync-fetch-span", bpo::value()->default_value(def_sync_fetch_span), "number of blocks to retrieve in a chunk from any individual peer during synchronization") - ( "max-implicit-request", bpo::value()->default_value(def_max_just_send), "maximum sizes of transaction or block messages that are sent without first sending a notice") ( "use-socket-read-watermark", bpo::value()->default_value(false), "Enable expirimental socket read watermark optimization") ( "p2p-discoverable", bpo::value()->default_value(false), "True to p2p discoverable.") @@ -3031,7 +3018,6 @@ namespace eosio { my->max_cleanup_time_ms = options.at("max-cleanup-time-msec").as(); my->txn_exp_period = def_txn_expire_wait; my->resp_expected_period = def_resp_expected_wait; - my->dispatcher->just_send_it_max = options.at( "max-implicit-request" ).as(); my->max_client_count = options.at( "max-clients" ).as(); my->max_nodes_per_host = options.at( "p2p-max-nodes-per-host" ).as(); my->num_clients = 0; @@ -3042,7 +3028,7 @@ namespace eosio { my->p2p_discoverable=options.at( "p2p-discoverable" ).as(); my->resolver = std::make_shared( std::ref( app().get_io_service())); - if( options.count( "p2p-listen-endpoint" )) { + if( options.count( "p2p-listen-endpoint" ) && options.at("p2p-listen-endpoint").as().length()) { my->p2p_address = options.at( "p2p-listen-endpoint" ).as(); auto host = my->p2p_address.substr( 0, my->p2p_address.find( ':' )); auto port = my->p2p_address.substr( host.size() + 1, my->p2p_address.size()); @@ -3053,21 +3039,22 @@ namespace eosio { my->listen_endpoint = *my->resolver->resolve( query ); my->acceptor.reset( new tcp::acceptor( app().get_io_service())); - } - if( options.count( "p2p-server-address" )) { - my->p2p_address = options.at( "p2p-server-address" ).as(); - } else { - if( my->listen_endpoint.address().to_v4() == address_v4::any()) { - boost::system::error_code ec; - auto host = host_name( ec ); - if( ec.value() != boost::system::errc::success ) { - FC_THROW_EXCEPTION( fc::invalid_arg_exception, - "Unable to retrieve host_name. ${msg}", ("msg", ec.message())); + if( options.count( "p2p-server-address" )) { + my->p2p_address = options.at( "p2p-server-address" ).as(); + } else { + if( my->listen_endpoint.address().to_v4() == address_v4::any()) { + boost::system::error_code ec; + auto host = host_name( ec ); + if( ec.value() != boost::system::errc::success ) { + + FC_THROW_EXCEPTION( fc::invalid_arg_exception, + "Unable to retrieve host_name. ${msg}", ("msg", ec.message())); + } + auto port = my->p2p_address.substr( my->p2p_address.find( ':' ), my->p2p_address.size()); + my->p2p_address = host + port; } - auto port = my->p2p_address.substr( my->p2p_address.find( ':' ), my->p2p_address.size()); - my->p2p_address = host + port; } } @@ -3115,7 +3102,7 @@ namespace eosio { my->chain_plug = app().find_plugin(); EOS_ASSERT( my->chain_plug, chain::missing_chain_plugin_exception, "" ); - my->chain_id = app().get_plugin().get_chain_id(); + my->chain_id = my->chain_plug->get_chain_id(); fc::rand_pseudo_bytes( my->node_id.data(), my->node_id.data_size()); ilog( "my node_id is ${id}", ("id", my->node_id)); @@ -3125,6 +3112,7 @@ namespace eosio { } void net_plugin::plugin_startup() { + my->producer_plug = app().find_plugin(); if( my->acceptor ) { my->acceptor->open(my->listen_endpoint.protocol()); my->acceptor->set_option(tcp::acceptor::reuse_address(true)); @@ -3141,12 +3129,7 @@ namespace eosio { } chain::controller&cc = my->chain_plug->chain(); { - cc.accepted_block_header.connect( boost::bind(&net_plugin_impl::accepted_block_header, my.get(), _1)); cc.accepted_block.connect( boost::bind(&net_plugin_impl::accepted_block, my.get(), _1)); - cc.irreversible_block.connect( boost::bind(&net_plugin_impl::irreversible_block, my.get(), _1)); - cc.accepted_transaction.connect( boost::bind(&net_plugin_impl::accepted_transaction, my.get(), _1)); - cc.applied_transaction.connect( boost::bind(&net_plugin_impl::applied_transaction, my.get(), _1)); - cc.accepted_confirmation.connect( boost::bind(&net_plugin_impl::accepted_confirmation, my.get(), _1)); } my->incoming_transaction_ack_subscription = app().get_channel().subscribe(boost::bind(&net_plugin_impl::transaction_ack, my.get(), _1)); @@ -3241,13 +3224,13 @@ namespace eosio { } return result; } - connection_ptr net_plugin_impl::find_connection( string host )const { + connection_ptr net_plugin_impl::find_connection(const string& host )const { for( const auto& c : connections ) if( c->peer_addr == host ) return c; return connection_ptr(); } - uint16_t net_plugin_impl::to_protocol_version (uint16_t v) { + uint16_t net_plugin_impl::to_protocol_version(uint16_t v) { if (v >= net_version_base) { v -= net_version_base; return (v > net_version_range) ? 0 : v; diff --git a/plugins/producer_api_plugin/include/eosio/producer_api_plugin/producer_api_plugin.hpp b/plugins/producer_api_plugin/include/eosio/producer_api_plugin/producer_api_plugin.hpp index 4e7a5925f8a..137ef7b0703 100644 --- a/plugins/producer_api_plugin/include/eosio/producer_api_plugin/producer_api_plugin.hpp +++ b/plugins/producer_api_plugin/include/eosio/producer_api_plugin/producer_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/producer_api_plugin/producer_api_plugin.cpp b/plugins/producer_api_plugin/producer_api_plugin.cpp index 13599d5f834..7fcde1ac98c 100644 --- a/plugins/producer_api_plugin/producer_api_plugin.cpp +++ b/plugins/producer_api_plugin/producer_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/producer_plugin/include/eosio/producer_plugin/producer_plugin.hpp b/plugins/producer_plugin/include/eosio/producer_plugin/producer_plugin.hpp index 7b967421502..c43f0e0f38b 100644 --- a/plugins/producer_plugin/include/eosio/producer_plugin/producer_plugin.hpp +++ b/plugins/producer_plugin/include/eosio/producer_plugin/producer_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/producer_plugin/producer_plugin.cpp b/plugins/producer_plugin/producer_plugin.cpp index bc29cd87ea3..7bcfb7042b7 100644 --- a/plugins/producer_plugin/producer_plugin.cpp +++ b/plugins/producer_plugin/producer_plugin.cpp @@ -1,11 +1,12 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include #include #include +#include #include #include @@ -131,6 +132,7 @@ class producer_plugin_impl : public std::enable_shared_from_this _producer_watermarks; pending_block_mode _pending_block_mode; transaction_id_with_expiry_index _persistent_transactions; + fc::optional _thread_pool; int32_t _max_transaction_time_ms; fc::microseconds _max_irreversible_block_age_us; @@ -145,6 +147,7 @@ class producer_plugin_impl : public std::enable_shared_from_this().chain(); + chain::controller& chain = chain_plug->chain(); const auto hbn = bsp->block_num; auto new_block_header = bsp->header; new_block_header.timestamp = new_block_header.timestamp.next(); @@ -293,7 +296,7 @@ class producer_plugin_impl : public std::enable_shared_from_thistimestamp < (fc::time_point::now() + fc::seconds( 7 )), block_from_the_future, "received a block from the future, ignoring it: ${id}", ("id", id) ); - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = chain_plug->chain(); /* de-dupe here... no point in aborting block if we already know the block */ auto existing = chain.fetch_block_by_id( id ); @@ -315,7 +318,7 @@ class producer_plugin_impl : public std::enable_shared_from_this().handle_guard_exception(e); + chain_plug->handle_guard_exception(e); return; } catch( const fc::exception& e ) { elog((e.to_detail_string())); @@ -343,10 +346,23 @@ class producer_plugin_impl : public std::enable_shared_from_this>> _pending_incoming_transactions; + std::deque>> _pending_incoming_transactions; + + void on_incoming_transaction_async(const transaction_metadata_ptr& trx, bool persist_until_expired, next_function next) { + chain::controller& chain = chain_plug->chain(); + const auto& cfg = chain.get_global_properties().configuration; + transaction_metadata::create_signing_keys_future( trx, *_thread_pool, chain.get_chain_id(), fc::microseconds( cfg.max_transaction_cpu_usage ) ); + boost::asio::post( *_thread_pool, [self = this, trx, persist_until_expired, next]() { + if( trx->signing_keys_future.valid() ) + trx->signing_keys_future.wait(); + app().get_io_service().post( [self, trx, persist_until_expired, next]() { + self->process_incoming_transaction_async( trx, persist_until_expired, next ); + }); + }); + } - void on_incoming_transaction_async(const packed_transaction_ptr& trx, bool persist_until_expired, next_function next) { - chain::controller& chain = app().get_plugin().chain(); + void process_incoming_transaction_async(const transaction_metadata_ptr& trx, bool persist_until_expired, next_function next) { + chain::controller& chain = chain_plug->chain(); if (!chain.pending_block_state()) { _pending_incoming_transactions.emplace_back(trx, persist_until_expired, next); return; @@ -357,34 +373,34 @@ class producer_plugin_impl : public std::enable_shared_from_this& response) { next(response); if (response.contains()) { - _transaction_ack_channel.publish(std::pair(response.get(), trx)); + _transaction_ack_channel.publish(std::pair(response.get(), trx)); if (_pending_block_mode == pending_block_mode::producing) { fc_dlog(_trx_trace_log, "[TRX_TRACE] Block ${block_num} for producer ${prod} is REJECTING tx: ${txid} : ${why} ", ("block_num", chain.head_block_num() + 1) ("prod", chain.pending_block_state()->header.producer) - ("txid", trx->id()) + ("txid", trx->id) ("why",response.get()->what())); } else { fc_dlog(_trx_trace_log, "[TRX_TRACE] Speculative execution is REJECTING tx: ${txid} : ${why} ", - ("txid", trx->id()) + ("txid", trx->id) ("why",response.get()->what())); } } else { - _transaction_ack_channel.publish(std::pair(nullptr, trx)); + _transaction_ack_channel.publish(std::pair(nullptr, trx)); if (_pending_block_mode == pending_block_mode::producing) { fc_dlog(_trx_trace_log, "[TRX_TRACE] Block ${block_num} for producer ${prod} is ACCEPTING tx: ${txid}", ("block_num", chain.head_block_num() + 1) ("prod", chain.pending_block_state()->header.producer) - ("txid", trx->id())); + ("txid", trx->id)); } else { fc_dlog(_trx_trace_log, "[TRX_TRACE] Speculative execution is ACCEPTING tx: ${txid}", - ("txid", trx->id())); + ("txid", trx->id)); } } }; - auto id = trx->id(); - if( fc::time_point(trx->expiration()) < block_time ) { + const auto& id = trx->id; + if( fc::time_point(trx->packed_trx->expiration()) < block_time ) { send_response(std::static_pointer_cast(std::make_shared(FC_LOG_MESSAGE(error, "expired transaction ${id}", ("id", id)) ))); return; } @@ -403,7 +419,7 @@ class producer_plugin_impl : public std::enable_shared_from_this(*trx), deadline); + auto trace = chain.push_transaction(trx, deadline); if (trace->except) { if (failure_is_subjective(*trace->except, deadline_is_subjective)) { _pending_incoming_transactions.emplace_back(trx, persist_until_expired, next); @@ -411,10 +427,10 @@ class producer_plugin_impl : public std::enable_shared_from_thisheader.producer) - ("txid", trx->id())); + ("txid", trx->id)); } else { fc_dlog(_trx_trace_log, "[TRX_TRACE] Speculative execution COULD NOT FIT tx: ${txid} RETRYING", - ("txid", trx->id())); + ("txid", trx->id)); } } else { auto e_ptr = trace->except->dynamic_copy_exception(); @@ -424,13 +440,13 @@ class producer_plugin_impl : public std::enable_shared_from_thisid(), trx->expiration()}); + _persistent_transactions.insert(transaction_id_with_expiry{trx->id, trx->packed_trx->expiration()}); } send_response(trace); } } catch ( const guard_exception& e ) { - app().get_plugin().handle_guard_exception(e); + chain_plug->handle_guard_exception(e); } catch ( boost::interprocess::bad_alloc& ) { chain_plugin::handle_db_exhaustion(); } CATCH_AND_CALL(send_response); @@ -533,6 +549,8 @@ void producer_plugin::set_program_options( "Maximum wall-clock time, in milliseconds, spent retiring scheduled transactions in any block before returning to normal transaction processing.") ("incoming-defer-ratio", bpo::value()->default_value(1.0), "ratio between incoming transations and deferred transactions when both are exhausted") + ("producer-threads", bpo::value()->default_value(config::default_controller_thread_pool_size), + "Number of worker threads in producer thread pool") ("snapshots-dir", bpo::value()->default_value("snapshots"), "the location of the snapshots directory (absolute path or relative to application data dir)") ; @@ -604,6 +622,8 @@ make_keosd_signature_provider(const std::shared_ptr& impl, void producer_plugin::plugin_initialize(const boost::program_options::variables_map& options) { try { + my->chain_plug = app().find_plugin(); + EOS_ASSERT( my->chain_plug, plugin_config_exception, "chain_plugin not found" ); my->_options = &options; LOAD_VALUE_SET(options, "producer-name", my->_producers, types::account_name) @@ -665,6 +685,11 @@ void producer_plugin::plugin_initialize(const boost::program_options::variables_ my->_incoming_defer_ratio = options.at("incoming-defer-ratio").as(); + auto thread_pool_size = options.at( "producer-threads" ).as(); + EOS_ASSERT( thread_pool_size > 0, plugin_config_exception, + "producer-threads ${num} must be greater than 0", ("num", thread_pool_size)); + my->_thread_pool.emplace( thread_pool_size ); + if( options.count( "snapshots-dir" )) { auto sd = options.at( "snapshots-dir" ).as(); if( sd.is_relative()) { @@ -686,7 +711,7 @@ void producer_plugin::plugin_initialize(const boost::program_options::variables_ } FC_LOG_AND_DROP(); }); - my->_incoming_transaction_subscription = app().get_channel().subscribe([this](const packed_transaction_ptr& trx){ + my->_incoming_transaction_subscription = app().get_channel().subscribe([this](const transaction_metadata_ptr& trx){ try { my->on_incoming_transaction_async(trx, false, [](const auto&){}); } FC_LOG_AND_DROP(); @@ -696,7 +721,7 @@ void producer_plugin::plugin_initialize(const boost::program_options::variables_ my->on_incoming_block(block); }); - my->_incoming_transaction_async_provider = app().get_method().register_provider([this](const packed_transaction_ptr& trx, bool persist_until_expired, next_function next) -> void { + my->_incoming_transaction_async_provider = app().get_method().register_provider([this](const transaction_metadata_ptr& trx, bool persist_until_expired, next_function next) -> void { return my->on_incoming_transaction_async(trx, persist_until_expired, next ); }); @@ -724,7 +749,7 @@ void producer_plugin::plugin_startup() ilog("producer plugin: plugin_startup() begin"); - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); EOS_ASSERT( my->_producers.empty() || chain.get_read_mode() == chain::db_read_mode::SPECULATIVE, plugin_config_exception, "node cannot have any producer-name configured because block production is impossible when read_mode is not \"speculative\"" ); @@ -766,6 +791,10 @@ void producer_plugin::plugin_shutdown() { edump((e.to_detail_string())); } + if( my->_thread_pool ) { + my->_thread_pool->join(); + my->_thread_pool->stop(); + } my->_accepted_block_connection.reset(); my->_irreversible_block_connection.reset(); } @@ -780,7 +809,7 @@ void producer_plugin::resume() { // re-evaluate that now // if (my->_pending_block_mode == pending_block_mode::speculating) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); chain.abort_block(); my->schedule_production_loop(); } @@ -819,13 +848,13 @@ void producer_plugin::update_runtime_options(const runtime_options& options) { } if (check_speculating && my->_pending_block_mode == pending_block_mode::speculating) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); chain.abort_block(); my->schedule_production_loop(); } if (options.subjective_cpu_leeway_us) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); chain.set_subjective_cpu_leeway(fc::microseconds(*options.subjective_cpu_leeway_us)); } } @@ -841,21 +870,21 @@ producer_plugin::runtime_options producer_plugin::get_runtime_options() const { } void producer_plugin::add_greylist_accounts(const greylist_params& params) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); for (auto &acc : params.accounts) { chain.add_resource_greylist(acc); } } void producer_plugin::remove_greylist_accounts(const greylist_params& params) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); for (auto &acc : params.accounts) { chain.remove_resource_greylist(acc); } } producer_plugin::greylist_params producer_plugin::get_greylist() const { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); greylist_params result; const auto& list = chain.get_resource_greylist(); result.accounts.reserve(list.size()); @@ -866,7 +895,7 @@ producer_plugin::greylist_params producer_plugin::get_greylist() const { } producer_plugin::whitelist_blacklist producer_plugin::get_whitelist_blacklist() const { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); return { chain.get_actor_whitelist(), chain.get_actor_blacklist(), @@ -878,7 +907,7 @@ producer_plugin::whitelist_blacklist producer_plugin::get_whitelist_blacklist() } void producer_plugin::set_whitelist_blacklist(const producer_plugin::whitelist_blacklist& params) { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); if(params.actor_whitelist.valid()) chain.set_actor_whitelist(*params.actor_whitelist); if(params.actor_blacklist.valid()) chain.set_actor_blacklist(*params.actor_blacklist); if(params.contract_whitelist.valid()) chain.set_contract_whitelist(*params.contract_whitelist); @@ -888,7 +917,7 @@ void producer_plugin::set_whitelist_blacklist(const producer_plugin::whitelist_b } producer_plugin::integrity_hash_information producer_plugin::get_integrity_hash() const { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); auto reschedule = fc::make_scoped_exit([this](){ my->schedule_production_loop(); @@ -905,7 +934,7 @@ producer_plugin::integrity_hash_information producer_plugin::get_integrity_hash( } producer_plugin::snapshot_information producer_plugin::create_snapshot() const { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = my->chain_plug->chain(); auto reschedule = fc::make_scoped_exit([this](){ my->schedule_production_loop(); @@ -936,7 +965,7 @@ producer_plugin::snapshot_information producer_plugin::create_snapshot() const { } optional producer_plugin_impl::calculate_next_block_time(const account_name& producer_name, const block_timestamp_type& current_block_time) const { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = chain_plug->chain(); const auto& hbs = chain.head_block_state(); const auto& active_schedule = hbs->active_schedule.producers; @@ -992,7 +1021,7 @@ optional producer_plugin_impl::calculate_next_block_time(const a } fc::time_point producer_plugin_impl::calculate_pending_block_time() const { - const chain::controller& chain = app().get_plugin().chain(); + const chain::controller& chain = chain_plug->chain(); const fc::time_point now = fc::time_point::now(); const fc::time_point base = std::max(now, chain.head_block_time()); const int64_t min_time_to_next_block = (config::block_interval_us) - (base.time_since_epoch().count() % (config::block_interval_us) ); @@ -1018,7 +1047,7 @@ enum class tx_category { producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = chain_plug->chain(); if( chain.get_read_mode() == chain::db_read_mode::READ_ONLY ) return start_block_result::waiting; @@ -1120,6 +1149,10 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { int orig_count = _persistent_transactions.size(); while(!persisted_by_expiry.empty() && persisted_by_expiry.begin()->expiry <= pbs->header.timestamp.to_time_point()) { + if (preprocess_deadline <= fc::time_point::now()) { + exhausted = true; + break; + } auto const& txid = persisted_by_expiry.begin()->trx_id; if (_pending_block_mode == pending_block_mode::producing) { fc_dlog(_trx_trace_log, "[TRX_TRACE] Block ${block_num} for producer ${prod} is EXPIRING PERSISTED tx: ${txid}", @@ -1135,9 +1168,15 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { num_expired_persistent++; } - fc_dlog(_log, "Processed ${n} persisted transactions, Expired ${expired}", - ("n", orig_count) - ("expired", num_expired_persistent)); + if( exhausted ) { + fc_wlog( _log, "Unable to process all ${n} persisted transactions before deadline, Expired ${expired}", + ( "n", orig_count ) + ( "expired", num_expired_persistent ) ); + } else { + fc_dlog( _log, "Processed ${n} persisted transactions, Expired ${expired}", + ( "n", orig_count ) + ( "expired", num_expired_persistent ) ); + } } try { @@ -1148,15 +1187,17 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { if (_producers.empty() && persisted_by_id.empty()) { // if this node can never produce and has no persisted transactions, // there is no need for unapplied transactions they can be dropped - chain.drop_all_unapplied_transactions(); + chain.get_unapplied_transactions().clear(); } else { - std::vector apply_trxs; - { // derive appliable transactions from unapplied_transactions and drop droppable transactions - auto unapplied_trxs = chain.get_unapplied_transactions(); - apply_trxs.reserve(unapplied_trxs.size()); - + // derive appliable transactions from unapplied_transactions and drop droppable transactions + unapplied_transactions_type& unapplied_trxs = chain.get_unapplied_transactions(); + if( !unapplied_trxs.empty() ) { + auto unapplied_trxs_size = unapplied_trxs.size(); + int num_applied = 0; + int num_failed = 0; + int num_processed = 0; auto calculate_transaction_category = [&](const transaction_metadata_ptr& trx) { - if (trx->packed_trx.expiration() < pbs->header.timestamp.to_time_point()) { + if (trx->packed_trx->expiration() < pbs->header.timestamp.to_time_point()) { return tx_category::EXPIRED; } else if (persisted_by_id.find(trx->id) != persisted_by_id.end()) { return tx_category::PERSISTED; @@ -1165,64 +1206,66 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { } }; - for (auto& trx: unapplied_trxs) { + auto itr = unapplied_trxs.begin(); + while( itr != unapplied_trxs.end() ) { + auto itr_next = itr; // save off next since itr may be invalidated by loop + ++itr_next; + + if( preprocess_deadline <= fc::time_point::now() ) exhausted = true; + if( exhausted ) break; + const auto& trx = itr->second; auto category = calculate_transaction_category(trx); - if (category == tx_category::EXPIRED || (category == tx_category::UNEXPIRED_UNPERSISTED && _producers.empty())) { + if (category == tx_category::EXPIRED || + (category == tx_category::UNEXPIRED_UNPERSISTED && _producers.empty())) + { if (!_producers.empty()) { fc_dlog(_trx_trace_log, "[TRX_TRACE] Node with producers configured is dropping an EXPIRED transaction that was PREVIOUSLY ACCEPTED : ${txid}", ("txid", trx->id)); } - chain.drop_unapplied_transaction(trx); - } else if (category == tx_category::PERSISTED || (category == tx_category::UNEXPIRED_UNPERSISTED && _pending_block_mode == pending_block_mode::producing)) { - apply_trxs.emplace_back(std::move(trx)); - } - } - } - if (!apply_trxs.empty()) { - int num_applied = 0; - int num_failed = 0; - int num_processed = 0; - - for (const auto& trx: apply_trxs) { - if (preprocess_deadline <= fc::time_point::now()) exhausted = true; - if (exhausted) { - break; - } - - num_processed++; - - try { - auto deadline = fc::time_point::now() + fc::milliseconds(_max_transaction_time_ms); - bool deadline_is_subjective = false; - if (_max_transaction_time_ms < 0 || (_pending_block_mode == pending_block_mode::producing && preprocess_deadline < deadline)) { - deadline_is_subjective = true; - deadline = preprocess_deadline; - } + itr = unapplied_trxs.erase( itr ); // unapplied_trxs map has not been modified, so simply erase and continue + continue; + } else if (category == tx_category::PERSISTED || + (category == tx_category::UNEXPIRED_UNPERSISTED && _pending_block_mode == pending_block_mode::producing)) + { + ++num_processed; + + try { + auto deadline = fc::time_point::now() + fc::milliseconds(_max_transaction_time_ms); + bool deadline_is_subjective = false; + if (_max_transaction_time_ms < 0 || (_pending_block_mode == pending_block_mode::producing && preprocess_deadline < deadline)) { + deadline_is_subjective = true; + deadline = preprocess_deadline; + } - auto trace = chain.push_transaction(trx, deadline); - if (trace->except) { - if (failure_is_subjective(*trace->except, deadline_is_subjective)) { - exhausted = true; + auto trace = chain.push_transaction(trx, deadline); + if (trace->except) { + if (failure_is_subjective(*trace->except, deadline_is_subjective)) { + exhausted = true; + break; + } else { + // this failed our configured maximum transaction time, we don't want to replay it + // chain.plus_transactions can modify unapplied_trxs, so erase by id + unapplied_trxs.erase( trx->signed_id ); + ++num_failed; + } } else { - // this failed our configured maximum transaction time, we don't want to replay it - chain.drop_unapplied_transaction(trx); - num_failed++; + ++num_applied; } - } else { - num_applied++; - } - } catch ( const guard_exception& e ) { - app().get_plugin().handle_guard_exception(e); - return start_block_result::failed; - } FC_LOG_AND_DROP(); + } catch ( const guard_exception& e ) { + chain_plug->handle_guard_exception(e); + return start_block_result::failed; + } FC_LOG_AND_DROP(); + } + + itr = itr_next; } fc_dlog(_log, "Processed ${m} of ${n} previously applied transactions, Applied ${applied}, Failed/Dropped ${failed}", - ("m", num_processed) - ("n", apply_trxs.size()) - ("applied", num_applied) - ("failed", num_failed)); + ("m", num_processed) + ("n", unapplied_trxs_size) + ("applied", num_applied) + ("failed", num_failed)); } } @@ -1235,6 +1278,7 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { int orig_count = _blacklisted_transactions.size(); while (!blacklist_by_expiry.empty() && blacklist_by_expiry.begin()->expiry <= now) { + if (preprocess_deadline <= fc::time_point::now()) break; blacklist_by_expiry.erase(blacklist_by_expiry.begin()); num_expired++; } @@ -1244,85 +1288,105 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { ("expired", num_expired)); } - auto scheduled_trxs = chain.get_scheduled_transactions(); - if (!scheduled_trxs.empty()) { - int num_applied = 0; - int num_failed = 0; - int num_processed = 0; + // scheduled transactions + int num_applied = 0; + int num_failed = 0; + int num_processed = 0; + + auto scheduled_trx_deadline = preprocess_deadline; + if (_max_scheduled_transaction_time_per_block_ms >= 0) { + scheduled_trx_deadline = std::min( + scheduled_trx_deadline, + fc::time_point::now() + fc::milliseconds(_max_scheduled_transaction_time_per_block_ms) + ); + } + time_point pending_block_time = chain.pending_block_time(); + const auto& sch_idx = chain.db().get_index(); + const auto scheduled_trxs_size = sch_idx.size(); + auto sch_itr = sch_idx.begin(); + while( sch_itr != sch_idx.end() ) { + if( sch_itr->delay_until > pending_block_time) break; // not scheduled yet + if( sch_itr->published >= pending_block_time ) { + ++sch_itr; + continue; // do not allow schedule and execute in same block + } + if( scheduled_trx_deadline <= fc::time_point::now() ) { + exhausted = true; + break; + } - auto scheduled_trx_deadline = preprocess_deadline; - if (_max_scheduled_transaction_time_per_block_ms >= 0) { - scheduled_trx_deadline = std::min( - scheduled_trx_deadline, - fc::time_point::now() + fc::milliseconds(_max_scheduled_transaction_time_per_block_ms) - ); + const transaction_id_type trx_id = sch_itr->trx_id; // make copy since reference could be invalidated + if (blacklist_by_id.find(trx_id) != blacklist_by_id.end()) { + ++sch_itr; + continue; } - for (const auto& trx : scheduled_trxs) { - if (scheduled_trx_deadline <= fc::time_point::now()) exhausted = true; - if (exhausted) { - break; - } + auto sch_itr_next = sch_itr; // save off next since sch_itr may be invalidated by loop + ++sch_itr_next; + const auto next_delay_until = sch_itr_next != sch_idx.end() ? sch_itr_next->delay_until : sch_itr->delay_until; + const auto next_id = sch_itr_next != sch_idx.end() ? sch_itr_next->id : sch_itr->id; - num_processed++; - - // configurable ratio of incoming txns vs deferred txns - while (_incoming_trx_weight >= 1.0 && orig_pending_txn_size && _pending_incoming_transactions.size()) { - if (scheduled_trx_deadline <= fc::time_point::now()) break; - - auto e = _pending_incoming_transactions.front(); - _pending_incoming_transactions.pop_front(); - --orig_pending_txn_size; - _incoming_trx_weight -= 1.0; - on_incoming_transaction_async(std::get<0>(e), std::get<1>(e), std::get<2>(e)); - } + num_processed++; - if (scheduled_trx_deadline <= fc::time_point::now()) { - exhausted = true; - break; - } + // configurable ratio of incoming txns vs deferred txns + while (_incoming_trx_weight >= 1.0 && orig_pending_txn_size && _pending_incoming_transactions.size()) { + if (scheduled_trx_deadline <= fc::time_point::now()) break; - if (blacklist_by_id.find(trx) != blacklist_by_id.end()) { - continue; - } + auto e = _pending_incoming_transactions.front(); + _pending_incoming_transactions.pop_front(); + --orig_pending_txn_size; + _incoming_trx_weight -= 1.0; + process_incoming_transaction_async(std::get<0>(e), std::get<1>(e), std::get<2>(e)); + } - try { - auto deadline = fc::time_point::now() + fc::milliseconds(_max_transaction_time_ms); - bool deadline_is_subjective = false; - if (_max_transaction_time_ms < 0 || (_pending_block_mode == pending_block_mode::producing && scheduled_trx_deadline < deadline)) { - deadline_is_subjective = true; - deadline = scheduled_trx_deadline; - } + if (scheduled_trx_deadline <= fc::time_point::now()) { + exhausted = true; + break; + } - auto trace = chain.push_scheduled_transaction(trx, deadline); - if (trace->except) { - if (failure_is_subjective(*trace->except, deadline_is_subjective)) { - exhausted = true; - } else { - auto expiration = fc::time_point::now() + fc::seconds(chain.get_global_properties().configuration.deferred_trx_expiration_window); - // this failed our configured maximum transaction time, we don't want to replay it add it to a blacklist - _blacklisted_transactions.insert(transaction_id_with_expiry{trx, expiration}); - num_failed++; - } + try { + auto deadline = fc::time_point::now() + fc::milliseconds(_max_transaction_time_ms); + bool deadline_is_subjective = false; + if (_max_transaction_time_ms < 0 || (_pending_block_mode == pending_block_mode::producing && scheduled_trx_deadline < deadline)) { + deadline_is_subjective = true; + deadline = scheduled_trx_deadline; + } + + auto trace = chain.push_scheduled_transaction(trx_id, deadline); + if (trace->except) { + if (failure_is_subjective(*trace->except, deadline_is_subjective)) { + exhausted = true; + break; } else { - num_applied++; + auto expiration = fc::time_point::now() + fc::seconds(chain.get_global_properties().configuration.deferred_trx_expiration_window); + // this failed our configured maximum transaction time, we don't want to replay it add it to a blacklist + _blacklisted_transactions.insert(transaction_id_with_expiry{trx_id, expiration}); + num_failed++; } - } catch ( const guard_exception& e ) { - app().get_plugin().handle_guard_exception(e); - return start_block_result::failed; - } FC_LOG_AND_DROP(); + } else { + num_applied++; + } + } catch ( const guard_exception& e ) { + chain_plug->handle_guard_exception(e); + return start_block_result::failed; + } FC_LOG_AND_DROP(); - _incoming_trx_weight += _incoming_defer_ratio; - if (!orig_pending_txn_size) _incoming_trx_weight = 0.0; - } + _incoming_trx_weight += _incoming_defer_ratio; + if (!orig_pending_txn_size) _incoming_trx_weight = 0.0; - fc_dlog(_log, "Processed ${m} of ${n} scheduled transactions, Applied ${applied}, Failed/Dropped ${failed}", - ("m", num_processed) - ("n", scheduled_trxs.size()) - ("applied", num_applied) - ("failed", num_failed)); + if( sch_itr_next == sch_idx.end() ) break; + sch_itr = sch_idx.lower_bound( boost::make_tuple( next_delay_until, next_id ) ); + } + if( scheduled_trxs_size > 0 ) { + fc_dlog( _log, + "Processed ${m} of ${n} scheduled transactions, Applied ${applied}, Failed/Dropped ${failed}", + ( "m", num_processed ) + ( "n", scheduled_trxs_size ) + ( "applied", num_applied ) + ( "failed", num_failed ) ); } + } if (exhausted || preprocess_deadline <= fc::time_point::now()) { @@ -1334,11 +1398,11 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { if (!_pending_incoming_transactions.empty()) { fc_dlog(_log, "Processing ${n} pending transactions"); while (orig_pending_txn_size && _pending_incoming_transactions.size()) { + if (preprocess_deadline <= fc::time_point::now()) return start_block_result::exhausted; auto e = _pending_incoming_transactions.front(); _pending_incoming_transactions.pop_front(); --orig_pending_txn_size; - on_incoming_transaction_async(std::get<0>(e), std::get<1>(e), std::get<2>(e)); - if (preprocess_deadline <= fc::time_point::now()) return start_block_result::exhausted; + process_incoming_transaction_async(std::get<0>(e), std::get<1>(e), std::get<2>(e)); } } return start_block_result::succeeded; @@ -1355,7 +1419,7 @@ producer_plugin_impl::start_block_result producer_plugin_impl::start_block() { } void producer_plugin_impl::schedule_production_loop() { - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = chain_plug->chain(); _timer.cancel(); std::weak_ptr weak_this = shared_from_this(); @@ -1466,7 +1530,7 @@ bool producer_plugin_impl::maybe_produce_block() { produce_block(); return true; } catch ( const guard_exception& e ) { - app().get_plugin().handle_guard_exception(e); + chain_plug->handle_guard_exception(e); return false; } FC_LOG_AND_DROP(); } catch ( boost::interprocess::bad_alloc&) { @@ -1475,7 +1539,7 @@ bool producer_plugin_impl::maybe_produce_block() { } fc_dlog(_log, "Aborting block due to produce_block error"); - chain::controller& chain = app().get_plugin().chain(); + chain::controller& chain = chain_plug->chain(); chain.abort_block(); return false; } @@ -1498,7 +1562,7 @@ static auto maybe_make_debug_time_logger() -> fc::optional().chain(); + chain::controller& chain = chain_plug->chain(); const auto& pbs = chain.pending_block_state(); const auto& hbs = chain.head_block_state(); EOS_ASSERT(pbs, missing_pending_block_state, "pending_block_state does not exist but it should, another plugin may have corrupted it"); diff --git a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_log.hpp b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_log.hpp index a580529c5d5..1644d29a404 100644 --- a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_log.hpp +++ b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_log.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_plugin.hpp b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_plugin.hpp index ce532d1c89e..f3429e2d190 100644 --- a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_plugin.hpp +++ b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_serialization.hpp b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_serialization.hpp index b000ac78803..37c817dd9cc 100644 --- a/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_serialization.hpp +++ b/plugins/state_history_plugin/include/eosio/state_history_plugin/state_history_serialization.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/state_history_plugin/state_history_plugin.cpp b/plugins/state_history_plugin/state_history_plugin.cpp index e625af5052a..67b61587440 100644 --- a/plugins/state_history_plugin/state_history_plugin.cpp +++ b/plugins/state_history_plugin/state_history_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/plugins/template_plugin/include/eosio/template_plugin/template_plugin.hpp b/plugins/template_plugin/include/eosio/template_plugin/template_plugin.hpp index 52b88b12ea0..3217b3b1640 100644 --- a/plugins/template_plugin/include/eosio/template_plugin/template_plugin.hpp +++ b/plugins/template_plugin/include/eosio/template_plugin/template_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/template_plugin/template_plugin.cpp b/plugins/template_plugin/template_plugin.cpp index 74dc6d7a508..d8a738c30bc 100644 --- a/plugins/template_plugin/template_plugin.cpp +++ b/plugins/template_plugin/template_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/plugins/test_control_api_plugin/include/eosio/test_control_api_plugin/test_control_api_plugin.hpp b/plugins/test_control_api_plugin/include/eosio/test_control_api_plugin/test_control_api_plugin.hpp index feac39a95ff..b9c165b8993 100644 --- a/plugins/test_control_api_plugin/include/eosio/test_control_api_plugin/test_control_api_plugin.hpp +++ b/plugins/test_control_api_plugin/include/eosio/test_control_api_plugin/test_control_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/test_control_api_plugin/test_control_api_plugin.cpp b/plugins/test_control_api_plugin/test_control_api_plugin.cpp index 16510b06460..307cccc197e 100644 --- a/plugins/test_control_api_plugin/test_control_api_plugin.cpp +++ b/plugins/test_control_api_plugin/test_control_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/test_control_plugin/include/eosio/test_control_plugin/test_control_plugin.hpp b/plugins/test_control_plugin/include/eosio/test_control_plugin/test_control_plugin.hpp index 0a40d9b6e36..96badb10c83 100644 --- a/plugins/test_control_plugin/include/eosio/test_control_plugin/test_control_plugin.hpp +++ b/plugins/test_control_plugin/include/eosio/test_control_plugin/test_control_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/test_control_plugin/test_control_plugin.cpp b/plugins/test_control_plugin/test_control_plugin.cpp index f2d630c6c59..483e859c30f 100644 --- a/plugins/test_control_plugin/test_control_plugin.cpp +++ b/plugins/test_control_plugin/test_control_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/txn_test_gen_plugin/include/eosio/txn_test_gen_plugin/txn_test_gen_plugin.hpp b/plugins/txn_test_gen_plugin/include/eosio/txn_test_gen_plugin/txn_test_gen_plugin.hpp index b33e4835158..ebfe3bfb77c 100644 --- a/plugins/txn_test_gen_plugin/include/eosio/txn_test_gen_plugin/txn_test_gen_plugin.hpp +++ b/plugins/txn_test_gen_plugin/include/eosio/txn_test_gen_plugin/txn_test_gen_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/txn_test_gen_plugin/txn_test_gen_plugin.cpp b/plugins/txn_test_gen_plugin/txn_test_gen_plugin.cpp index 6b4753e9919..707f75bd9de 100644 --- a/plugins/txn_test_gen_plugin/txn_test_gen_plugin.cpp +++ b/plugins/txn_test_gen_plugin/txn_test_gen_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -87,19 +87,38 @@ using namespace eosio::chain; api_handle->call_name(vs.at(0).as(), vs.at(1).as(), result_handler); struct txn_test_gen_plugin_impl { - static void push_next_transaction(const std::shared_ptr>& trxs, size_t index, const std::function& next ) { + + uint64_t _total_us = 0; + uint64_t _txcount = 0; + + int _remain = 0; + + void push_next_transaction(const std::shared_ptr>& trxs, size_t index, const std::function& next ) { chain_plugin& cp = app().get_plugin(); - cp.accept_transaction( packed_transaction(trxs->at(index)), [=](const fc::static_variant& result){ - if (result.contains()) { - next(result.get()); - } else { - if (index + 1 < trxs->size()) { - push_next_transaction(trxs, index + 1, next); + + const int overlap = 20; + int end = std::min(index + overlap, trxs->size()); + _remain = end - index; + for (int i = index; i < end; ++i) { + cp.accept_transaction( packed_transaction(trxs->at(i)), [=](const fc::static_variant& result){ + if (result.contains()) { + next(result.get()); } else { - next(nullptr); + if (result.contains() && result.get()->receipt) { + _total_us += result.get()->receipt->cpu_usage_us; + ++_txcount; + } + --_remain; + if (_remain == 0 ) { + if (end < trxs->size()) { + push_next_transaction(trxs, index + overlap, next); + } else { + next(nullptr); + } + } } - } - }); + }); + } } void push_transactions( std::vector&& trxs, const std::function& next ) { @@ -295,13 +314,11 @@ struct txn_test_gen_plugin_impl { try { controller& cc = app().get_plugin().chain(); auto chainid = app().get_plugin().get_chain_id(); - auto abi_serializer_max_time = app().get_plugin().get_abi_serializer_max_time(); - fc::crypto::private_key a_priv_key = fc::crypto::private_key::regenerate(fc::sha256(std::string(64, 'a'))); - fc::crypto::private_key b_priv_key = fc::crypto::private_key::regenerate(fc::sha256(std::string(64, 'b'))); + static fc::crypto::private_key a_priv_key = fc::crypto::private_key::regenerate(fc::sha256(std::string(64, 'a'))); + static fc::crypto::private_key b_priv_key = fc::crypto::private_key::regenerate(fc::sha256(std::string(64, 'b'))); static uint64_t nonce = static_cast(fc::time_point::now().sec_since_epoch()) << 32; - abi_serializer eosio_serializer(cc.db().find(config::system_account_name)->get_abi(), abi_serializer_max_time); uint32_t reference_block_num = cc.last_irreversible_block_num(); if (txn_reference_block_lag >= 0) { @@ -351,6 +368,11 @@ struct txn_test_gen_plugin_impl { timer.cancel(); running = false; ilog("Stopping transaction generation test"); + + if (_txcount) { + ilog("${d} transactions executed, ${t}us / transaction", ("d", _txcount)("t", _total_us / (double)_txcount)); + _txcount = _total_us = 0; + } } boost::asio::high_resolution_timer timer{app().get_io_service()}; diff --git a/plugins/wallet_api_plugin/include/eosio/wallet_api_plugin/wallet_api_plugin.hpp b/plugins/wallet_api_plugin/include/eosio/wallet_api_plugin/wallet_api_plugin.hpp index 74fc2878943..611eed638d9 100644 --- a/plugins/wallet_api_plugin/include/eosio/wallet_api_plugin/wallet_api_plugin.hpp +++ b/plugins/wallet_api_plugin/include/eosio/wallet_api_plugin/wallet_api_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/wallet_api_plugin/wallet_api_plugin.cpp b/plugins/wallet_api_plugin/wallet_api_plugin.cpp index 315ce810b16..0d88ec2966d 100644 --- a/plugins/wallet_api_plugin/wallet_api_plugin.cpp +++ b/plugins/wallet_api_plugin/wallet_api_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet.hpp b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet.hpp index e8b7c91a7e3..480e7a32a44 100644 --- a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet.hpp +++ b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_api.hpp b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_api.hpp index 0c80be0d880..0627eceff33 100644 --- a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_api.hpp +++ b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_api.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_manager.hpp b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_manager.hpp index efc10f1a7f9..e73bc32d971 100644 --- a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_manager.hpp +++ b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_manager.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_plugin.hpp b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_plugin.hpp index 1b0986fe8f9..c23911fa6fb 100644 --- a/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_plugin.hpp +++ b/plugins/wallet_plugin/include/eosio/wallet_plugin/wallet_plugin.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/plugins/wallet_plugin/se_wallet.cpp b/plugins/wallet_plugin/se_wallet.cpp index b292495c5cc..8b43d569881 100644 --- a/plugins/wallet_plugin/se_wallet.cpp +++ b/plugins/wallet_plugin/se_wallet.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/wallet_plugin/wallet.cpp b/plugins/wallet_plugin/wallet.cpp index accb2f948b9..53d57697ccd 100644 --- a/plugins/wallet_plugin/wallet.cpp +++ b/plugins/wallet_plugin/wallet.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/plugins/wallet_plugin/wallet_manager.cpp b/plugins/wallet_plugin/wallet_manager.cpp index d851d8156f6..15a39c9d9bd 100644 --- a/plugins/wallet_plugin/wallet_manager.cpp +++ b/plugins/wallet_plugin/wallet_manager.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/wallet_plugin/wallet_plugin.cpp b/plugins/wallet_plugin/wallet_plugin.cpp index 0416227b3a4..cfd435390a6 100644 --- a/plugins/wallet_plugin/wallet_plugin.cpp +++ b/plugins/wallet_plugin/wallet_plugin.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/plugins/wallet_plugin/yubihsm_wallet.cpp b/plugins/wallet_plugin/yubihsm_wallet.cpp index d3856ad8ee5..682fc02bbb0 100644 --- a/plugins/wallet_plugin/yubihsm_wallet.cpp +++ b/plugins/wallet_plugin/yubihsm_wallet.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/programs/cleos/config.hpp.in b/programs/cleos/config.hpp.in index 18673e9c8c2..3fe2051d74c 100644 --- a/programs/cleos/config.hpp.in +++ b/programs/cleos/config.hpp.in @@ -1,5 +1,5 @@ /** @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See config.hpp.in for changes. */ diff --git a/programs/cleos/help_text.cpp b/programs/cleos/help_text.cpp index 84173e0dda8..b1f9161a54d 100644 --- a/programs/cleos/help_text.cpp +++ b/programs/cleos/help_text.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include "help_text.hpp" #include "localize.hpp" diff --git a/programs/cleos/help_text.hpp b/programs/cleos/help_text.hpp index cb0f21a828e..dbae493d714 100644 --- a/programs/cleos/help_text.hpp +++ b/programs/cleos/help_text.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once #include diff --git a/programs/cleos/httpc.hpp b/programs/cleos/httpc.hpp index 850b7bab787..a5db5dbe90f 100644 --- a/programs/cleos/httpc.hpp +++ b/programs/cleos/httpc.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/programs/cleos/localize.hpp b/programs/cleos/localize.hpp index 72cd073e813..ea15ea3009b 100644 --- a/programs/cleos/localize.hpp +++ b/programs/cleos/localize.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/programs/cleos/main.cpp b/programs/cleos/main.cpp index ddcb8c11728..bc9373b84a1 100644 --- a/programs/cleos/main.cpp +++ b/programs/cleos/main.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * @defgroup eosclienttool EOSIO Command Line Client Reference * @brief Tool for sending transactions and querying state from @ref nodeos * @ingroup eosclienttool diff --git a/programs/eosio-launcher/config.hpp.in b/programs/eosio-launcher/config.hpp.in index 1bb4d10b59a..f60e6ab19e5 100644 --- a/programs/eosio-launcher/config.hpp.in +++ b/programs/eosio-launcher/config.hpp.in @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See config.hpp.in for changes. */ diff --git a/programs/eosio-launcher/main.cpp b/programs/eosio-launcher/main.cpp index 597e473b677..55a027b6928 100644 --- a/programs/eosio-launcher/main.cpp +++ b/programs/eosio-launcher/main.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * @brief launch testnet nodes **/ #include diff --git a/programs/keosd/config.hpp.in b/programs/keosd/config.hpp.in index a7d34f390dc..370f88db1a9 100644 --- a/programs/keosd/config.hpp.in +++ b/programs/keosd/config.hpp.in @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See config.hpp.in for changes. */ diff --git a/programs/keosd/main.cpp b/programs/keosd/main.cpp index c457af3c0e3..efbf2d567f2 100644 --- a/programs/keosd/main.cpp +++ b/programs/keosd/main.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/programs/nodeos/config.hpp.in b/programs/nodeos/config.hpp.in index ac595383297..dbeba72a3d1 100644 --- a/programs/nodeos/config.hpp.in +++ b/programs/nodeos/config.hpp.in @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE * * \warning This file is machine generated. DO NOT EDIT. See config.hpp.in for changes. */ diff --git a/scripts/boost.rb b/scripts/boost.rb new file mode 100644 index 00000000000..a322acbdd11 --- /dev/null +++ b/scripts/boost.rb @@ -0,0 +1,131 @@ +class Boost < Formula + desc "Collection of portable C++ source libraries" + homepage "https://www.boost.org/" + revision 1 + head "https://github.com/boostorg/boost.git" + + stable do + url "https://dl.bintray.com/boostorg/release/1.67.0/source/boost_1_67_0.tar.bz2" + sha256 "2684c972994ee57fc5632e03bf044746f6eb45d4920c343937a465fd67a5adba" + + # Remove for > 1.67.0 + # Fix "error: no member named 'next' in namespace 'boost'" + # Upstream commit from 1 Dec 2017 "Add #include ; no + # longer in utility.hpp" + patch :p2 do + url "https://github.com/boostorg/lockfree/commit/12726cd.patch?full_index=1" + sha256 "f165823d961a588b622b20520668b08819eb5fdc08be7894c06edce78026ce0a" + end + end + + bottle do + cellar :any + sha256 "265ab8beaa6fa26a7c305ef2e6aec8bd26ca1db105aca0aaca028f32c5245a90" => :high_sierra + sha256 "567f3e9a294413c1701b698d666a521cfdeec846e256c6e66576d5b70eb26f08" => :sierra + sha256 "3f3f687a620f656fe2ac54f01306e00e6bbc0e9797db284a8d272648d427e640" => :el_capitan + end + + option "with-icu4c", "Build regexp engine with icu support" + option "without-single", "Disable building single-threading variant" + option "without-static", "Disable building static library variant" + + deprecated_option "with-icu" => "with-icu4c" + + depends_on "icu4c" => :optional + + def install + # Force boost to compile with the desired compiler + open("user-config.jam", "a") do |file| + file.write "using darwin : : #{ENV.cxx} ;\n" + end + + # libdir should be set by --prefix but isn't + bootstrap_args = ["--prefix=#{prefix}", "--libdir=#{lib}"] + + if build.with? "icu4c" + icu4c_prefix = Formula["icu4c"].opt_prefix + bootstrap_args << "--with-icu=#{icu4c_prefix}" + else + bootstrap_args << "--without-icu" + end + + # Handle libraries that will not be built. + without_libraries = ["python", "mpi"] + + # Boost.Log cannot be built using Apple GCC at the moment. Disabled + # on such systems. + without_libraries << "log" if ENV.compiler == :gcc + + bootstrap_args << "--without-libraries=#{without_libraries.join(",")}" + + # layout should be synchronized with boost-python and boost-mpi + args = ["--prefix=#{prefix}", + "--libdir=#{lib}", + "-d2", + "-j#{ENV.make_jobs}", + "--layout=tagged", + "--user-config=user-config.jam", + "-sNO_LZMA=1", + "install"] + + if build.with? "single" + args << "threading=multi,single" + else + args << "threading=multi" + end + + if build.with? "static" + args << "link=shared,static" + else + args << "link=shared" + end + + # Trunk starts using "clang++ -x c" to select C compiler which breaks C++11 + # handling using ENV.cxx11. Using "cxxflags" and "linkflags" still works. + args << "cxxflags=-std=c++11" + if ENV.compiler == :clang + args << "cxxflags=-stdlib=libc++" << "linkflags=-stdlib=libc++" + end + + system "./bootstrap.sh", *bootstrap_args + system "./b2", "headers" + system "./b2", *args + end + + def caveats + s = "" + # ENV.compiler doesn't exist in caveats. Check library availability + # instead. + if Dir["#{lib}/libboost_log*"].empty? + s += <<~EOS + Building of Boost.Log is disabled because it requires newer GCC or Clang. + EOS + end + + s + end + + test do + (testpath/"test.cpp").write <<~EOS + #include + #include + #include + #include + using namespace boost::algorithm; + using namespace std; + + int main() + { + string str("a,b"); + vector strVec; + split(strVec, str, is_any_of(",")); + assert(strVec.size()==2); + assert(strVec[0]=="a"); + assert(strVec[1]=="b"); + return 0; + } + EOS + system ENV.cxx, "test.cpp", "-std=c++1y", "-L#{lib}", "-lboost_system", "-o", "test" + system "./test" + end +end diff --git a/scripts/eosio_build_amazon.sh b/scripts/eosio_build_amazon.sh index 2dc523870a8..ea690973846 100644 --- a/scripts/eosio_build_amazon.sh +++ b/scripts/eosio_build_amazon.sh @@ -56,11 +56,11 @@ if [[ "${OS_NAME}" == "Amazon Linux AMI" ]]; then DEP_ARRAY=( git gcc72.x86_64 gcc72-c++.x86_64 autoconf automake libtool make bzip2 \ bzip2-devel.x86_64 openssl-devel.x86_64 gmp-devel.x86_64 libstdc++72.x86_64 \ - python27.x86_64 python36-devel.x86_64 libedit-devel.x86_64 doxygen.x86_64 graphviz.x86_64) + python27.x86_64 python27-devel.x86_64 python36-devel.x86_64 libedit-devel.x86_64 doxygen.x86_64 graphviz.x86_64) else - DEP_ARRAY=( git gcc.x86_64 gcc-c++.x86_64 autoconf automake libtool make bzip2 \ - bzip2-devel.x86_64 openssl-devel.x86_64 gmp-devel.x86_64 libstdc++.x86_64 \ - python3.x86_64 python3-devel.x86_64 libedit-devel.x86_64 doxygen.x86_64 graphviz.x86_64) + DEP_ARRAY=( git gcc gcc-c++ autoconf automake libtool make bzip2 \ + bzip2-devel openssl-devel gmp-devel libstdc++ \ + python3 python3-devel python-devel libedit-devel doxygen graphviz) fi COUNT=1 DISPLAY="" @@ -87,6 +87,7 @@ printf "\\n\\tThe following dependencies are required to install EOSIO.\\n" printf "\\n\\t${DISPLAY}\\n\\n" printf "\\tDo you wish to install these dependencies?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) diff --git a/scripts/eosio_build_centos.sh b/scripts/eosio_build_centos.sh index 60810199f73..49debdf68e8 100644 --- a/scripts/eosio_build_centos.sh +++ b/scripts/eosio_build_centos.sh @@ -63,6 +63,7 @@ SCL=$( rpm -qa | grep -E 'centos-release-scl-[0-9].*' ) if [ -z "${SCL}" ]; then printf "\\t - Do you wish to install and enable this repository?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) @@ -87,6 +88,7 @@ DEVTOOLSET=$( rpm -qa | grep -E 'devtoolset-7-[0-9].*' ) if [ -z "${DEVTOOLSET}" ]; then printf "\\tDo you wish to install devtoolset-7?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) @@ -118,6 +120,7 @@ PYTHON33=$( rpm -qa | grep -E 'python33-[0-9].*' ) if [ -z "${PYTHON33}" ]; then printf "\\tDo you wish to install python33?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) @@ -170,6 +173,7 @@ printf "\\tThe following dependencies are required to install EOSIO.\\n" printf "\\t${DISPLAY}\\n\\n" printf "\\tDo you wish to install these dependencies?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) diff --git a/scripts/eosio_build_darwin.sh b/scripts/eosio_build_darwin.sh index f3ee81cf467..bc4a20ebd58 100644 --- a/scripts/eosio_build_darwin.sh +++ b/scripts/eosio_build_darwin.sh @@ -70,6 +70,7 @@ then printf "\\tHomebrew must be installed to compile EOS.IO\\n\\n" printf "\\tDo you wish to install Home Brew?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case "${yn}" in [Yy]* ) @@ -138,6 +139,7 @@ printf "\\n\\tThe following dependencies are required to install EOSIO.\\n" printf "\\n\\t${DISPLAY}\\n\\n" echo "Do you wish to install these packages?" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) @@ -159,13 +161,12 @@ printf "\\tExiting now.\\n\\n" exit 1; fi - if [[ "$DEP" == "llvm@4" ]]; then - "${BREW}" unlink ${DEP} - elif ! "${BREW}" unlink ${DEP} && "${BREW}" link --force ${DEP} - then - printf "\\tHomebrew exited with the above errors.\\n" - printf "\\tExiting now.\\n\\n" - exit 1; + if [ $PERMISSION_GETTEXT -eq 1 ]; then + if ! "${BREW}" link --force gettext; then + printf "\\tHomebrew exited with the above errors.\\n" + printf "\\tExiting now.\\n\\n" + exit 1; + fi fi break;; [Nn]* ) echo "User aborting installation of required dependencies, Exiting now."; exit;; @@ -184,6 +185,7 @@ printf "\\tFound Boost Version %s.\\n" "${BVERSION}" printf "\\tEOS.IO requires Boost version 1.67.\\n" printf "\\tWould you like to uninstall version %s and install Boost version 1.67.\\n" "${BVERSION}" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) @@ -218,7 +220,7 @@ done fi printf "\\tInstalling boost libraries.\\n" - if ! "${BREW}" install https://raw.githubusercontent.com/Homebrew/homebrew-core/f946d12e295c8a27519b73cc810d06593270a07f/Formula/boost.rb + if ! "${BREW}" install "${SOURCE_DIR}/scripts/boost.rb" then printf "\\tUnable to install boost 1.67 libraries at this time. 0\\n" printf "\\tExiting now.\\n\\n" diff --git a/scripts/eosio_build_fedora.sh b/scripts/eosio_build_fedora.sh index fbf6fcbf986..b608cf00978 100644 --- a/scripts/eosio_build_fedora.sh +++ b/scripts/eosio_build_fedora.sh @@ -86,6 +86,7 @@ printf "\\n\\tThe following dependencies are required to install EOSIO.\\n" printf "\\n\\t${DISPLAY}\\n\\n" printf "\\tDo you wish to install these dependencies?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) diff --git a/scripts/eosio_build_ubuntu.sh b/scripts/eosio_build_ubuntu.sh index ab3e8823d8e..373093e237d 100644 --- a/scripts/eosio_build_ubuntu.sh +++ b/scripts/eosio_build_ubuntu.sh @@ -91,6 +91,7 @@ printf "\\n\\tThe following dependencies are required to install EOSIO.\\n" printf "\\n\\t${DISPLAY}\\n\\n" printf "\\tDo you wish to install these packages?\\n" + if is_noninteractive; then exec <<< "1"; fi select yn in "Yes" "No"; do case $yn in [Yy]* ) diff --git a/scripts/generate_deb.sh b/scripts/generate_deb.sh index 5009f7627b3..9af16c069f3 100644 --- a/scripts/generate_deb.sh +++ b/scripts/generate_deb.sh @@ -13,19 +13,16 @@ fi NAME="${PROJECT}_${VERSION_NO_SUFFIX}-${RELEASE}_amd64" -DEPS_STR="" -for dep in "${DEPS[@]}"; do - DEPS_STR="${DEPS_STR} Depends: ${dep}" -done mkdir -p ${PROJECT}/DEBIAN -echo "Package: ${PROJECT} +chmod 0755 ${PROJECT}/DEBIAN +echo "Package: ${PROJECT} Version: ${VERSION_NO_SUFFIX}-${RELEASE} Section: devel Priority: optional -Depends: libbz2-dev (>= 1.0), libssl-dev (>= 1.0), libgmp3-dev, build-essential, libicu-dev, zlib1g-dev +Depends: libbz2-dev (>= 1.0), libssl-dev (>= 1.0), libgmp3-dev, build-essential, libicu-dev, zlib1g-dev, libtinfo5 Architecture: amd64 -Homepage: ${URL} -Maintainer: ${EMAIL} +Homepage: ${URL} +Maintainer: ${EMAIL} Description: ${DESC}" &> ${PROJECT}/DEBIAN/control export PREFIX @@ -35,7 +32,10 @@ export SSUBPREFIX bash generate_tarball.sh ${NAME}.tar.gz -tar -xvzf ${NAME}.tar.gz -C ${PROJECT} -dpkg-deb --build ${PROJECT} +tar -xvzf ${NAME}.tar.gz -C ${PROJECT} +dpkg-deb --build ${PROJECT} +BUILDSTATUS=$? mv ${PROJECT}.deb ${NAME}.deb rm -r ${PROJECT} + +exit $BUILDSTATUS diff --git a/scripts/generate_package.sh.in b/scripts/generate_package.sh.in index 5d8aedebb70..9c190ed7d87 100644 --- a/scripts/generate_package.sh.in +++ b/scripts/generate_package.sh.in @@ -35,4 +35,9 @@ else echo "Error, unknown package type. Use either ['brew', 'deb', 'rpm']." exit -1 fi + +BUILDSTATUS=$? + rm -r tmp + +exit $BUILDSTATUS diff --git a/scripts/generate_rpm.sh b/scripts/generate_rpm.sh index 35b60a4c816..8d7ebf03caa 100644 --- a/scripts/generate_rpm.sh +++ b/scripts/generate_rpm.sh @@ -47,5 +47,8 @@ ${DESC} %files -f filenames.txt" &> ${PROJECT}.spec rpmbuild -bb ${PROJECT}.spec +BUILDSTATUS=$? mv ~/rpmbuild/RPMS/x86_64 ./ rm -r ${PROJECT} ~/rpmbuild/BUILD/filenames.txt ${PROJECT}.spec + +exit $BUILDSTATUS diff --git a/tests/Cluster.py b/tests/Cluster.py index f26c5980339..06a5357e9af 100644 --- a/tests/Cluster.py +++ b/tests/Cluster.py @@ -896,7 +896,7 @@ def bios_bootstrap(totalNodes, biosHost, biosPort, walletMgr, silent=False): contract="eosio.token" action="transfer" for name, keys in producerKeys.items(): - data="{\"from\":\"eosio\",\"to\":\"%s\",\"quantity\":\"%s\",\"memo\":\"%s\"}" % (name, initialFunds, "init transfer") + data="{\"from\":\"eosio\",\"to\":\"%s\",\"quantity\":\"%s\",\"memo\":\"%s\"}" % (name, initialFunds, "init eosio transfer") opts="--permission eosio@active" if name != "eosio": trans=biosNode.pushMessage(contract, action, data, opts) diff --git a/tests/main.cpp b/tests/main.cpp index ad2b5846210..0644ce80545 100644 --- a/tests/main.cpp +++ b/tests/main.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/tests/validate-dirty-db.py b/tests/validate-dirty-db.py index 68a62701dd6..ac7520bc353 100755 --- a/tests/validate-dirty-db.py +++ b/tests/validate-dirty-db.py @@ -91,7 +91,7 @@ def runNodeosAndGetOutput(myTimeout=3): assert(ret) assert(isinstance(ret, tuple)) if not ret[0]: - errorExit("Failed to startup nodeos sucessfully on try number %d" % (i)) + errorExit("Failed to startup nodeos successfully on try number %d" % (i)) assert(ret[1]) assert(isinstance(ret[1], dict)) # pylint: disable=unsubscriptable-object diff --git a/tests/wallet_tests.cpp b/tests/wallet_tests.cpp index 0891b030906..28290fef211 100644 --- a/tests/wallet_tests.cpp +++ b/tests/wallet_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -173,7 +173,8 @@ BOOST_AUTO_TEST_CASE(wallet_manager_test) pubkeys.emplace(pkey1.get_public_key()); pubkeys.emplace(pkey2.get_public_key()); trx = wm.sign_transaction(trx, pubkeys, chain_id ); - const auto& pks = trx.get_signature_keys(chain_id); + flat_set pks; + trx.get_signature_keys(chain_id, fc::time_point::maximum(), pks); BOOST_CHECK_EQUAL(2, pks.size()); BOOST_CHECK(find(pks.cbegin(), pks.cend(), pkey1.get_public_key()) != pks.cend()); BOOST_CHECK(find(pks.cbegin(), pks.cend(), pkey2.get_public_key()) != pks.cend()); diff --git a/tools/validate_reflection.py b/tools/validate_reflection.py new file mode 100755 index 00000000000..52cae39bc30 --- /dev/null +++ b/tools/validate_reflection.py @@ -0,0 +1,698 @@ +#!/usr/bin/env python3 + +import argparse +from collections import OrderedDict +import re +import os +import sys +import traceback + +############################################################### +# validate_reflection +# +# +# Looks for files with FC_REFLECT macros. Requires fields to match class definition (provided in same file), +# unless the FC_REFLECT is proceeded by "// @ignore , , ..., " to indicate that field1, +# field2, ... fieldN are not reflected and/or "// @swap , , ..., " to indicate that +# field1, field2, ... fieldN are not in the same order as the class definition. +# +# NOTE: If swapping fields the script expects you to only indicate fields that are not in the expected order, +# so once it runs into the swapped field, it will remove that field from the order and expect the remaining in +# that order, so if the class has field1, field2, field3, and field4, and the reflect macro has the order +# field1, field3, field2, then field4, it should indicate swapping field2. This will remove field2 from the +# expected order and the rest will now match. Alternatively it should indicate swapping field3, since the remaining +# fields will also match the order. But both field2 and field3 should not be indicated. +# +# +# +############################################################### + +import atexit +import tempfile + +@atexit.register +def close_debug_file(): + if debug_file != None: + debug_file.close() + + +parser = argparse.ArgumentParser(add_help=False) +parser.add_argument('-?', action='help', default=argparse.SUPPRESS, + help=argparse._('show this help message and exit')) +parser.add_argument('-d', '--debug', help="generate debug output into a temporary directory", action='store_true') +parser.add_argument('-r', '--recurse', help="recurse through an entire directory (if directory provided for \"file\"", action='store_true') +parser.add_argument('-x', '--extension', type=str, help="extensions array to allow for directory and recursive search. Defaults to \".hpp\" and \".cpp\".", action='append') +parser.add_argument('-e', '--exit-on-error', help="Exit immediately when a validation error is discovered. Default is to run validation on all files and directories provided.", action='store_true') +parser.add_argument('files', metavar='file', nargs='+', type=str, help="File containing nodes info in JSON format.") +args = parser.parse_args() + +recurse = args.recurse +if args.debug: + temp_dir = tempfile.mkdtemp() + print("temporary files writen to %s" % (temp_dir)) + debug_file = open(os.path.join(temp_dir, "validate_reflect.debug"), "w") +else: + debug_file = None +extensions = [] +if args.extension is None or len(args.extension) == 0: + extensions = [".hpp",".cpp"] +else: + for extension in args.extension: + assert len(extension) > 0, "empty --extension passed in" + if extension[0] != ".": + extension = "." + extension + extensions.append(extension) +print("extensions=%s" % (",".join(extensions))) +ignore_str = "@ignore" +swap_str = "@swap" +fc_reflect_str = "FC_REFLECT" +fc_reflect_possible_enum_ext = "(?:_ENUM)?" +fc_reflect_derived_ext = "(?:_DERIVED)" + +def debug(debug_str): + if debug_file is not None: + debug_file.write(debug_str + "\n") + +class EmptyScope: + single_comment_pattern = re.compile(r'//.*\n+') + single_comment_ignore_swap_pattern = re.compile(r'//\s*(?:%s|%s)\s' % (ignore_str, swap_str)) + multi_line_comment_pattern = re.compile(r'/\*(.*?)\*/', re.MULTILINE | re.DOTALL) + ignore_swap_pattern = re.compile(r'^\s*(%s|%s)\s+(.*)$' % (ignore_str, swap_str), re.DOTALL) + strip_extra_pattern = re.compile(r'\n\s*\*\s*') + invalid_chars_pattern = re.compile(r'([^\w\s,])') + multi_line_comment_ignore_swap_pattern = re.compile(r'(\w+)(?:\s*,\s*)?') + namespace_str = "namespace" + struct_str = "struct" + class_str = "class" + enum_str = "enum" + any_scope_pattern = re.compile(r'\{', re.DOTALL) + start_char = "{" + end_char = "}" + + def __init__(self, name, start, content, parent_scope): + pname = parent_scope.name if parent_scope is not None else "" + debug("EmptyScope.__init__ %s %d - Parent %s" % (name, start, pname)) + self.name = name + self.content = content + self.start = start + self.current = start + 1 + self.parent_scope = parent_scope + self.end = len(content) - 1 if start == 0 else None + self.children = {} + self.children_ordered = [] + self.fields = [] + self.usings = {} + self.inherit = None + + def read(self): + debug("EmptyScope(%s).read - %s" % (self.__class__.__name__, self.name)) + end = len(self.content) - 1 + while self.current < end: + next_scope = self.next_scope() + if next_scope is None: + break + self.add(next_scope) + + if self.end is None: + self.end = self.content.find(EmptyScope.end_char, self.current, len(self.content)) + pdesc = str(self.parent_scope) if self.parent_scope is not None else "" + assert self.end != -1, "Could not find \"%s\" in \"%s\" - parent scope - %s" % (EmptyScope.end_char, self.content[self.current:], pdesc) + debug("EmptyScope(%s).read - %s - Done at %s" % (self.__class__.__name__, self.name, self.end)) + + def add(self, child): + debug("EmptyScope.add %s (%s) to %s (%s) - DROP" % (child.name, child.__class__.__name__, self.name, self.__class__.__name__)) + pass + + def find_scope_start(self, content, start, end, find_str): + debug("EmptyScope.find_scope_start") + loc = content.find(find_str, start, end) + if loc == -1: + return loc + else: + return loc + len(find_str) - len(EmptyScope.start_char) + + def find_possible_end(self): + possible = self.content.find(EmptyScope.end_char, self.current) + debug("EmptyScope.find_possible_end current=%s possible end=%s" % (self.current, possible)) + return possible + + def next_scope(self, end = None): + if end is None: + end = self.find_possible_end() + debug("EmptyScope.next_scope current=%s end=%s" % (self.current, end)) + match = EmptyScope.any_scope_pattern.search(self.content[self.current:end]) + if match: + start = self.find_scope_start(self.content, self.current, end, EmptyScope.start_char) + new_scope = EmptyScope(None, start, self.content, self) + new_scope.read() + self.current = new_scope.end + 1 + return new_scope + + return None + + def find_class(self, scoped_name): + scope_separator = "::" + loc = scoped_name.find(scope_separator) + if loc != -1: + child_name = scoped_name[0:loc] + loc += len(scope_separator) + child_scoped_name = scoped_name[loc:] + if child_name in self.children: + debug("find_class traverse child_name: %s, child_scoped_name: %s" % (child_name, child_scoped_name)) + return self.children[child_name].find_class(child_scoped_name) + elif self.inherit is not None and scoped_name in self.inherit.children: + debug("find_class found scoped_name: %s in inherited: %s" % (scoped_name, self.inherit.name)) + return self.inherit.children[scoped_name].find_class(child_scoped_name) + else: + if scoped_name not in self.children: + inherit_children = ",".join(self.inherit.children) if self.inherit is not None else "no inheritance" + inherit_using = ",".join(self.inherit.usings) if self.inherit is not None else "no inheritance" + inherit = self.inherit.name if self.inherit is not None else None + debug("find_class %s not in children, using: %s, inherit: %s - children: %s, using: %s" % (scoped_name, ",".join(self.usings), inherit, inherit_children, inherit_using)) + + if scoped_name in self.children: + debug("find_class found scoped_name: %s" % (scoped_name)) + return self.children[scoped_name] + elif scoped_name in self.usings: + using = self.usings[scoped_name] + debug("find_class found scoped_name: %s, using: %s" % (scoped_name, using)) + return self.find_class(using) + elif self.inherit is not None and scoped_name in self.inherit.children: + debug("find_class found scoped_name: %s in inherited: %s" % (scoped_name, self.inherit.name)) + return self.inherit.children[scoped_name] + else: + debug("find_class could not find scoped_name: %s, children: %s" % (scoped_name, ",".join(self.children))) + return None + + def __str__(self): + indent = "" + next = self.parent_scope + while next is not None: + indent += " " + next = next.parent_scope + desc = "%s%s scope type=\"%s\"\n%s children={\n" % (indent, self.name, self.__class__.__name__, indent) + for child in self.children_ordered: + desc += str(self.children[child]) + "\n" + desc += indent + " }\n" + desc += indent + " fields={\n" + for field in self.fields: + desc += indent + " " + field + "\n" + desc += indent + " }\n" + desc += indent + " usings={\n" + for using in self.usings: + desc += indent + " " + using + ": " + self.usings[using] + "\n" + desc += indent + " }\n" + return desc + +def create_scope(type, name, inherit, start, content, parent_scope): + debug("create_scope") + if type == EmptyScope.namespace_str: + return Namespace(name, inherit, start, content, parent_scope) + elif type == EmptyScope.class_str or type == EmptyScope.struct_str: + return ClassStruct(name, inherit, start, content, parent_scope, is_enum = False) + elif type == EmptyScope.enum_str: + return ClassStruct(name, inherit, start, content, parent_scope, is_enum = True) + else: + assert False, "Script does not account for type = \"%s\" found in \"%s\"" % (type, content[start:]) + +class ClassStruct(EmptyScope): + field_pattern = re.compile(r'\n\s*?(?:mutable\s+)?(\w[\w:\d<>]*)\s+(\w+)\s*(?:=\s[^;]+;|;|=\s*{)', re.MULTILINE | re.DOTALL) + enum_field_pattern = re.compile(r'\n\s*?(\w+)\s*(?:=\s*[^,}\s]+)?\s*(?:,|})', re.MULTILINE | re.DOTALL) + class_pattern = re.compile(r'(%s|%s|%s)\s+(\w+)\s*(:\s*public\s+([^<\s]+)[^{]*)?\s*\{' % (EmptyScope.struct_str, EmptyScope.class_str, EmptyScope.enum_str), re.MULTILINE | re.DOTALL) + cb_obj_pattern = re.compile(r'chainbase::object$') + obj_pattern = re.compile(r'^object$') + using_pattern = re.compile(r'\n\s*?using\s+(\w+)\s*=\s*([\w:]+)(?:<.*>)?;') + + def __init__(self, name, inherit, start, content, parent_scope, is_enum): + debug("ClassStruct.__init__ %s %d" % (name, start)) + EmptyScope.__init__(self, name, start, content, parent_scope) + self.classes = {} + self.pattern = ClassStruct.class_pattern + self.is_enum = is_enum + self.inherit = None + if inherit is None: + self.ignore_id = False + else: + match = ClassStruct.cb_obj_pattern.search(inherit) + if match is None: + match = ClassStruct.obj_pattern.search(inherit) + + self.ignore_id = True if match else False + next = self.parent_scope + while self.inherit is None and next is not None: + self.inherit = next.find_class(inherit) + next = next.parent_scope + debug("Checking for object, ignore_id: %s, inherit: %s, name: %s" % (self.ignore_id, inherit, name)) + + def add(self, child): + debug("ClassStruct.add %s (%s) to %s (%s)" % (child.name, child.__class__.__name__, self.name, self.__class__.__name__)) + if isinstance(child, ClassStruct): + self.classes[child.name] = child + self.children[child.name] = child + self.children_ordered.append(child.name) + + def add_fields(self, start, end): + loc = start + while loc < end: + debug("ClassStruct.add_fields -{\n%s\n}" % (self.content[loc:end + 1])) + if self.is_enum: + loc = self.add_enum_field(loc, end) + else: + loc = self.add_field(loc, end) + debug("ClassStruct.add_fields done") + + def add_field(self, loc, end): + match = ClassStruct.field_pattern.search(self.content[loc:end + 1]) + if match is None: + return end + field = match.group(2) + self.fields.append(field) + all = match.group(0) + loc = self.content.find(all, loc) + len(all) + debug("ClassStruct.add_field - %s (%d) - %s" % (field, len(self.fields), ClassStruct.field_pattern.pattern)) + return loc + + def add_enum_field(self, loc, end): + match = ClassStruct.enum_field_pattern.search(self.content[loc:end + 1]) + if match is None: + return end + field = match.group(1) + self.fields.append(field) + all = match.group(0) + loc = self.content.find(all, loc) + len(all) + debug("ClassStruct.add_enum_field - %s (%d) - %s" % (field, len(self.fields), ClassStruct.enum_field_pattern.pattern)) + return loc + + def add_usings(self, start, end): + loc = start + while loc < end: + debug("ClassStruct.add_usings -{\n%s\n}" % (self.content[loc:end + 1])) + match = ClassStruct.using_pattern.search(self.content[loc:end]) + if match is None: + break + using = match.group(1) + class_struct = match.group(2) + self.usings[using] = class_struct + all = match.group(0) + loc = self.content.find(all, loc) + len(all) + debug("ClassStruct.add_usings - %s (%d)" % (using, len(self.usings))) + debug("ClassStruct.add_usings done") + + def next_scope(self, end = None): + new_scope = None + if end is None: + end = self.find_possible_end() + debug("ClassStruct.next_scope end=%s on %s\n\npossible scope={\n\"%s\"\n\n\npattern=%s" % (end, self.name, self.content[self.current:end], self.pattern.pattern)) + match = self.pattern.search(self.content[self.current:end]) + start = -1 + search_str = None + type = None + name = None + inherit = None + if match: + debug("ClassStruct.next_scope match on %s" % (self.name)) + search_str = match.group(0) + type = match.group(1) + name = match.group(2) + if len(match.groups()) >= 3: + inherit = match.group(4) + + start = self.find_scope_start(self.content, self.current, end, search_str) + debug("all: %s, type: %s, name: %s, start: %s, inherit: %s" % (search_str, type, name, start, inherit)) + + generic_scope_start = self.find_scope_start(self.content, self.current, end, EmptyScope.start_char) + if start == -1 and generic_scope_start == -1: + debug("ClassStruct.next_scope end=%s no scopes add_fields and exit" % (end)) + self.add_fields(self.current, end) + return None + + debug("found \"%s\" - \"%s\" - \"%s\" current=%s, start=%s, end=%s, pattern=%s " % (search_str, type, name, self.current, start, end, self.pattern.pattern)) + # determine if there is a non-namespace/non-class/non-struct scope before a namespace/class/struct scope + if start != -1 and (generic_scope_start == -1 or start <= generic_scope_start): + debug("found %s at %d" % (type, start)) + new_scope = create_scope(type, name, inherit, start, self.content, self) + else: + debug("found EmptyScope (%s) at %d, next scope at %s" % (type, generic_scope_start, start)) + new_scope = EmptyScope("", generic_scope_start, self.content, self) + + self.add_fields(self.current, new_scope.start) + self.add_usings(self.current, new_scope.start) + new_scope.read() + self.current = new_scope.end + 1 + + return new_scope + +class Namespace(ClassStruct): + namespace_class_pattern = re.compile(r'(%s|%s|%s|%s)\s+(\w+)\s*(:\s*public\s+([^<\s]+)[^{]*)?\s*\{' % (EmptyScope.namespace_str, EmptyScope.struct_str, EmptyScope.class_str, EmptyScope.enum_str), re.MULTILINE | re.DOTALL) + + def __init__(self, name, inherit, start, content, parent_scope): + debug("Namespace.__init__ %s %d" % (name, start)) + assert inherit is None, "namespace %s should not inherit from %s" % (name, inherit) + ClassStruct.__init__(self, name, None, start, content, parent_scope, is_enum = False) + self.namespaces = {} + self.pattern = Namespace.namespace_class_pattern + + def add(self, child): + debug("Namespace.add %s (%s) to %s (%s)" % (child.name, child.__class__.__name__, self.name, self.__class__.__name__)) + if isinstance(child, ClassStruct): + ClassStruct.add(self, child) + return + if isinstance(child, Namespace): + self.namespaces[child.name] = child + self.children[child.name] = child + self.children_ordered.append(child.name) + +class Reflection: + def __init__(self, name): + self.name = name + self.fields = [] + self.ignored = [] + self.swapped = [] + self.absent = [] + +class Reflections: + def __init__(self, content): + self.content = content + self.current = 0 + self.end = len(content) + self.classes = OrderedDict() + self.with_2_comments = re.compile(r'(//\s*(%s|%s)\s+([^/]*?)\s*\n\s*//\s*(%s|%s)\s+([^/]*?)\s*\n\s*(%s%s\s*\(\s*(\w[^\s<]*))(?:<[^>]*>)?\s*,)' % (ignore_str, swap_str, ignore_str, swap_str, fc_reflect_str, fc_reflect_possible_enum_ext), re.MULTILINE | re.DOTALL) + self.with_comment = re.compile(r'(//\s*(%s|%s)\s+([^/]*?)\s*\n\s*(%s%s\s*\(\s*(\w[^\s<]*))(?:<[^>]*>)?\s*,)' % (ignore_str, swap_str, fc_reflect_str, fc_reflect_possible_enum_ext), re.MULTILINE | re.DOTALL) + self.reflect_pattern = re.compile(r'(\b(%s%s\s*\(\s*(\w[^\s<]*)(?:<[^>]*>)?\s*,)\s*(\(.*?\))\s*\))[^\)]*%s%s\b' % (fc_reflect_str, fc_reflect_possible_enum_ext, fc_reflect_str, fc_reflect_possible_enum_ext), re.MULTILINE | re.DOTALL) + self.field_pattern = re.compile(r'\(([^\)]+)\)', re.MULTILINE | re.DOTALL) + self.ignore_swap_pattern = re.compile(r'\b([\w\d]+)\b', re.MULTILINE | re.DOTALL) + + def read(self): + while self.current < self.end: + match_2_comments = self.with_2_comments.search(self.content[self.current:]) + match_comment = self.with_comment.search(self.content[self.current:]) + match_reflect = self.reflect_pattern.search(self.content[self.current:]) + match_loc = None + if match_2_comments or match_comment: + loc1 = self.content.find(match_2_comments.group(1), self.current) if match_2_comments else self.end + loc2 = self.content.find(match_comment.group(1), self.current) if match_comment else self.end + debug("loc1=%s and loc2=%s" % (loc1, loc2)) + group1 = match_2_comments.group(1) if match_2_comments else "" + group2 = match_comment.group(1) if match_comment else "" + debug("\n ***** group1={\n%s\n}\n\n\n ***** group2={\n%s\n}\n\n\n" % (group1, group2)) + if loc2 < loc1: + debug("loc2 earlier") + match_2_comments = None + match_loc = loc2 + else: + match_loc = loc1 + if match_reflect and match_loc is not None: + debug("match_reflect and one of the other matches") + loc1 = self.content.find(match_reflect.group(1), self.current) + if loc1 < match_loc: + debug("choose the other matches") + match_comment = None + match_2_comments = None + else: + debug("choose comment") + pass + + if match_2_comments: + debug("match_2_comments") + debug("Groups {") + for g in match_2_comments.groups(): + debug(" %s" % g) + debug("}") + assert len(match_2_comments.groups()) == 7, "match_2_comments wrong size due to regex pattern change" + ignore_or_swap1 = match_2_comments[2] + next_reflect_ignore_swap1 = match_2_comments[3] + ignore_or_swap2 = match_2_comments[4] + next_reflect_ignore_swap2 = match_2_comments[5] + search_string_for_next_reflect_class = match_2_comments[6] + next_reflect_class = match_2_comments[7] + self.add_ignore_swaps(next_reflect_class, next_reflect_ignore_swap1, ignore_or_swap1) + self.add_ignore_swaps(next_reflect_class, next_reflect_ignore_swap2, ignore_or_swap2) + elif match_comment: + debug("match_comment") + debug("Groups {") + for g in match_comment.groups(): + debug(" %s" % g) + debug("}") + assert len(match_comment.groups()) == 5, "match_comment too short due to regex pattern change" + # not using array indices here because for some reason the type of match_2_comments and match_comment are different + ignore_or_swap = match_comment.group(2) + next_reflect_ignore_swap = match_comment.group(3) + search_string_for_next_reflect_class = match_comment.group(4) + next_reflect_class = match_comment.group(5) + self.add_ignore_swaps(next_reflect_class, next_reflect_ignore_swap, ignore_or_swap) + + if match_reflect: + debug("match_reflect") + debug("Groups {") + for g in match_reflect.groups(): + debug(" %s" % g) + debug("}") + assert len(match_reflect.groups()) == 4, "match_reflect too short due to regex pattern change" + next_reflect = match_reflect.group(2) + next_reflect_class = match_reflect.group(3) + next_reflect_fields = match_reflect.group(4) + self.add_fields(next_reflect, next_reflect_class, next_reflect_fields) + else: + debug("search for next reflect done") + self.current = self.end + break + + def find_or_add(self, reflect_class): + if reflect_class not in self.classes: + debug("find_or_add added \"%s\"" % (reflect_class)) + self.classes[reflect_class] = Reflection(reflect_class) + return self.classes[reflect_class] + + def add_fields(self, next_reflect, next_reflect_class, next_reflect_fields): + old = self.current + self.current = self.content.find(next_reflect, self.current) + len(next_reflect) + debug("all={\n\n%s\n\nclass=\n\n%s\n\nfields=\n\n%s\n\n" % (next_reflect, next_reflect_class, next_reflect_fields)) + fields = re.findall(self.field_pattern, next_reflect_fields) + for field in fields: + self.add_field(next_reflect_class, field) + reflect_class = self.find_or_add(next_reflect_class) + debug("add_fields %s done, fields count=%s, ignored count=%s, swapped count=%s" % (next_reflect_class, len(reflect_class.fields), len(reflect_class.ignored), len(reflect_class.swapped))) + + def add_ignore_swaps(self, next_reflect_class, next_reflect_ignores_swaps, ignore_or_swap): + debug("class=\n\n%s\n\n%s=\n\n%s\n\n" % (next_reflect_class, ignore_or_swap, next_reflect_ignores_swaps)) + end = len(next_reflect_ignores_swaps) + current = 0 + while current < end: + ignore_swap_match = self.ignore_swap_pattern.search(next_reflect_ignores_swaps[current:]) + if ignore_swap_match: + ignore_swap = ignore_swap_match.group(1) + reflect_class = self.find_or_add(next_reflect_class) + if (ignore_or_swap == ignore_str): + assert ignore_swap not in reflect_class.ignored, "Reflection for %s repeats %s \"%s\"" % (next_reflect_class, ignore_or_swap) + assert ignore_swap not in reflect_class.swapped, "Reflection for %s references field \"%s\" in %s and %s " % (next_reflect_class, ignore_swap, ignore_str, swap_str) + reflect_class.ignored.append(ignore_swap) + else: + assert ignore_swap not in reflect_class.swapped, "Reflection for %s repeats %s \"%s\"" % (next_reflect_class, ignore_or_swap) + assert ignore_swap not in reflect_class.ignored, "Reflection for %s references field \"%s\" in %s and %s " % (next_reflect_class, ignore_swap, swap_str, ignore_str) + reflect_class.swapped.append(ignore_swap) + debug("ignore or swap %s --> %s, ignored count=%s, swapped count=%s" % (next_reflect_class, ignore_swap, len(reflect_class.ignored), len(reflect_class.swapped))) + current = next_reflect_ignores_swaps.find(ignore_swap_match.group(0), current) + len(ignore_swap_match.group(0)) + else: + break + + + def add_field(self, reflect_class_name, field): + reflect_class = self.find_or_add(reflect_class_name) + assert field not in reflect_class.fields, "Reflection for %s repeats field \"%s\"" % (reflect_class_name, field) + reflect_class.fields.append(field) + debug("add_field %s --> %s" % (reflect_class_name, field)) + +def replace_multi_line_comment(match): + all=match.group(1) + all=EmptyScope.strip_extra_pattern.sub("", all) + debug("multiline found=%s" % (all)) + match=EmptyScope.ignore_swap_pattern.search(all) + if match: + ignore_or_swap = match.group(1) + all = match.group(2) + debug("multiline %s now=%s" % (ignore_or_swap, all)) + invalid_chars=EmptyScope.invalid_chars_pattern.search(all) + if invalid_chars: + for ic in invalid_chars.groups(): + debug("invalid_char=%s" % (ic)) + debug("WARNING: looks like \"%s\" is intending to %s, but there are invalid characters - \"%s\"" % (all, ignore_or_swap, ",".join(invalid_chars.groups()))) + return "" + groups=re.findall(EmptyScope.multi_line_comment_ignore_swap_pattern, all) + if groups is None: + return "" + rtn_str="// %s " % (ignore_or_swap) + rtn_str+=', '.join([group for group in groups if group is not None]) + debug("multiline rtn_str=%s" % (rtn_str)) + return rtn_str + + debug("multiline no match") + return "" + +def replace_line_comment(match): + all=match.group(0) + debug("singleline found=%s" % (all)) + if EmptyScope.single_comment_ignore_swap_pattern.match(all): + return all + else: + return "\n" + +def validate_file(file): + f = open(file, "r") + contents = "\n" + f.read() # lazy fix for complex regex + f.close() + contents = EmptyScope.multi_line_comment_pattern.sub(replace_multi_line_comment, contents) + contents = EmptyScope.single_comment_pattern.sub(replace_line_comment, contents) + found = re.search(fc_reflect_str, contents) + if found is None: + return + print("validate %s" % (file)) + debug("validate %s" % (file)) + global_namespace=Namespace("", None, 0, contents, None) + global_namespace.read() + if args.debug: + _, filename = os.path.split(file) + with open(os.path.join(temp_dir, filename + ".struct"), "w") as f: + f.write("global_namespace=%s" % (global_namespace)) + with open(os.path.join(temp_dir, filename + ".stripped"), "w") as f: + f.write(contents) + reflections=Reflections(contents) + reflections.read() + for reflection_name in reflections.classes: + reflection = reflections.classes[reflection_name] + class_struct = global_namespace.find_class(reflection_name) + if class_struct is None: + match=re.search(r'^(.+?)::id_type$', reflection_name) + if match: + parent_class_name = match.group(1) + parent_class = global_namespace.find_class(parent_class_name) + if parent_class.ignore_id: + # this is a chainbase::object, don't need to worry about id_type definition + continue + class_struct_num_fields = len(class_struct.fields) if class_struct is not None else None + debug("reflection_name=%s, class field count=%s, reflection field count=%s, ingore count=%s, swap count=%s" % (reflection_name, class_struct_num_fields, len(reflection.fields), len(reflection.ignored), len(reflection.swapped))) + assert isinstance(class_struct, ClassStruct), "could not find a %s/%s/%s for %s" % (EmptyScope.class_str, EmptyScope.struct_str, EmptyScope.enum_str, reflection_name) + if class_struct.ignore_id: + id_field = "id" + if id_field not in reflection.ignored and id_field not in reflection.fields: + debug("Object ignore_id Adding id to ignored for %s" % (reflection_name)) + reflection.ignored.append(id_field) + else: + debug("Object ignore_id NOT adding id to ignored for %s" % (reflection_name)) + rf_index = 0 + rf_len = len(reflection.fields) + + processed = [] + back_swapped = [] + fwd_swapped = [] + ignored = [] + f_index = 0 + f_len = len(class_struct.fields) + while f_index < f_len: + field = class_struct.fields[f_index] + reflect_field = reflection.fields[rf_index] if rf_index < rf_len else None + processed.append(field) + debug("\nfield=%s reflect_field=%s" % (field, reflect_field)) + if field in reflection.swapped: + debug("field \"%s\" swapped (back)" % (field)) + reflection.swapped.remove(field) + back_swapped.append(field) + assert field in reflection.fields, "Reflection for %s indicates swapping %s but swapped position is not indicated in the reflection fields. Should it be ignored?" % (reflection_name, field) + assert reflect_field != field, "Reflection for %s should not indicate swapping %s since it is in the correct order" % (reflection_name, field) + f_index += 1 + continue + if reflect_field in reflection.swapped: + debug("field \"%s\" swapped (fwd)" % (field)) + reflection.swapped.remove(reflect_field) + fwd_swapped.append(reflect_field) + assert reflect_field in reflection.fields, "Reflection for %s indicates swapping field %s but it doesn't exist in that class/struct so it should be removed" % (reflection_name, reflect_field) + rf_index += 1 + continue + assert reflect_field not in ignored, "Reflection for %s should not indicate %s for %s; it should indicate %s - %s" % (reflection_name, ignore_str, reflect_field, swap_str, ",".join(ignored)) + if field in reflection.ignored: + debug("ignoring: %s" % (field)) + reflection.ignored.remove(field) + ignored.append(field) + assert reflect_field != field, "Reflection for %s should not indicate ignoring %s since it is in the correct order" % (reflection_name, field) + f_index += 1 + continue + debug("ignored=%s, swapped=%s" % (",".join(reflection.ignored),",".join(reflection.swapped))) + if reflect_field is not None and reflect_field in back_swapped: + back_swapped.remove(reflect_field) + rf_index += 1 + elif field in fwd_swapped: + fwd_swapped.remove(field) + f_index += 1 + else: + assert reflect_field == field, "Reflection for %s should have field %s instead of %s or else it should indicate if the field should be ignored (%s) or swapped (%s)" %(reflection_name, field, reflect_field, ignore_str, swap_str) + f_index += 1 + rf_index += 1 + debug("rf_index=%s, rf_len=%s, f_index=%s, f_len=%s" % (rf_index, rf_len, f_index, f_len)) + + assert len(reflection.ignored) == 0, "Reflection for %s has erroneous ignores - \"%s\"" % (reflection_name, ",".join(reflection.ignored)) + unused_reflect_fields = [] + while rf_index < rf_len: + debug("rf_index=%s, rf_len=%s fields=%s" % (rf_index, rf_len, ",".join(reflection.fields))) + reflect_field = reflection.fields[rf_index] + if reflect_field in back_swapped: + back_swapped.remove(reflect_field) + else: + unused_reflect_fields.append(reflect_field) + rf_index += 1 + assert len(unused_reflect_fields) == 0, "Reflection for %s has fields not in definition for class/struct - \"%s\"" % (reflection_name, ",".join(unused_reflect_fields)) + assert len(reflection.swapped) == 0, "Reflection for %s has erroneous swaps - \"%s\"" % (reflection_name, ",".join(reflection.swapped)) + assert len(back_swapped) == 0, "Reflection for %s indicated swapped fields that were never provided - \"%s\"" % (reflection_name, ",".join(back_swapped)) + assert len(fwd_swapped) == 0, "Reflection for %s indicated and provided swapped fields that are not in the class - \"%s\"" % (reflection_name, ",".join(fwd_swapped)) + + print("%s passed" % (file)) + +success = True + +def walk(current_dir): + result = True + print("Searching for files: %s" % (current_dir)) + for root, dirs, filenames in os.walk(current_dir): + for filename in filenames: + _, extension = os.path.splitext(filename) + if extension not in extensions: + continue + try: + validate_file(os.path.join(root, filename)) + except AssertionError: + _, info, tb = sys.exc_info() + traceback.print_tb(tb) # Fixed format + tb_info = traceback.extract_tb(tb) + filename, line, func, text = tb_info[-1] + + print("An error occurred in %s:%s: %s" % (filename, line, info), file=sys.stderr) + if args.exit_on_error: + exit(1) + result = False + + if not recurse: + break + return result + +for file in args.files: + if os.path.isdir(file): + success &= walk(file) + elif os.path.isfile(file): + try: + validate_file(file) + except AssertionError: + _, info, tb = sys.exc_info() + traceback.print_tb(tb) # Fixed format + tb_info = traceback.extract_tb(tb) + filename, line, func, text = tb_info[-1] + + print("An error occurred in %s:%s: %s" % (filename, line, info), file=sys.stderr) + if args.exit_on_error: + exit(1) + success = False + else: + print("ERROR \"%s\" is neither a directory nor a file" % file) + success = False + +if success: + exit(0) +else: + exit(1) diff --git a/tutorials/bios-boot-tutorial/README.md b/tutorials/bios-boot-tutorial/README.md index bebba5f4a04..ea353898086 100644 --- a/tutorials/bios-boot-tutorial/README.md +++ b/tutorials/bios-boot-tutorial/README.md @@ -2,12 +2,43 @@ The `bios-boot-tutorial.py` script simulates the EOSIO bios boot sequence. -The script can be run with no arguments directly from the `tutorials/bios-boot-tutorial` directory. +``Prerequisites``: + +1. Python 3.x +2. CMake +3. git + +``Steps``: + +1. Install eosio binaries by following the steps outlined in below tutorial +[Install eosio binaries](https://github.com/EOSIO/eos#mac-os-x-brew-install) + +2. Install eosio.cdt binaries by following the steps outlined in below tutorial +[Install eosio.cdt binaries](https://github.com/EOSIO/eosio.cdt#binary-releases) + +3. Compile eosio.contracts + +```bash +$ cd ~ +$ git clone https://github.com/EOSIO/eosio.contracts.git +$ cd ./eosio.contracts/ +$ ./build.sh +$ pwd + +``` + +4. Make note of the directory where the contracts were compiled +The last command in the previous step printed on the bash console the contracts' directory, make note of it, we'll reference it from now on as `EOSIO_CONTRACTS_DIRECTORY` + +5. Launch the `bios-boot-tutorial.py` script +Minimal command line to launch the script below, make sure you replace `EOSIO_CONTRACTS_DIRECTORY` with actual directory ```bash -$ cd tutorials/bios-boot-tutorial +$ cd ~ +$ git clone https://github.com/EOSIO/eos.git +$ cd ./eos/tutorials/bios-boot-tutorial/ +$ python3 bios-boot-tutorial.py --cleos="cleos --wallet-url http://127.0.0.1:6666 " --nodeos=nodeos --keosd=keosd --contracts-dir="/EOSIO_CONTRACTS_DIRECTORY/" -a -$ ./bios-boot-tutorial.py ``` -See [EOSIO Documentation Wiki: Tutorial - Bios Boot](https://github.com/EOSIO/eos/wiki/Tutorial-Bios-Boot-Sequence) for additional information. +See [EOSIO Documentation Wiki: Tutorial - Bios Boot](https://github.com/EOSIO/eos/wiki/Tutorial-Bios-Boot-Sequence) for additional information. \ No newline at end of file diff --git a/tutorials/bios-boot-tutorial/bios-boot-tutorial.py b/tutorials/bios-boot-tutorial/bios-boot-tutorial.py index 59a1590d4d6..358d3b963b8 100755 --- a/tutorials/bios-boot-tutorial/bios-boot-tutorial.py +++ b/tutorials/bios-boot-tutorial/bios-boot-tutorial.py @@ -284,17 +284,20 @@ def stepStartBoot(): startNode(0, {'name': 'eosio', 'pvt': args.private_key, 'pub': args.public_key}) sleep(1.5) def stepInstallSystemContracts(): - run(args.cleos + 'set contract eosio.token ' + args.contracts_dir + 'eosio.token/') - run(args.cleos + 'set contract eosio.msig ' + args.contracts_dir + 'eosio.msig/') + run(args.cleos + 'set contract eosio.token ' + args.contracts_dir + '/eosio.token/') + run(args.cleos + 'set contract eosio.msig ' + args.contracts_dir + '/eosio.msig/') def stepCreateTokens(): run(args.cleos + 'push action eosio.token create \'["eosio", "10000000000.0000 %s"]\' -p eosio.token' % (args.symbol)) totalAllocation = allocateFunds(0, len(accounts)) run(args.cleos + 'push action eosio.token issue \'["eosio", "%s", "memo"]\' -p eosio' % intToCurrency(totalAllocation)) sleep(1) def stepSetSystemContract(): - retry(args.cleos + 'set contract eosio ' + args.contracts_dir + 'eosio.system/') + retry(args.cleos + 'set contract eosio ' + args.contracts_dir + '/eosio.system/') sleep(1) run(args.cleos + 'push action eosio setpriv' + jsonArg(['eosio.msig', 1]) + '-p eosio@active') +def stepInitSystemContract(): + run(args.cleos + 'push action eosio init' + jsonArg(['0', '4,SYS']) + '-p eosio@active') + sleep(1) def stepCreateStakedAccounts(): createStakedAccounts(0, len(accounts)) def stepRegProducers(): @@ -326,23 +329,24 @@ def stepLog(): parser = argparse.ArgumentParser() commands = [ - ('k', 'kill', stepKillAll, True, "Kill all nodeos and keosd processes"), - ('w', 'wallet', stepStartWallet, True, "Start keosd, create wallet, fill with keys"), - ('b', 'boot', stepStartBoot, True, "Start boot node"), - ('s', 'sys', createSystemAccounts, True, "Create system accounts (eosio.*)"), - ('c', 'contracts', stepInstallSystemContracts, True, "Install system contracts (token, msig)"), - ('t', 'tokens', stepCreateTokens, True, "Create tokens"), - ('S', 'sys-contract', stepSetSystemContract, True, "Set system contract"), - ('T', 'stake', stepCreateStakedAccounts, True, "Create staked accounts"), - ('p', 'reg-prod', stepRegProducers, True, "Register producers"), - ('P', 'start-prod', stepStartProducers, True, "Start producers"), - ('v', 'vote', stepVote, True, "Vote for producers"), - ('R', 'claim', claimRewards, True, "Claim rewards"), - ('x', 'proxy', stepProxyVotes, True, "Proxy votes"), - ('q', 'resign', stepResign, True, "Resign eosio"), - ('m', 'msg-replace', msigReplaceSystem, False, "Replace system contract using msig"), - ('X', 'xfer', stepTransfer, False, "Random transfer tokens (infinite loop)"), - ('l', 'log', stepLog, True, "Show tail of node's log"), + ('k', 'kill', stepKillAll, True, "Kill all nodeos and keosd processes"), + ('w', 'wallet', stepStartWallet, True, "Start keosd, create wallet, fill with keys"), + ('b', 'boot', stepStartBoot, True, "Start boot node"), + ('s', 'sys', createSystemAccounts, True, "Create system accounts (eosio.*)"), + ('c', 'contracts', stepInstallSystemContracts, True, "Install system contracts (token, msig)"), + ('t', 'tokens', stepCreateTokens, True, "Create tokens"), + ('S', 'sys-contract', stepSetSystemContract, True, "Set system contract"), + ('I', 'init-sys-contract', stepInitSystemContract, True, "Initialiaze system contract"), + ('T', 'stake', stepCreateStakedAccounts, True, "Create staked accounts"), + ('p', 'reg-prod', stepRegProducers, True, "Register producers"), + ('P', 'start-prod', stepStartProducers, True, "Start producers"), + ('v', 'vote', stepVote, True, "Vote for producers"), + ('R', 'claim', claimRewards, True, "Claim rewards"), + ('x', 'proxy', stepProxyVotes, True, "Proxy votes"), + ('q', 'resign', stepResign, True, "Resign eosio"), + ('m', 'msg-replace', msigReplaceSystem, False, "Replace system contract using msig"), + ('X', 'xfer', stepTransfer, False, "Random transfer tokens (infinite loop)"), + ('l', 'log', stepLog, True, "Show tail of node's log"), ] parser.add_argument('--public-key', metavar='', help="EOSIO Public Key", default='EOS8Znrtgwt8TfpmbVpTKvA2oB8Nqey625CLN8bCN3TEbgx86Dsvr', dest="public_key") diff --git a/unittests/abi_tests.cpp b/unittests/abi_tests.cpp index 3ffcc5af263..f611fe768ce 100644 --- a/unittests/abi_tests.cpp +++ b/unittests/abi_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -1475,7 +1475,7 @@ public_key_type get_public_key( name keyname, string role ) { BOOST_AUTO_TEST_CASE(packed_transaction) { try { - chain::transaction txn; + chain::signed_transaction txn; txn.ref_block_num = 1; txn.ref_block_prefix = 2; txn.expiration.from_iso_string("2021-12-20T15:30"); diff --git a/unittests/api_tests.cpp b/unittests/api_tests.cpp index e889790ba33..955130130fa 100644 --- a/unittests/api_tests.cpp +++ b/unittests/api_tests.cpp @@ -1,6 +1,6 @@ /** * @file api_tests.cpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -149,7 +149,8 @@ transaction_trace_ptr CallAction(TESTER& test, T ac, const vector& test.set_transaction_headers(trx); auto sigs = trx.sign(test.get_private_key(scope[0], "active"), test.control->get_chain_id()); - trx.get_signature_keys(test.control->get_chain_id()); + flat_set keys; + trx.get_signature_keys(test.control->get_chain_id(), fc::time_point::maximum(), keys); auto res = test.push_transaction(trx); BOOST_CHECK_EQUAL(res->receipt->status, transaction_receipt::executed); test.produce_block(); @@ -173,7 +174,8 @@ transaction_trace_ptr CallFunction(TESTER& test, T ac, const vector& data, test.set_transaction_headers(trx, test.DEFAULT_EXPIRATION_DELTA); auto sigs = trx.sign(test.get_private_key(scope[0], "active"), test.control->get_chain_id()); - trx.get_signature_keys(test.control->get_chain_id() ); + flat_set keys; + trx.get_signature_keys(test.control->get_chain_id(), fc::time_point::maximum(), keys); auto res = test.push_transaction(trx); BOOST_CHECK_EQUAL(res->receipt->status, transaction_receipt::executed); test.produce_block(); @@ -266,7 +268,8 @@ BOOST_FIXTURE_TEST_CASE(action_receipt_tests, TESTER) { try { trx.actions.push_back(act); this->set_transaction_headers(trx, this->DEFAULT_EXPIRATION_DELTA); trx.sign(this->get_private_key(config::system_account_name, "active"), control->get_chain_id()); - trx.get_signature_keys(control->get_chain_id() ); + flat_set keys; + trx.get_signature_keys(control->get_chain_id(), fc::time_point::maximum(), keys); auto res = this->push_transaction(trx); BOOST_CHECK_EQUAL(res->receipt->status, transaction_receipt::executed); this->produce_block(); @@ -745,7 +748,8 @@ void call_test(TESTER& test, T ac, uint32_t billed_cpu_time_us , uint32_t max_cp test.set_transaction_headers(trx); //trx.max_cpu_usage_ms = max_cpu_usage_ms; auto sigs = trx.sign(test.get_private_key(N(testapi), "active"), test.control->get_chain_id()); - trx.get_signature_keys(test.control->get_chain_id() ); + flat_set keys; + trx.get_signature_keys(test.control->get_chain_id(), fc::time_point::maximum(), keys); auto res = test.push_transaction( trx, fc::time_point::now() + fc::milliseconds(max_cpu_usage_ms), billed_cpu_time_us ); BOOST_CHECK_EQUAL(res->receipt->status, transaction_receipt::executed); test.produce_block(); @@ -1085,7 +1089,7 @@ BOOST_FIXTURE_TEST_CASE(deferred_transaction_tests, TESTER) { try { produce_blocks( 3 ); //check that only one deferred transaction executed - auto dtrxs = control->get_scheduled_transactions(); + auto dtrxs = get_scheduled_transactions(); BOOST_CHECK_EQUAL(dtrxs.size(), 1); for (const auto& trx: dtrxs) { control->push_scheduled_transaction(trx, fc::time_point::maximum()); @@ -1110,7 +1114,7 @@ BOOST_FIXTURE_TEST_CASE(deferred_transaction_tests, TESTER) { try { produce_blocks( 3 ); //check that only one deferred transaction executed - auto dtrxs = control->get_scheduled_transactions(); + auto dtrxs = get_scheduled_transactions(); BOOST_CHECK_EQUAL(dtrxs.size(), 1); for (const auto& trx: dtrxs) { control->push_scheduled_transaction(trx, fc::time_point::maximum()); @@ -1728,14 +1732,23 @@ BOOST_FIXTURE_TEST_CASE(print_tests, TESTER) { try { BOOST_CHECK_EQUAL( tx9_act_cnsl.substr(start, end-start), "6.666666666666666e-07" ); // test printqf +#ifdef __x86_64__ + std::string expect1 = "5.000000000000000000e-01"; + std::string expect2 = "-3.750000000000000000e+00"; + std::string expect3 = "6.666666666666666667e-07"; +#else + std::string expect1 = "5.000000000000000e-01"; + std::string expect2 = "-3.750000000000000e+00"; + std::string expect3 = "6.666666666666667e-07"; +#endif auto tx10_trace = CALL_TEST_FUNCTION( *this, "test_print", "test_printqf", {} ); auto tx10_act_cnsl = tx10_trace->action_traces.front().console; start = 0; end = tx10_act_cnsl.find('\n', start); - BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), "5.000000000000000000e-01" ); + BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), expect1 ); start = end + 1; end = tx10_act_cnsl.find('\n', start); - BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), "-3.750000000000000000e+00" ); + BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), expect2 ); start = end + 1; end = tx10_act_cnsl.find('\n', start); - BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), "6.666666666666666667e-07" ); + BOOST_CHECK_EQUAL( tx10_act_cnsl.substr(start, end-start), expect3 ); BOOST_REQUIRE_EQUAL( validate(), true ); } FC_LOG_AND_RETHROW() } diff --git a/unittests/block_tests.cpp b/unittests/block_tests.cpp index 10a10dc2060..045255da6d9 100644 --- a/unittests/block_tests.cpp +++ b/unittests/block_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include @@ -21,7 +21,7 @@ BOOST_AUTO_TEST_CASE(block_with_invalid_tx_test) auto b = main.produce_block(); // Make a copy of the valid block and corrupt the transaction - auto copy_b = std::make_shared(*b); + auto copy_b = std::make_shared(std::move(*b)); auto signed_tx = copy_b->transactions.back().trx.get().get_signed_transaction(); auto& act = signed_tx.actions.back(); auto act_data = act.data_as(); @@ -57,14 +57,15 @@ std::pair corrupt_trx_in_block(validating_te signed_block_ptr b = main.produce_block_no_validation(); // Make a copy of the valid block and corrupt the transaction - auto copy_b = std::make_shared(*b); - auto signed_tx = copy_b->transactions.back().trx.get().get_signed_transaction(); + auto copy_b = std::make_shared(b->clone()); + const auto& packed_trx = copy_b->transactions.back().trx.get(); + auto signed_tx = packed_trx.get_signed_transaction(); // Corrupt one signature signed_tx.signatures.clear(); signed_tx.sign(main.get_private_key(act_name, "active"), main.control->get_chain_id()); // Replace the valid transaction with the invalid transaction - auto invalid_packed_tx = packed_transaction(signed_tx); + auto invalid_packed_tx = packed_transaction(signed_tx, packed_trx.get_compression()); copy_b->transactions.back().trx = invalid_packed_tx; // Re-calculate the transaction merkle diff --git a/unittests/block_timestamp_tests.cpp b/unittests/block_timestamp_tests.cpp index 297789c9089..5cf998a85aa 100644 --- a/unittests/block_timestamp_tests.cpp +++ b/unittests/block_timestamp_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/unittests/contracts/deferred_test/deferred_test.cpp b/unittests/contracts/deferred_test/deferred_test.cpp index 95fc4316c8b..a30a7a2550e 100644 --- a/unittests/contracts/deferred_test/deferred_test.cpp +++ b/unittests/contracts/deferred_test/deferred_test.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/unittests/database_tests.cpp b/unittests/database_tests.cpp index 8f9d3553928..7cb35e85be5 100644 --- a/unittests/database_tests.cpp +++ b/unittests/database_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include @@ -28,8 +28,7 @@ BOOST_AUTO_TEST_SUITE(database_tests) TESTER test; // Bypass read-only restriction on state DB access for this unit test which really needs to mutate the DB to properly conduct its test. - // eosio::chain::database& db = const_cast( test.control->db() ); - chainbase::database &db = const_cast(test.control->db()); + eosio::chain::database& db = const_cast( test.control->db() ); auto ses = db.start_undo_session(true); diff --git a/unittests/delay_tests.cpp b/unittests/delay_tests.cpp index 9f14de4107c..ae1a3d114b5 100644 --- a/unittests/delay_tests.cpp +++ b/unittests/delay_tests.cpp @@ -72,7 +72,7 @@ BOOST_FIXTURE_TEST_CASE( delay_error_create_account, validating_tester) { try { produce_blocks(6); - auto scheduled_trxs = control->get_scheduled_transactions(); + auto scheduled_trxs = get_scheduled_transactions(); BOOST_REQUIRE_EQUAL(scheduled_trxs.size(), 1); auto dtrace = control->push_scheduled_transaction(scheduled_trxs.front(), fc::time_point::maximum()); BOOST_REQUIRE_EQUAL(dtrace->except.valid(), true); diff --git a/unittests/eosio_system_tester.hpp b/unittests/eosio_system_tester.hpp index 345ab49c436..194d52330ea 100644 --- a/unittests/eosio_system_tester.hpp +++ b/unittests/eosio_system_tester.hpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma once diff --git a/unittests/forked_tests.cpp b/unittests/forked_tests.cpp index d4c8e4d3bd4..9543a791174 100644 --- a/unittests/forked_tests.cpp +++ b/unittests/forked_tests.cpp @@ -88,7 +88,7 @@ BOOST_AUTO_TEST_CASE( fork_with_bad_block ) try { auto& fork = forks.at(j); if (j <= i) { - auto copy_b = std::make_shared(*b); + auto copy_b = std::make_shared(b->clone()); if (j == i) { // corrupt this block fork.block_merkle = remote.control->head_block_state()->blockroot_merkle; @@ -277,9 +277,9 @@ BOOST_AUTO_TEST_CASE( forking ) try { } wlog( "end push c2 blocks to c1" ); wlog( "now push dan's block to c1 but first corrupt it so it is a bad block" ); - auto bad_block = *b; + signed_block bad_block = std::move(*b); bad_block.transaction_mroot = bad_block.previous; - auto bad_block_bs = c.control->create_block_state_future( std::make_shared(bad_block) ); + auto bad_block_bs = c.control->create_block_state_future( std::make_shared(std::move(bad_block)) ); c.control->abort_block(); BOOST_REQUIRE_EXCEPTION(c.control->push_block( bad_block_bs ), fc::exception, [] (const fc::exception &ex)->bool { diff --git a/unittests/include/config.hpp.in b/unittests/include/config.hpp.in index cd6dd6435e8..8483e4dd73c 100644 --- a/unittests/include/config.hpp.in +++ b/unittests/include/config.hpp.in @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ namespace eosio { namespace unittests { namespace config { diff --git a/unittests/main.cpp b/unittests/main.cpp index ad2b5846210..0644ce80545 100644 --- a/unittests/main.cpp +++ b/unittests/main.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include diff --git a/unittests/message_buffer_tests.cpp b/unittests/message_buffer_tests.cpp index a0b6529f2c6..ccb69033e8e 100644 --- a/unittests/message_buffer_tests.cpp +++ b/unittests/message_buffer_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/unittests/misc_tests.cpp b/unittests/misc_tests.cpp index 1a93b66e97a..563c1922e9e 100644 --- a/unittests/misc_tests.cpp +++ b/unittests/misc_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include @@ -590,11 +590,9 @@ BOOST_AUTO_TEST_CASE(transaction_test) { try { BOOST_CHECK_EQUAL(1, trx.signatures.size()); trx.validate(); - packed_transaction pkt; - pkt.set_transaction(trx, packed_transaction::none); + packed_transaction pkt(trx, packed_transaction::none); - packed_transaction pkt2; - pkt2.set_transaction(trx, packed_transaction::zlib); + packed_transaction pkt2(trx, packed_transaction::zlib); BOOST_CHECK_EQUAL(true, trx.expiration == pkt.expiration()); BOOST_CHECK_EQUAL(true, trx.expiration == pkt2.expiration()); diff --git a/unittests/producer_schedule_tests.cpp b/unittests/producer_schedule_tests.cpp index 9ca0edecf82..a7279499656 100644 --- a/unittests/producer_schedule_tests.cpp +++ b/unittests/producer_schedule_tests.cpp @@ -260,4 +260,136 @@ BOOST_FIXTURE_TEST_CASE( producer_schedule_promotion_test, TESTER ) try { BOOST_REQUIRE_EQUAL( validate(), true ); } FC_LOG_AND_RETHROW() +BOOST_FIXTURE_TEST_CASE( producer_schedule_reduction, tester ) try { + create_accounts( {N(alice),N(bob),N(carol)} ); + produce_block(); + + auto compare_schedules = [&]( const vector& a, const producer_schedule_type& b ) { + return std::equal( a.begin(), a.end(), b.producers.begin(), b.producers.end() ); + }; + + auto res = set_producers( {N(alice),N(bob),N(carol)} ); + vector sch1 = { + {N(alice), get_public_key(N(alice), "active")}, + {N(bob), get_public_key(N(bob), "active")}, + {N(carol), get_public_key(N(carol), "active")} + }; + wlog("set producer schedule to [alice,bob,carol]"); + BOOST_REQUIRE_EQUAL( true, control->proposed_producers().valid() ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, *control->proposed_producers() ) ); + BOOST_CHECK_EQUAL( control->pending_producers().version, 0 ); + produce_block(); // Starts new block which promotes the proposed schedule to pending + BOOST_CHECK_EQUAL( control->pending_producers().version, 1 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, control->pending_producers() ) ); + BOOST_CHECK_EQUAL( control->active_producers().version, 0 ); + produce_block(); + produce_block(); // Starts new block which promotes the pending schedule to active + BOOST_CHECK_EQUAL( control->active_producers().version, 1 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, control->active_producers() ) ); + produce_blocks(7); + + res = set_producers( {N(alice),N(bob)} ); + vector sch2 = { + {N(alice), get_public_key(N(alice), "active")}, + {N(bob), get_public_key(N(bob), "active")} + }; + wlog("set producer schedule to [alice,bob]"); + BOOST_REQUIRE_EQUAL( true, control->proposed_producers().valid() ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch2, *control->proposed_producers() ) ); + + produce_blocks(48); + BOOST_REQUIRE_EQUAL( control->head_block_producer(), N(bob) ); + BOOST_REQUIRE_EQUAL( control->pending_block_state()->header.producer, N(carol) ); + BOOST_CHECK_EQUAL( control->pending_producers().version, 2 ); + + produce_blocks(47); + BOOST_CHECK_EQUAL( control->active_producers().version, 1 ); + produce_blocks(1); + + BOOST_REQUIRE_EQUAL( control->head_block_producer(), N(carol) ); + BOOST_REQUIRE_EQUAL( control->pending_block_state()->header.producer, N(alice) ); + BOOST_CHECK_EQUAL( control->active_producers().version, 2 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch2, control->active_producers() ) ); + + produce_blocks(2); + BOOST_CHECK_EQUAL( control->head_block_producer(), N(bob) ); + + BOOST_REQUIRE_EQUAL( validate(), true ); +} FC_LOG_AND_RETHROW() + +BOOST_FIXTURE_TEST_CASE( empty_producer_schedule_has_no_effect, tester ) try { + create_accounts( {N(alice),N(bob),N(carol)} ); + produce_block(); + + auto compare_schedules = [&]( const vector& a, const producer_schedule_type& b ) { + return std::equal( a.begin(), a.end(), b.producers.begin(), b.producers.end() ); + }; + + auto res = set_producers( {N(alice),N(bob)} ); + vector sch1 = { + {N(alice), get_public_key(N(alice), "active")}, + {N(bob), get_public_key(N(bob), "active")} + }; + wlog("set producer schedule to [alice,bob]"); + BOOST_REQUIRE_EQUAL( true, control->proposed_producers().valid() ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, *control->proposed_producers() ) ); + BOOST_CHECK_EQUAL( control->pending_producers().producers.size(), 0 ); + + // Start a new block which promotes the proposed schedule to pending + produce_block(); + BOOST_CHECK_EQUAL( control->pending_producers().version, 1 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, control->pending_producers() ) ); + BOOST_CHECK_EQUAL( control->active_producers().version, 0 ); + + // Start a new block which promotes the pending schedule to active + produce_block(); + BOOST_CHECK_EQUAL( control->active_producers().version, 1 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch1, control->active_producers() ) ); + produce_blocks(7); + + res = set_producers( {} ); + wlog("set producer schedule to []"); + BOOST_REQUIRE_EQUAL( true, control->proposed_producers().valid() ); + BOOST_CHECK_EQUAL( control->proposed_producers()->producers.size(), 0 ); + BOOST_CHECK_EQUAL( control->proposed_producers()->version, 2 ); + + produce_blocks(12); + BOOST_CHECK_EQUAL( control->pending_producers().version, 1 ); + + // Empty producer schedule does get promoted from proposed to pending + produce_block(); + BOOST_CHECK_EQUAL( control->pending_producers().version, 2 ); + BOOST_CHECK_EQUAL( false, control->proposed_producers().valid() ); + + // However it should not get promoted from pending to active + produce_blocks(24); + BOOST_CHECK_EQUAL( control->active_producers().version, 1 ); + BOOST_CHECK_EQUAL( control->pending_producers().version, 2 ); + + // Setting a new producer schedule should still use version 2 + res = set_producers( {N(alice),N(bob),N(carol)} ); + vector sch2 = { + {N(alice), get_public_key(N(alice), "active")}, + {N(bob), get_public_key(N(bob), "active")}, + {N(carol), get_public_key(N(carol), "active")} + }; + wlog("set producer schedule to [alice,bob,carol]"); + BOOST_REQUIRE_EQUAL( true, control->proposed_producers().valid() ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch2, *control->proposed_producers() ) ); + BOOST_CHECK_EQUAL( control->proposed_producers()->version, 2 ); + + // Produce enough blocks to promote the proposed schedule to pending, which it can do because the existing pending has zero producers + produce_blocks(24); + BOOST_CHECK_EQUAL( control->active_producers().version, 1 ); + BOOST_CHECK_EQUAL( control->pending_producers().version, 2 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch2, control->pending_producers() ) ); + + // Produce enough blocks to promote the pending schedule to active + produce_blocks(24); + BOOST_CHECK_EQUAL( control->active_producers().version, 2 ); + BOOST_CHECK_EQUAL( true, compare_schedules( sch2, control->active_producers() ) ); + + BOOST_REQUIRE_EQUAL( validate(), true ); +} FC_LOG_AND_RETHROW() + BOOST_AUTO_TEST_SUITE_END() diff --git a/unittests/ram_tests.cpp b/unittests/ram_tests.cpp index 976e5b8cefe..6fe0eec6613 100644 --- a/unittests/ram_tests.cpp +++ b/unittests/ram_tests.cpp @@ -1,6 +1,6 @@ /** * @file api_tests.cpp - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wsign-compare" diff --git a/unittests/snapshot_tests.cpp b/unittests/snapshot_tests.cpp index e5207ca7bb8..1534a49b5dc 100644 --- a/unittests/snapshot_tests.cpp +++ b/unittests/snapshot_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include diff --git a/unittests/special_accounts_tests.cpp b/unittests/special_accounts_tests.cpp index 384b8e78ace..e3ad16fa9bc 100644 --- a/unittests/special_accounts_tests.cpp +++ b/unittests/special_accounts_tests.cpp @@ -1,6 +1,6 @@ /** * @file - * @copyright defined in eos/LICENSE.txt + * @copyright defined in eos/LICENSE */ #include #include