Dump format - Revision history

Harding: Added Bitcoin Core documentation navbox

2015-08-17T16:01:47Z

Added Bitcoin Core documentation navbox

← Older revision		Revision as of 16:01, 17 August 2015
Line 84:		Line 84:

	[[Category:Technical]]		[[Category:Technical]]
			{{Bitcoin Core documentation}}

Theymos at 21:29, 19 September 2011

2011-09-19T21:29:30Z

← Older revision		Revision as of 21:29, 19 September 2011
Line 7:		Line 7:
	vMerkleTree: 4a5e1e</pre>		vMerkleTree: 4a5e1e</pre>

	The indentation shows ~~"ownership"~~. In the above example, the CTxIn and CTxOut structures are part of the CTransaction structure, which is part of the CBlock structure. Data stored in the structure is displayed in parenthesis.		The indentation shows membership. In the above example, the CTxIn and CTxOut structures are part of the CTransaction structure, which is part of the CBlock structure. Data stored in the structure is displayed in parenthesis.

	All of the names used are names of the associated variables/classes in Bitcoin, though the values of the variables may not be exactly as shown. In particular, long data is sometimes shortened and converted to hex.		All of the names used are names of the associated variables/classes in Bitcoin, though the values of the variables may not be exactly as shown. In particular, long data is sometimes shortened and converted to hex.
Line 16:		Line 16:

	==Types==		==Types==
			===General note about hashes===
			Output from hash functions are usually thought of as big-endian byte strings. So the traditional way of of displaying the SHA-256 hash of 0x00 would be:
			6e340b9cffb37a989ca544e6bb780a2c78901d3fb33738768511a30617afa01d

			Since Bitcoin uses hashes as big numbers and performs calculations with them, however, the standard way of displaying Bitcoin-related hashes is as little-endian numbers. The same hash as above in Bitcoin format:
			1da0af1706a31185763837b33f1d90782c0a78bbe644a59c987ab3ff9c0b346e

			Bitcoin also does two hashes for every hash operation. So the real Bitcoin hash of 0x00 would be:
			9a538906e6466ebd2617d321f71bc94e56056ce213d366773699e28158e00614
	===COutPoint===		===COutPoint===
	COutPoint(000000, -1)		COutPoint(000000, -1)

Genjix: moved Bitcoin dump format to Dump format: What is it with prepending 'Bitcoin' to everything!!!! STOP!

2011-01-19T20:57:47Z

moved Bitcoin dump format to Dump format: What is it with prepending 'Bitcoin' to everything!!!! STOP!

← Older revision	Revision as of 20:57, 19 January 2011
(No difference)

Dooglus: /* CBlock */ capitalisation

2011-01-19T07:23:56Z

CBlock: capitalisation

← Older revision		Revision as of 07:23, 19 January 2011
Line 36:		Line 36:
	A transaction. hash is the truncated hash. ver is the transaction version. vout.size is the number of outputs. nLockTime is intended for use with transaction replacement, and is not currently used for anything useful.		A transaction. hash is the truncated hash. ver is the transaction version. vout.size is the number of outputs. nLockTime is intended for use with transaction replacement, and is not currently used for anything useful.
	===CBlock===		===CBlock===
	A block. Hash is the truncated hash. Version is the block version. HashPrevBlock is the truncated hash of the previous block. HashMerkleRoot is the truncated Merkle root. nTime is the ~~unix~~ timestamp of the block. nBits is the current target in compact format. nNonce is the nonce. vtx is the number of transactions.		A block. Hash is the truncated hash. Version is the block version. HashPrevBlock is the truncated hash of the previous block. HashMerkleRoot is the truncated Merkle root. nTime is the Unix timestamp of the block. nBits is the current target in compact format. nNonce is the nonce. vtx is the number of transactions.

	vMerkleTree is a list of hashes in the Merkle tree. You can see how the tree is constructed by looking at the ordering. The bottom tier is listed first, then the next-higher tier, etc. For example, consider this block:		vMerkleTree is a list of hashes in the Merkle tree. You can see how the tree is constructed by looking at the ordering. The bottom tier is listed first, then the next-higher tier, etc. For example, consider this block:

