Documentation ¶
Index ¶
- type ConfigDestinationMe
- type ConfigSourceMe
- type CrossTxCache
- func (cache *CrossTxCache) AddTx(tx *WrappedTransaction) (has, added bool)
- func (cache *CrossTxCache) ForEachTransaction(function ForEachTransaction)
- func (cache *CrossTxCache) Get(key []byte) (value interface{}, ok bool)
- func (cache *CrossTxCache) GetByTxHash(txHash []byte) (*WrappedTransaction, bool)
- func (cache *CrossTxCache) ImmunizeTxsAgainstEviction(keys [][]byte)
- func (cache *CrossTxCache) IsInterfaceNil() bool
- func (cache *CrossTxCache) Peek(key []byte) (value interface{}, ok bool)
- func (cache *CrossTxCache) RemoveTxByHash(txHash []byte) bool
- type DisabledCache
- func (cache *DisabledCache) AddTx(_ *WrappedTransaction) (ok bool, added bool)
- func (cache *DisabledCache) Clear()
- func (cache *DisabledCache) Diagnose(_ bool)
- func (cache *DisabledCache) ForEachTransaction(_ ForEachTransaction)
- func (cache *DisabledCache) Get(_ []byte) (value interface{}, ok bool)
- func (cache *DisabledCache) GetByTxHash(_ []byte) (*WrappedTransaction, bool)
- func (cache *DisabledCache) Has(_ []byte) bool
- func (cache *DisabledCache) HasOrAdd(_ []byte, _ interface{}, _ int) (has, added bool)
- func (cache *DisabledCache) ImmunizeTxsAgainstEviction(_ [][]byte)
- func (cache *DisabledCache) IsInterfaceNil() bool
- func (cache *DisabledCache) Keys() [][]byte
- func (cache *DisabledCache) Len() int
- func (cache *DisabledCache) MaxSize() int
- func (cache *DisabledCache) NotifyAccountNonce(_ []byte, _ uint64)
- func (cache *DisabledCache) NumBytes() int
- func (cache *DisabledCache) Peek(_ []byte) (value interface{}, ok bool)
- func (cache *DisabledCache) Put(_ []byte, _ interface{}, _ int) (evicted bool)
- func (cache *DisabledCache) RegisterHandler(func(key []byte, value interface{}), string)
- func (cache *DisabledCache) Remove(_ []byte)
- func (cache *DisabledCache) RemoveTxByHash(_ []byte) bool
- func (cache *DisabledCache) SelectTransactions(_ int, _ int) []*WrappedTransaction
- func (cache *DisabledCache) SizeInBytesContained() uint64
- func (cache *DisabledCache) UnRegisterHandler(string)
- type ForEachTransaction
- type TxCache
- func (cache *TxCache) AddTx(tx *WrappedTransaction) (ok bool, added bool)
- func (cache *TxCache) Clear()
- func (cache *TxCache) CountSenders() uint64
- func (cache *TxCache) CountTx() uint64
- func (cache *TxCache) Diagnose(deep bool)
- func (cache *TxCache) ForEachTransaction(function ForEachTransaction)
- func (cache *TxCache) Get(key []byte) (value interface{}, ok bool)
- func (cache *TxCache) GetByTxHash(txHash []byte) (*WrappedTransaction, bool)
- func (cache *TxCache) Has(key []byte) bool
- func (cache *TxCache) HasOrAdd(_ []byte, _ interface{}, _ int) (has, added bool)
- func (cache *TxCache) ImmunizeTxsAgainstEviction(_ [][]byte)
- func (cache *TxCache) IsInterfaceNil() bool
- func (cache *TxCache) Keys() [][]byte
- func (cache *TxCache) Len() int
- func (cache *TxCache) MaxSize() int
- func (cache *TxCache) NotifyAccountNonce(accountKey []byte, nonce uint64)
- func (cache *TxCache) NumBytes() int
- func (cache *TxCache) Peek(key []byte) (value interface{}, ok bool)
- func (cache *TxCache) Put(_ []byte, _ interface{}, _ int) (evicted bool)
- func (cache *TxCache) RegisterHandler(func(key []byte, value interface{}), string)
- func (cache *TxCache) Remove(key []byte)
- func (cache *TxCache) RemoveTxByHash(txHash []byte) bool
- func (cache *TxCache) SelectTransactions(numRequested int, batchSizePerSender int) []*WrappedTransaction
- func (cache *TxCache) SizeInBytesContained() uint64
- func (cache *TxCache) UnRegisterHandler(string)
- type TxGasHandler
- type WrappedTransaction
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ConfigDestinationMe ¶
type ConfigDestinationMe struct { Name string NumChunks uint32 MaxNumItems uint32 MaxNumBytes uint32 NumItemsToPreemptivelyEvict uint32 }
ConfigDestinationMe holds cache configuration
func (*ConfigDestinationMe) String ¶
func (config *ConfigDestinationMe) String() string
String returns a readable representation of the object
type ConfigSourceMe ¶
type ConfigSourceMe struct { Name string NumChunks uint32 EvictionEnabled bool NumBytesThreshold uint32 NumBytesPerSenderThreshold uint32 CountThreshold uint32 CountPerSenderThreshold uint32 NumSendersToPreemptivelyEvict uint32 }
ConfigSourceMe holds cache configuration
func (*ConfigSourceMe) String ¶
func (config *ConfigSourceMe) String() string
String returns a readable representation of the object
type CrossTxCache ¶
type CrossTxCache struct { *immunitycache.ImmunityCache // contains filtered or unexported fields }
CrossTxCache holds cross-shard transactions (where destination == me)
func NewCrossTxCache ¶
func NewCrossTxCache(config ConfigDestinationMe) (*CrossTxCache, error)
NewCrossTxCache creates a new transactions cache
func (*CrossTxCache) AddTx ¶
func (cache *CrossTxCache) AddTx(tx *WrappedTransaction) (has, added bool)
AddTx adds a transaction in the cache
func (*CrossTxCache) ForEachTransaction ¶
func (cache *CrossTxCache) ForEachTransaction(function ForEachTransaction)
ForEachTransaction iterates over the transactions in the cache
func (*CrossTxCache) Get ¶
func (cache *CrossTxCache) Get(key []byte) (value interface{}, ok bool)
Get returns the unwrapped payload of a TransactionWrapper Implemented for compatibiltiy reasons (see txPoolsCleaner.go).
func (*CrossTxCache) GetByTxHash ¶
func (cache *CrossTxCache) GetByTxHash(txHash []byte) (*WrappedTransaction, bool)
GetByTxHash gets the transaction by hash
func (*CrossTxCache) ImmunizeTxsAgainstEviction ¶
func (cache *CrossTxCache) ImmunizeTxsAgainstEviction(keys [][]byte)
ImmunizeTxsAgainstEviction marks items as non-evictable
func (*CrossTxCache) IsInterfaceNil ¶
func (cache *CrossTxCache) IsInterfaceNil() bool
IsInterfaceNil returns true if there is no value under the interface
func (*CrossTxCache) Peek ¶
func (cache *CrossTxCache) Peek(key []byte) (value interface{}, ok bool)
Peek returns the unwrapped payload of a TransactionWrapper Implemented for compatibiltiy reasons (see transactions.go, common.go).
func (*CrossTxCache) RemoveTxByHash ¶
func (cache *CrossTxCache) RemoveTxByHash(txHash []byte) bool
RemoveTxByHash removes tx by hash
type DisabledCache ¶
type DisabledCache struct { }
DisabledCache represents a disabled cache
func NewDisabledCache ¶
func NewDisabledCache() *DisabledCache
NewDisabledCache creates a new disabled cache
func (*DisabledCache) AddTx ¶
func (cache *DisabledCache) AddTx(_ *WrappedTransaction) (ok bool, added bool)
AddTx does nothing
func (*DisabledCache) ForEachTransaction ¶
func (cache *DisabledCache) ForEachTransaction(_ ForEachTransaction)
ForEachTransaction does nothing
func (*DisabledCache) Get ¶
func (cache *DisabledCache) Get(_ []byte) (value interface{}, ok bool)
Get returns no transaction
func (*DisabledCache) GetByTxHash ¶
func (cache *DisabledCache) GetByTxHash(_ []byte) (*WrappedTransaction, bool)
GetByTxHash returns no transaction
func (*DisabledCache) HasOrAdd ¶
func (cache *DisabledCache) HasOrAdd(_ []byte, _ interface{}, _ int) (has, added bool)
HasOrAdd returns false, does nothing
func (*DisabledCache) ImmunizeTxsAgainstEviction ¶
func (cache *DisabledCache) ImmunizeTxsAgainstEviction(_ [][]byte)
ImmunizeTxsAgainstEviction does nothing
func (*DisabledCache) IsInterfaceNil ¶
func (cache *DisabledCache) IsInterfaceNil() bool
IsInterfaceNil returns true if there is no value under the interface
func (*DisabledCache) Keys ¶
func (cache *DisabledCache) Keys() [][]byte
Keys returns an empty slice
func (*DisabledCache) NotifyAccountNonce ¶
func (cache *DisabledCache) NotifyAccountNonce(_ []byte, _ uint64)
NotifyAccountNonce does nothing
func (*DisabledCache) Peek ¶
func (cache *DisabledCache) Peek(_ []byte) (value interface{}, ok bool)
Peek returns no transaction
func (*DisabledCache) Put ¶
func (cache *DisabledCache) Put(_ []byte, _ interface{}, _ int) (evicted bool)
Put does nothing
func (*DisabledCache) RegisterHandler ¶
func (cache *DisabledCache) RegisterHandler(func(key []byte, value interface{}), string)
RegisterHandler does nothing
func (*DisabledCache) RemoveTxByHash ¶
func (cache *DisabledCache) RemoveTxByHash(_ []byte) bool
RemoveTxByHash does nothing
func (*DisabledCache) SelectTransactions ¶
func (cache *DisabledCache) SelectTransactions(_ int, _ int) []*WrappedTransaction
SelectTransactions returns an empty slice
func (*DisabledCache) SizeInBytesContained ¶
func (cache *DisabledCache) SizeInBytesContained() uint64
SizeInBytesContained returns 0
func (*DisabledCache) UnRegisterHandler ¶
func (cache *DisabledCache) UnRegisterHandler(string)
UnRegisterHandler does nothing
type ForEachTransaction ¶
type ForEachTransaction func(txHash []byte, value *WrappedTransaction)
ForEachTransaction is an iterator callback
type TxCache ¶
type TxCache struct {
// contains filtered or unexported fields
}
TxCache represents a cache-like structure (it has a fixed capacity and implements an eviction mechanism) for holding transactions
func NewTxCache ¶
func NewTxCache(config ConfigSourceMe, txGasHandler TxGasHandler) (*TxCache, error)
NewTxCache creates a new transaction cache
func (*TxCache) AddTx ¶
func (cache *TxCache) AddTx(tx *WrappedTransaction) (ok bool, added bool)
AddTx adds a transaction in the cache Eviction happens if maximum capacity is reached
func (*TxCache) CountSenders ¶
CountSenders gets the number of senders in the cache
func (*TxCache) Diagnose ¶
Diagnose checks the state of the cache for inconsistencies and displays a summary
func (*TxCache) ForEachTransaction ¶
func (cache *TxCache) ForEachTransaction(function ForEachTransaction)
ForEachTransaction iterates over the transactions in the cache
func (*TxCache) Get ¶
Get gets a transaction (unwrapped) by hash Implemented for compatibiltiy reasons (see txPoolsCleaner.go).
func (*TxCache) GetByTxHash ¶
func (cache *TxCache) GetByTxHash(txHash []byte) (*WrappedTransaction, bool)
GetByTxHash gets the transaction by hash
func (*TxCache) ImmunizeTxsAgainstEviction ¶
ImmunizeTxsAgainstEviction does nothing for this type of cache
func (*TxCache) IsInterfaceNil ¶
IsInterfaceNil returns true if there is no value under the interface
func (*TxCache) NotifyAccountNonce ¶
NotifyAccountNonce should be called by external components (such as interceptors and transactions processor) in order to inform the cache about initial nonce gap phenomena
func (*TxCache) Peek ¶
Peek gets a transaction (unwrapped) by hash Implemented for compatibility reasons (see transactions.go, common.go).
func (*TxCache) RegisterHandler ¶
RegisterHandler is not implemented
func (*TxCache) RemoveTxByHash ¶
RemoveTxByHash removes tx by hash
func (*TxCache) SelectTransactions ¶
func (cache *TxCache) SelectTransactions(numRequested int, batchSizePerSender int) []*WrappedTransaction
SelectTransactions selects a reasonably fair list of transactions to be included in the next miniblock It returns at most "numRequested" transactions Each sender gets the chance to give at least "batchSizePerSender" transactions, unless "numRequested" limit is reached before iterating over all senders
func (*TxCache) SizeInBytesContained ¶
SizeInBytesContained returns 0
func (*TxCache) UnRegisterHandler ¶
UnRegisterHandler is not implemented
type TxGasHandler ¶
type TxGasHandler interface { SplitTxGasInCategories(tx process.TransactionWithFeeHandler) (uint64, uint64) GasPriceForProcessing(tx process.TransactionWithFeeHandler) uint64 GasPriceForMove(tx process.TransactionWithFeeHandler) uint64 MinGasPrice() uint64 MinGasLimit() uint64 MinGasPriceForProcessing() uint64 IsInterfaceNil() bool }
TxGasHandler handles a transaction gas and gas cost
type WrappedTransaction ¶
type WrappedTransaction struct { Tx data.TransactionHandler TxHash []byte SenderShardID uint32 ReceiverShardID uint32 Size int64 TxFeeScoreNormalized uint64 }
WrappedTransaction contains a transaction, its hash and extra information