Changeset View
Changeset View
Standalone View
Standalone View
doc/0.21.12/rpc/rawtransactions/testmempoolaccept.md
- This file was added.
--- | |||||
name: testmempoolaccept | |||||
version: 0.21.12 | |||||
group: rawtransactions | |||||
permalink: doc/0.21.12/rpc/rawtransactions/testmempoolaccept/ | |||||
--- | |||||
testmempoolaccept ["rawtx",...] ( maxfeerate ) | |||||
Returns if raw transaction (serialized, hex-encoded) would be accepted by mempool. | |||||
This checks if the transaction violates the consensus or policy rules. | |||||
See sendrawtransaction call. | |||||
Arguments: | |||||
1. rawtxs (json array, required) An array of hex strings of raw transactions. | |||||
Length must be one for now. | |||||
[ | |||||
"rawtx", (string) | |||||
... | |||||
] | |||||
2. maxfeerate (numeric or string, optional, default=0.10) Reject transactions whose fee rate is higher than the specified value, expressed in BCH/kB | |||||
Result: | |||||
[ (array) The result of the mempool acceptance test for each raw transaction in the input array. | |||||
Length is exactly one for now. | |||||
{ | |||||
"txid" (string) The transaction hash in hex | |||||
"allowed" (boolean) If the mempool allows this tx to be inserted | |||||
"reject-reason" (string) Rejection string (only present when 'allowed' is false) | |||||
} | |||||
] | |||||
Examples: | |||||
Create a transaction | |||||
> bitcoin-cli createrawtransaction "[{\"txid\" : \"mytxid\",\"vout\":0}]" "{\"myaddress\":0.01}" | |||||
Sign the transaction, and get back the hex | |||||
> bitcoin-cli signrawtransactionwithwallet "myhex" | |||||
Test acceptance of the transaction (signed hex) | |||||
> bitcoin-cli testmempoolaccept ["signedhex"] | |||||
As a JSON-RPC call | |||||
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "testmempoolaccept", "params": [["signedhex"]] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/ | |||||