Theymos at 01:00, 5 January 2011

2011-01-05T01:00:48Z

← Older revision		Revision as of 01:00, 5 January 2011
Line 12:		Line 12:

	It is important to understand this format because it is used extensively in Bitcoin, and, due to its compactness, it is the preferred format when discussing Bitcoin blocks/transactions.		It is important to understand this format because it is used extensively in Bitcoin, and, due to its compactness, it is the preferred format when discussing Bitcoin blocks/transactions.

			The Bitcoin -printblock switch produces CBlock dumps.

	==Types==		==Types==
Line 71:		Line 73:
	\| \| \| \| \| \|		\| \| \| \| \| \|
	2d7f4d 3407a8 5edf5a 65c356 89aa32 e3e69c		2d7f4d 3407a8 5edf5a 65c356 89aa32 e3e69c

			[[Category:Technical]]

Theymos: Just did the block/transaction ones for now. Might be useful to do some of the other dump formats.

2011-01-04T16:11:44Z

Just did the block/transaction ones for now. Might be useful to do some of the other dump formats.

New page

Bitcoin dumps various data structures using a format like this:

<pre>CBlock(hash=000000000019d6, ver=1, hashPrevBlock=00000000000000, hashMerkleRoot=4a5e1e, nTime=1231006505, nBits=1d00ffff, nNonce=2083236893, vtx=1)
CTransaction(hash=4a5e1e, ver=1, vin.size=1, vout.size=1, nLockTime=0)
CTxIn(COutPoint(000000, -1), coinbase 04ffff001d010)
CTxOut(nValue=50.00000000, scriptPubKey=0x5F1DF16B2B704C8A578D0B)
vMerkleTree: 4a5e1e</pre>

The indentation shows "ownership". In the above example, the CTxIn and CTxOut structures are part of the CTransaction structure, which is part of the CBlock structure. Data stored in the structure is displayed in parenthesis.

All of the names used are names of the associated variables/classes in Bitcoin, though the values of the variables may not be exactly as shown. In particular, long data is sometimes shortened and converted to hex.

It is important to understand this format because it is used extensively in Bitcoin, and, due to its compactness, it is the preferred format when discussing Bitcoin blocks/transactions.

==Types==
===COutPoint===
COutPoint(000000, -1)
Part of a CTxIn structure, this references a specific output. The first value is the truncated hash of the transaction, and the second value is an output index.
===CTxIn===
CTxIn(COutPoint(237fe8, 0), scriptSig=0xA87C02384E1F184B79C6AC)
CTxIn(COutPoint(000000, -1), coinbase 04ffff001d010)
CTxIn(COutPoint(237fe8, 0), scriptSig=0xA87C02384E1F184B79C6AC, nSequence=5000)
A transaction input. scriptSig is the truncated scriptSig of the input. "coinbase" is the non-truncated scriptSig of a generation input. nSequence appears only if the input has a non-default sequence. Sequence numbers are intended for use with the transaction replacement feature, but can currently be safely ignored.
===CScript===
OP_DUP OP_HASH160 c28af0f6a8d2c5601e0fd1c3c19bcd74c107e8c7 OP_EQUALVERIFY OP_CHECKSIG
The abstract script consists of a series of words separated by spaces, evaluated from left to right. The mnemonic for each opcode is given. Constants are shown in hex without any of the required OP_PUSHDATA operations.
===CTxOut===
CTxOut(nValue=50.00000000, scriptPubKey=OP_DUP OP_HASH160 0x1512)
A transaction output. nValue is the the full-precision output value. scriptPubKey is the truncated CScript for the output (the entire script string is truncated to 30 characters).
===CTransaction===
<pre>CTransaction(hash=4a5e1e, ver=1, vin.size=1, vout.size=1, nLockTime=0)
CTxIn(COutPoint(000000, -1), coinbase 04ffff001d010)
CTxOut(nValue=50.00000000, scriptPubKey=0x5F1DF16B2B704C8A578D0B)</pre>
A transaction. hash is the truncated hash. ver is the transaction version. vout.size is the number of outputs. nLockTime is intended for use with transaction replacement, and is not currently used for anything useful.
===CBlock===
A block. Hash is the truncated hash. Version is the block version. HashPrevBlock is the truncated hash of the previous block. HashMerkleRoot is the truncated Merkle root. nTime is the unix timestamp of the block. nBits is the current target in compact format. nNonce is the nonce. vtx is the number of transactions.

