2018-12-07

NetWork Message

• structure

FiledSize	Description	Data type	Comments
4	magic	uint32_t	Magic value indicating message origin network, and used to seek to next messge when stream state is unknown
12	command	char[12]	ASCII string identifying the packet content, NULL padded (non-NULL padding results in packet rejected)
4	length	uint32_t	Length of payload in number of bytes
4	checksum	uint32_t	First 4 bytes of sha256(sha256(payload))
?	payload	uchar[]	The actual data

Version and VerAck

• 当一个节点连接别的节点时，他会立刻发送他自己的version消息，对端节点会回复对端节点的version。在交换version之前，任何消息不允许交换。在收到version消息后，会回复verack响应。

-TODO: version
-TODO: XT

• version的payload

FiledSize	Description	Data type	Comments
4	version	int32_t	Identifies protocol version being used by the node
8	services	uint64_t	bitfield of features to be enabled for this connection
8	timestamp	int64_t	standard UNIX timestamp in seconds
26	addr_recv	net_addr	The network address of the node receiving this message
version < 31800	reject
26	addr_from	net_addr	The network address of the node emitting this message
8	nonce	uinit64_t	Node random nonce, randomly generated every time a version packet is sent. This nonce is used to detect connections to self.
?	user_agent	var_str	User Agent
4	start_Height	int32_t	The last block received by the emitting node
1	reply	bool	Whether the remote peer should announce relayed transaction or not see BIP0037;(If false then broad cast transactions will not be announced until a filter{load, add, clear} command is received. If missing or true, no change in protocol behaviour occurs.)

• Services

Value	Name	Description
0	NODE_NONE	Nothing
1	NODE_NETWORK	NODE_NETWORK means that the node is capable of serving the block chain.It is currently set by all Bitcoin ABC nodes, and is unset by SPV clients or other peers that just want network services but don't provide them.
2	NODE_GETUTXO	NODE_GETUTXO means the node is capable of responding to the getutxo protocol request. Bitcoin ABC does not support this but a patch set called Bitcoin XT does. See BIP64 for details on how thisi is implemented.
4	NODE_BLOOM	NODE_BLOOM means the node is capable and willing to handle bloom-filtered connections. Bitcion ABC nodes used to support this by default, without advertising this bit, but no longer do as of protocol version 70011 (= NO_BLOOM_VERSION)
16	NODE_XTHIN	NODE_XTHIN means the node supports Xtreme Thinblocks. If this is turned off then the node will not service nor make xthin requests.
32	NODE_BITCOIN_CASH	NODE_BITCOIN_CASH means the node supports Bitcoin Cash and the associated consensus rule changes. This service bit is intended to be used prior until some time after the UAHF activation when the Bitcoin Cash net work has adequately separated. TODO: remove (free up) the NODE_BITCOIN_CASH service bit once no longer needed.

• About Services

Bits 24-31 are reserved for temporary experiments. Just pick a bit that isn't getting used, or one not being used much, and notify the bitcoin-development mailing list. Remember that service bits are just unauthenticated advertisements, so your code must be robust against collisions and other cases where nodes may be advertising a service they do not actually support. Other service bits should be allocated via the BIP process.

• VerAck payload

This message consistes of only a message header with the command string "verack".

• [发送] 当发起连接后，在init node时发送version

• [接收] 填充node相关信息。然后发送ack。如果该链接是outbound并且本地address数量不够1000，向对端发送GETADDR获取对端的可用peer。

• alert 向version < 70012的客户端发送alert

PING PONG

• PING

The ping message is sent primarily to confirm that the TCP/IP connection is still valid. An error in transmisson s presumed to be a closed connection and the address is removed as a current peer.

Payload:

Field Size	Description	Data type	Comments
8	nonce	uint64_t	random nonce

• PONG

The pong message is sent in response to a ping message. In modern protocol versions, a pong response is generated using a nonce included in ping.

Payload:

Field Size	Description	Data type	Comments
8	nonce	uint64_t	nonce from ping

REJECT

The rejct message is sent when messages are rejected.

Field Size	Description	Data type	Comments
1+	message	std::string	type of message rejected
1	ccode	uint8_t	code relating to rejected message
1+	reason	std::string	text version of reason for rejection
0+	data	uint256 hash	Optional extra data provided by some errors. Currently, all errors which provide this field fill it with the TXID or block header hash of the object being rejected, so the field is 32 bytes.