mirror of
https://github.com/kaspanet/kaspad.git
synced 2025-03-30 15:08:33 +00:00
3ace16ad23
* [DEV-134] Implement Continuous Integration Squashed commit: [5e41d830] Dev 223 fix txindex (#100) * [DEV-201] In handleGetBlockDAGInfo calculate difficulty by the tip with the lowest bits * [DEV-202] Move VirtualBlock.GetUTXOEntry to BlockDAG * [DEV-203] Move VirtualBlock.SelectedTip() to BlockDAG * [DEV-203] Move VirtualBlock.SelectedTip() to BlockDAG * [DEV-204] Unexport VirtualBlock() and add CalcMedianTime method for DAG * [DEV-204] add explanation about difficulty in CurrentBits() comment * [DEV-204] unexport VirtualBlock type * [DEV-223] make applyUTXOChanges return pastUTXOResults * [DEV-223] add bluestxdata for current block as well * [DEV-223] re-design tx index * [DEV-223] edit txindex comments * [DEV-223] rename BluesTxData -> AcceptedTxData, and return from applyUTXOChanges only transactions that got accepted * [DEV-223] add unit test for txindex * [DEV-223] fix comments and unite blueTransaction and AcceptedTxData to one type * [DEV-223] use bucket cursor for dbFetchFirstTxRegion * [DEV-223] use the same cursor instance for dbFetchFirstTxRegion * [DEV-223] write in dbFetchFirstTxRegion's comment that it returns the first block region * [DEV-223] rename type BlueBlockTransaction to TxWithBlockHash * [DEV-223] add named returned value for applyUTXOChanges [4c95e293] [DEV-134] Made golint ignore the vendor directory. [21736dbc] [DEV-134] Renamed ExampleBlockChain_ProcessBlock to ExampleBlockDAG_ProcessBlock to satisfy go vet. [beea6486] [DEV-134] Removed pushing the built docker to a remove repository. That's unnecessary at this stage. [bee911ed] [DEV-134] Made all precompilation checks run on everything instead of only the root dir. [585f92ae] [DEV-134] Added "github.com/pkg/errors" to dep. [5f02f570] [DEV-134] -vendor-only is written with only one hyphen. [3eee7f95] [DEV-134] go vet instead of go tool vet. [0c2d4343] [DEV-134] Split all the pre-compile checks to separate lines to be able to tell which of them is failing. [780519c8] [DEV-134] Ran gofmt on everything. [8247146b] Dev 223 fix txindex (#100) * [DEV-201] In handleGetBlockDAGInfo calculate difficulty by the tip with the lowest bits * [DEV-202] Move VirtualBlock.GetUTXOEntry to BlockDAG * [DEV-203] Move VirtualBlock.SelectedTip() to BlockDAG * [DEV-203] Move VirtualBlock.SelectedTip() to BlockDAG * [DEV-204] Unexport VirtualBlock() and add CalcMedianTime method for DAG * [DEV-204] add explanation about difficulty in CurrentBits() comment * [DEV-204] unexport VirtualBlock type * [DEV-223] make applyUTXOChanges return pastUTXOResults * [DEV-223] add bluestxdata for current block as well * [DEV-223] re-design tx index * [DEV-223] edit txindex comments * [DEV-223] rename BluesTxData -> AcceptedTxData, and return from applyUTXOChanges only transactions that got accepted * [DEV-223] add unit test for txindex * [DEV-223] fix comments and unite blueTransaction and AcceptedTxData to one type * [DEV-223] use bucket cursor for dbFetchFirstTxRegion * [DEV-223] use the same cursor instance for dbFetchFirstTxRegion * [DEV-223] write in dbFetchFirstTxRegion's comment that it returns the first block region * [DEV-223] rename type BlueBlockTransaction to TxWithBlockHash * [DEV-223] add named returned value for applyUTXOChanges [bff68aa3] [DEV-134] Gave executable permission to deploy.sh [638a99d9] [DEV-134] Added jenkinsfile and deploy script. * [DEV-134] Added a robust testing script. * [DEV-134] Fixed a bash-ism. * [DEV-134] Disabled testing with coverage for now. * [DEV-134] Disabled golint and removed removing debug symbols. * [DEV-134] Disabled aligncheck. * [DEV-134] Disabled structcheck and varcheck. * [DEV-134] Added "don't inline functions" to compiler flags for testing. * [DEV-134] Made build fail if gofmt prints out anything. * [DEV-134] Fixed misleading comment. * [DEV-134] Added comments to test.sh. * [DEV-134] Renamed tm to measure_runtime and removed do_ prefixes from functions. * [DEV-134] Fixed gofmt line in build script. * [DEV-134] Fixed gofmt some more. * [DEV-134] Fixed gofmt not actually failing due to logical or.
82 lines
4.1 KiB
Go
82 lines
4.1 KiB
Go
// Copyright (c) 2016 The btcsuite developers
|
|
// Use of this source code is governed by an ISC
|
|
// license that can be found in the LICENSE file.
|
|
|
|
/*
|
|
Package mempool provides a policy-enforced pool of unmined bitcoin transactions.
|
|
|
|
A key responsbility of the bitcoin network is mining user-generated transactions
|
|
into blocks. In order to facilitate this, the mining process relies on having a
|
|
readily-available source of transactions to include in a block that is being
|
|
solved.
|
|
|
|
At a high level, this package satisfies that requirement by providing an
|
|
in-memory pool of fully validated transactions that can also optionally be
|
|
further filtered based upon a configurable policy.
|
|
|
|
One of the policy configuration options controls whether or not "standard"
|
|
transactions are accepted. In essence, a "standard" transaction is one that
|
|
satisfies a fairly strict set of requirements that are largely intended to help
|
|
provide fair use of the system to all users. It is important to note that what
|
|
is considered a "standard" transaction changes over time. For some insight, at
|
|
the time of this writing, an example of SOME of the criteria that are required
|
|
for a transaction to be considered standard are that it is of the most-recently
|
|
supported version, finalized, does not exceed a specific size, and only consists
|
|
of specific script forms.
|
|
|
|
Since this package does not deal with other bitcoin specifics such as network
|
|
communication and transaction relay, it returns a list of transactions that were
|
|
accepted which gives the caller a high level of flexibility in how they want to
|
|
proceed. Typically, this will involve things such as relaying the transactions
|
|
to other peers on the network and notifying the mining process that new
|
|
transactions are available.
|
|
|
|
Feature Overview
|
|
|
|
The following is a quick overview of the major features. It is not intended to
|
|
be an exhaustive list.
|
|
|
|
- Maintain a pool of fully validated transactions
|
|
- Reject non-fully-spent duplicate transactions
|
|
- Reject coinbase transactions
|
|
- Reject double spends (both from the chain and other transactions in pool)
|
|
- Reject invalid transactions according to the network consensus rules
|
|
- Full script execution and validation with signature cache support
|
|
- Individual transaction query support
|
|
- Orphan transaction support (transactions that spend from unknown outputs)
|
|
- Configurable limits (see transaction acceptance policy)
|
|
- Automatic addition of orphan transactions that are no longer orphans as new
|
|
transactions are added to the pool
|
|
- Individual orphan transaction query support
|
|
- Configurable transaction acceptance policy
|
|
- Option to accept or reject standard transactions
|
|
- Option to accept or reject transactions based on priority calculations
|
|
- Rate limiting of low-fee and free transactions
|
|
- Non-zero fee threshold
|
|
- Max signature operations per transaction
|
|
- Max orphan transaction size
|
|
- Max number of orphan transactions allowed
|
|
- Additional metadata tracking for each transaction
|
|
- Timestamp when the transaction was added to the pool
|
|
- Most recent block height when the transaction was added to the pool
|
|
- The fee the transaction pays
|
|
- The starting priority for the transaction
|
|
- Manual control of transaction removal
|
|
- Recursive removal of all dependent transactions
|
|
|
|
Errors
|
|
|
|
Errors returned by this package are either the raw errors provided by underlying
|
|
calls or of type mempool.RuleError. Since there are two classes of rules
|
|
(mempool acceptance rules and blockchain (consensus) acceptance rules), the
|
|
mempool.RuleError type contains a single Err field which will, in turn, either
|
|
be a mempool.TxRuleError or a blockchain.RuleError. The first indicates a
|
|
violation of mempool acceptance rules while the latter indicates a violation of
|
|
consensus acceptance rules. This allows the caller to easily differentiate
|
|
between unexpected errors, such as database errors, versus errors due to rule
|
|
violations through type assertions. In addition, callers can programmatically
|
|
determine the specific rule violation by type asserting the Err field to one of
|
|
the aforementioned types and examining their underlying ErrorCode field.
|
|
*/
|
|
package mempool
|