mirror of
				https://github.com/bitcoin/bips.git
				synced 2025-10-27 14:09:10 +00:00 
			
		
		
		
	BIP 22 & 145: Use simple Yes/No rather than templates (which don't work on GitHub)
This commit is contained in:
		
							parent
							
								
									a01584f6eb
								
							
						
					
					
						commit
						ed0f8da4ad
					
				| @ -26,9 +26,9 @@ Block template creation can be influenced by various parameters: | |||||||
| |- | |- | ||||||
| ! Key !! Required !! Type !! Description | ! Key !! Required !! Type !! Description | ||||||
| |- | |- | ||||||
| | capabilities || {{No}} || Array of Strings || SHOULD contain a list of the following, to indicate client-side support: [[#Optional: Long Polling|"longpoll"]], "coinbasetxn", "coinbasevalue", [[bip-0023.mediawiki#Block Proposal|"proposal"]], [[bip-0023.mediawiki#Logical Services|"serverlist"]], "workid", and any of the [[bip-0023.mediawiki#Mutations|mutations]] | | capabilities || No || Array of Strings || SHOULD contain a list of the following, to indicate client-side support: [[#Optional: Long Polling|"longpoll"]], "coinbasetxn", "coinbasevalue", [[bip-0023.mediawiki#Block Proposal|"proposal"]], [[bip-0023.mediawiki#Logical Services|"serverlist"]], "workid", and any of the [[bip-0023.mediawiki#Mutations|mutations]] | ||||||
| |- | |- | ||||||
| | mode || {{No}} || String || MUST be "template" or omitted | | mode || No || String || MUST be "template" or omitted | ||||||
| |} | |} | ||||||
| 
 | 
 | ||||||
| getblocktemplate MUST return a JSON Object containing the following keys: | getblocktemplate MUST return a JSON Object containing the following keys: | ||||||
| @ -37,29 +37,29 @@ getblocktemplate MUST return a JSON Object containing the following keys: | |||||||
| |- | |- | ||||||
| ! Key !! Required !! Type !! Description | ! Key !! Required !! Type !! Description | ||||||
| |- | |- | ||||||
| | bits || {{Yes}} || String || the compressed difficulty in hexadecimal | | bits || Yes || String || the compressed difficulty in hexadecimal | ||||||
| |- | |- | ||||||
| | curtime || {{Yes}} || Number || the current time as seen by the server (recommended for block time) - note this is not necessarily the system clock, and must fall within the mintime/maxtime rules | | curtime || Yes || Number || the current time as seen by the server (recommended for block time) - note this is not necessarily the system clock, and must fall within the mintime/maxtime rules | ||||||
| |- | |- | ||||||
| | height || {{Yes}} || Number || the height of the block we are looking for | | height || Yes || Number || the height of the block we are looking for | ||||||
| |- | |- | ||||||
| | previousblockhash || {{Yes}} || String || the hash of the previous block, in big-endian hexadecimal | | previousblockhash || Yes || String || the hash of the previous block, in big-endian hexadecimal | ||||||
| |- | |- | ||||||
| | sigoplimit || {{No}} || Number || number of sigops allowed in blocks | | sigoplimit || No || Number || number of sigops allowed in blocks | ||||||
| |- | |- | ||||||
| | sizelimit || {{No}} || Number || number of bytes allowed in blocks | | sizelimit || No || Number || number of bytes allowed in blocks | ||||||
| |- | |- | ||||||
| | transactions || {{Yes|Should}} || Array of Objects || Objects containing [[#Transactions Object Format|information for Bitcoin transactions]] (excluding coinbase) | | transactions || Should || Array of Objects || Objects containing [[#Transactions Object Format|information for Bitcoin transactions]] (excluding coinbase) | ||||||
| |- | |- | ||||||
| | version || {{Yes}} || Number || always 1 or 2 (at least for bitcoin) - clients MUST understand the implications of the version they use (eg, comply with [[bip-0034.mediawiki|BIP 0034]] for version 2) | | version || Yes || Number || always 1 or 2 (at least for bitcoin) - clients MUST understand the implications of the version they use (eg, comply with [[bip-0034.mediawiki|BIP 0034]] for version 2) | ||||||
| |- | |- | ||||||
| | coinbaseaux || {{No}} || Object || data that SHOULD be included in the coinbase's scriptSig content. Only the values (hexadecimal byte-for-byte) in this Object should be included, not the keys. This does not include the block height, which is required to be included in the scriptSig by [[bip-0034.mediawiki|BIP 0034]]. It is advisable to encode values inside "PUSH" opcodes, so as to not inadvertently expend SIGOPs (which are counted toward limits, despite not being executed). | | coinbaseaux || No || Object || data that SHOULD be included in the coinbase's scriptSig content. Only the values (hexadecimal byte-for-byte) in this Object should be included, not the keys. This does not include the block height, which is required to be included in the scriptSig by [[bip-0034.mediawiki|BIP 0034]]. It is advisable to encode values inside "PUSH" opcodes, so as to not inadvertently expend SIGOPs (which are counted toward limits, despite not being executed). | ||||||
| |- | |- | ||||||
| | coinbasetxn || {{Patch|this or ↓}} || Object || [[#Transactions Object Format|information for coinbase transaction]] | | coinbasetxn || this or ↓ || Object || [[#Transactions Object Format|information for coinbase transaction]] | ||||||
| |- | |- | ||||||
| | coinbasevalue || {{Patch|this or ↑}} || Number || total funds available for the coinbase (in Satoshis) | | coinbasevalue || this or ↑ || Number || total funds available for the coinbase (in Satoshis) | ||||||
| |- | |- | ||||||
| | workid || {{No}} || String || if provided, this value must be returned with results (see [[#Block Submission|Block Submission]]) | | workid || No || String || if provided, this value must be returned with results (see [[#Block Submission|Block Submission]]) | ||||||
| |} | |} | ||||||
| 
 | 
 | ||||||
| ==== Transactions Object Format ==== | ==== Transactions Object Format ==== | ||||||
|  | |||||||
| @ -22,11 +22,11 @@ The template Object is revised to include these keys: | |||||||
| |- | |- | ||||||
| ! Key !! Required !! Type !! Description | ! Key !! Required !! Type !! Description | ||||||
| |- | |- | ||||||
| | costlimit || {{No}} || Number || total cost allowed in blocks | | costlimit || No || Number || total cost allowed in blocks | ||||||
| |- | |- | ||||||
| | sigoplimit || {{No}} || Number || total sigop cost allowed in blocks divided by 4 | | sigoplimit || No || Number || total sigop cost allowed in blocks divided by 4 | ||||||
| |- | |- | ||||||
| | version || {{Yes}} || Number || block version; clients MUST understand the implications of the version they use (eg, comply with [[bip-0141.mediawiki|BIP 141]] for version 5) | | version || Yes || Number || block version; clients MUST understand the implications of the version they use (eg, comply with [[bip-0141.mediawiki|BIP 141]] for version 5) | ||||||
| |} | |} | ||||||
| 
 | 
 | ||||||
| ====Transactions Object Format==== | ====Transactions Object Format==== | ||||||
|  | |||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user