sysio::chain::transaction Struct Reference

#include <transaction.hpp>

Inheritance diagram for sysio::chain::transaction:

Collaboration diagram for sysio::chain::transaction:

Public Member Functions
transaction_id_type	id () const
digest_type	sig_digest (const chain_id_type &chain_id, const vector< bytes > &cfd=vector< bytes >()) const
fc::microseconds	get_signature_keys (const vector< signature_type > &signatures, const chain_id_type &chain_id, fc::time_point deadline, const vector< bytes > &cfd, flat_set< public_key_type > &recovered_pub_keys, bool allow_duplicate_keys=false) const
uint32_t	total_actions () const
account_name	first_authorizer () const
flat_multimap< uint16_t, transaction_extension >	validate_and_extract_extensions () const
Public Member Functions inherited from sysio::chain::transaction_header
block_num_type	get_ref_blocknum (block_num_type head_blocknum) const
	number of seconds to delay this transaction for during which it may be canceled.
void	set_reference_block (const block_id_type &reference_block)
bool	verify_reference_block (const block_id_type &reference_block) const
void	validate () const

Public Attributes
vector< action >	context_free_actions
vector< action >	actions
extensions_type	transaction_extensions
Public Attributes inherited from sysio::chain::transaction_header
time_point_sec	expiration
	the time at which a transaction expires
uint16_t	ref_block_num = 0U
	specifies a block num in the last 2^16 blocks.
uint32_t	ref_block_prefix = 0UL
	specifies the lower 32 bits of the blockid at get_ref_blocknum
fc::unsigned_int	max_net_usage_words = 0UL
uint8_t	max_cpu_usage_ms = 0
	upper limit on total network bandwidth (in 8 byte words) billed for this transaction
fc::unsigned_int	delay_sec = 0UL
	upper limit on the total CPU time billed for this transaction

Detailed Description

A transaction consits of a set of messages which must all be applied or all are rejected. These messages have access to data within the given read and write scopes.

Definition at line 83 of file transaction.hpp.

Member Function Documentation

first_authorizer()

account_name sysio::chain::transaction::first_authorizer ( ) const

inline

Definition at line 99 of file transaction.hpp.

                                           {
         for( const auto& a : actions ) {
            for( const auto& u : a.authorization )
               return u.actor;
         }
         return account_name();
      }

get_signature_keys()

fc::microseconds sysio::chain::transaction::get_signature_keys	(	const vector< signature_type > &	signatures,
		const chain_id_type &	chain_id,
		fc::time_point	deadline,
		const vector< bytes > &	cfd,
		flat_set< public_key_type > &	recovered_pub_keys,
		bool	allow_duplicate_keys = false ) const

Definition at line 59 of file transaction.cpp.

{ try {
   auto start = fc::time_point::now();
   recovered_pub_keys.clear();
   const digest_type digest = sig_digest(chain_id, cfd);
 
   for(const signature_type& sig : signatures) {
      auto now = fc::time_point::now();
      SYS_ASSERT( now < deadline, tx_cpu_usage_exceeded, "transaction signature verification executed for too long ${time}us",
                  ("time", now - start)("now", now)("deadline", deadline)("start", start) );
      auto[ itr, successful_insertion ] = recovered_pub_keys.emplace( sig, digest );
      SYS_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", *itr ) );
   }
 
   return fc::time_point::now() - start;
} FC_CAPTURE_AND_RETHROW() }

Here is the call graph for this function:

Here is the caller graph for this function:

id()

transaction_id_type sysio::chain::transaction::id

(

)

const

Definition at line 41 of file transaction.cpp.

                                          {
   digest_type::encoder enc;
   fc::raw::pack( enc, *this );
   return enc.result();
}

Here is the call graph for this function:

Here is the caller graph for this function:

sig_digest()

digest_type sysio::chain::transaction::sig_digest	(	const chain_id_type &	chain_id,
		const vector< bytes > &	cfd = vector<bytes>() ) const

Definition at line 47 of file transaction.cpp.

                                                                                                  {
   digest_type::encoder enc;
   fc::raw::pack( enc, chain_id );
   fc::raw::pack( enc, *this );
   if( cfd.size() ) {
      fc::raw::pack( enc, digest_type::hash(cfd) );
   } else {
      fc::raw::pack( enc, digest_type() );
   }
   return enc.result();
}

Here is the call graph for this function:

Here is the caller graph for this function:

total_actions()

uint32_t sysio::chain::transaction::total_actions ( ) const

inline

Definition at line 97 of file transaction.hpp.

{ return context_free_actions.size() + actions.size(); }

validate_and_extract_extensions()

flat_multimap< uint16_t, transaction_extension > sysio::chain::transaction::validate_and_extract_extensions

(

)

const

Definition at line 80 of file transaction.cpp.

                                                                                                 {
   using decompose_t = transaction_extension_types::decompose_t;
 
   flat_multimap<uint16_t, transaction_extension> results;
 
   uint16_t id_type_lower_bound = 0;
 
   for( size_t i = 0; i < transaction_extensions.size(); ++i ) {
      const auto& e = transaction_extensions[i];
      auto id = e.first;
 
      SYS_ASSERT( id >= id_type_lower_bound, invalid_transaction_extension,
                  "Transaction extensions are not in the correct order (ascending id types required)"
      );
 
      auto iter = results.emplace(std::piecewise_construct,
         std::forward_as_tuple(id),
         std::forward_as_tuple()
      );
 
      auto match = decompose_t::extract<transaction_extension>( id, e.second, iter->second );
      SYS_ASSERT( match, invalid_transaction_extension,
                  "Transaction extension with id type ${id} is not supported",
                  ("id", id)
      );
 
      if( match->enforce_unique ) {
         SYS_ASSERT( i == 0 || id > id_type_lower_bound, invalid_transaction_extension,
                     "Transaction extension with id type ${id} is not allowed to repeat",
                     ("id", id)
         );
      }
 
      id_type_lower_bound = id;
   }
 
   return results;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

actions

vector<action> sysio::chain::transaction::actions

Definition at line 85 of file transaction.hpp.

context_free_actions

vector<action> sysio::chain::transaction::context_free_actions

Definition at line 84 of file transaction.hpp.

transaction_extensions

extensions_type sysio::chain::transaction::transaction_extensions

Definition at line 86 of file transaction.hpp.

---

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

• libraries/chain/include/sysio/chain/transaction.hpp
• libraries/chain/transaction.cpp