vMerkleTree is a list of hashes in the Merkle tree. You can see how the tree is constructed by looking at the ordering. The bottom tier is listed first, then the next-higher tier, etc. For example, consider this block:
<pre>CBlock(hash=00000000009ffdadbb2a, ver=1, hashPrevBlock=0000000000b079382c19, hashMerkleRoot=e81287,
nTime=1281156783, nBits=1c00ba18, nNonce=2283211008, vtx=6)
CTransaction(hash=2d7f4d, ver=1, vin.size=1, vout.size=1, nLockTime=0)
CTxIn(COutPoint(000000, -1), coinbase 0418ba001c02ce03)
CTxOut(nValue=50.00000000, scriptPubKey=0x4FE11D72F988AEA611F026)
CTransaction(hash=3407a8, ver=1, vin.size=2, vout.size=1, nLockTime=0)
CTxIn(COutPoint(df39bf, 0), scriptSig=0x01DD1AD8E9EFE65B70E983)
CTxIn(COutPoint(64ebea, 1), scriptSig=0x0165A1F9873BA16265D9C4)
CTxOut(nValue=0.06000000, scriptPubKey=OP_DUP OP_HASH160 0xEDEF)
CTransaction(hash=5edf5a, ver=1, vin.size=1, vout.size=1, nLockTime=0)
CTxIn(COutPoint(b77e0f, 0), scriptSig=0x01E39C53AFC1B9BE02E53A)
CTxOut(nValue=350.00000000, scriptPubKey=OP_DUP OP_HASH160 0xD7EF)
CTransaction(hash=65c356, ver=1, vin.size=1, vout.size=2, nLockTime=0)
CTxIn(COutPoint(893335, 0), scriptSig=0x01B8C315FD58F0DFA0DEA2)
CTxOut(nValue=1.85850000, scriptPubKey=OP_DUP OP_HASH160 0x3181)
CTxOut(nValue=3.14150000, scriptPubKey=OP_DUP OP_HASH160 0xF99E)
CTransaction(hash=89aa32, ver=1, vin.size=1, vout.size=2, nLockTime=0)
CTxIn(COutPoint(4a7469, 0), scriptSig=0x010D15199DCE4B11D391CF)
CTxOut(nValue=0.05000000, scriptPubKey=OP_DUP OP_HASH160 0x5603)
CTxOut(nValue=0.20000000, scriptPubKey=OP_DUP OP_HASH160 0x6074)
CTransaction(hash=e3e69c, ver=1, vin.size=1, vout.size=2, nLockTime=0)
CTxIn(COutPoint(b77e0f, 1), scriptSig=0x012E18AF1264180255E0C3)
CTxOut(nValue=50.00000000, scriptPubKey=OP_DUP OP_HASH160 0x458E)
CTxOut(nValue=100.00000000, scriptPubKey=OP_DUP OP_HASH160 0x9EEF)
vMerkleTree: 2d7f4d 3407a8 5edf5a 65c356 89aa32 e3e69c 8ebc6a d5e414 89b77c d1074c 70a4e6 e81287</pre>
In vMerkleTree, 2d7f4d-e3e69c are transactions. The remaining hashes are tree hashes. Notice that the top hash is the Merkle root included in the block header. The tree:

---------e81287-------
| |
----d1074c----- 70a4e6 (this is a hash of two 89b77c hashes)
| | |
-8ebc6a- -d5e414- -89b77c-
| | | | | |
2d7f4d 3407a8 5edf5a 65c356 89aa32 e3e69c