4deb922c9d
Although it is possible to get the command name for each msg type by creating an instances of the type and calling the Command method against it, it's slightly more efficient to simply allows callers to have direct access to the exported constants. This is currently really useful for the reject message since callers need to be able to examine the command type to determine whether or not the hash field needs to be included.
87 lines
2.6 KiB
Go
87 lines
2.6 KiB
Go
// Copyright (c) 2013-2014 Conformal Systems LLC.
|
|
// Use of this source code is governed by an ISC
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package btcwire
|
|
|
|
import (
|
|
"io"
|
|
)
|
|
|
|
// MsgPing implements the Message interface and represents a bitcoin ping
|
|
// message.
|
|
//
|
|
// For versions BIP0031Version and earlier, it is used primarily to confirm
|
|
// that a connection is still valid. A transmission error is typically
|
|
// interpreted as a closed connection and that the peer should be removed.
|
|
// For versions AFTER BIP0031Version it contains an identifier which can be
|
|
// returned in the pong message to determine network timing.
|
|
//
|
|
// The payload for this message just consists of a nonce used for identifying
|
|
// it later.
|
|
type MsgPing struct {
|
|
// Unique value associated with message that is used to identify
|
|
// specific ping message.
|
|
Nonce uint64
|
|
}
|
|
|
|
// BtcDecode decodes r using the bitcoin protocol encoding into the receiver.
|
|
// This is part of the Message interface implementation.
|
|
func (msg *MsgPing) BtcDecode(r io.Reader, pver uint32) error {
|
|
// There was no nonce for BIP0031Version and earlier.
|
|
// NOTE: > is not a mistake here. The BIP0031 was defined as AFTER
|
|
// the version unlike most others.
|
|
if pver > BIP0031Version {
|
|
err := readElement(r, &msg.Nonce)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// BtcEncode encodes the receiver to w using the bitcoin protocol encoding.
|
|
// This is part of the Message interface implementation.
|
|
func (msg *MsgPing) BtcEncode(w io.Writer, pver uint32) error {
|
|
// There was no nonce for BIP0031Version and earlier.
|
|
// NOTE: > is not a mistake here. The BIP0031 was defined as AFTER
|
|
// the version unlike most others.
|
|
if pver > BIP0031Version {
|
|
err := writeElement(w, msg.Nonce)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// Command returns the protocol command string for the message. This is part
|
|
// of the Message interface implementation.
|
|
func (msg *MsgPing) Command() string {
|
|
return CmdPing
|
|
}
|
|
|
|
// MaxPayloadLength returns the maximum length the payload can be for the
|
|
// receiver. This is part of the Message interface implementation.
|
|
func (msg *MsgPing) MaxPayloadLength(pver uint32) uint32 {
|
|
plen := uint32(0)
|
|
// There was no nonce for BIP0031Version and earlier.
|
|
// NOTE: > is not a mistake here. The BIP0031 was defined as AFTER
|
|
// the version unlike most others.
|
|
if pver > BIP0031Version {
|
|
// Nonce 8 bytes.
|
|
plen += 8
|
|
}
|
|
|
|
return plen
|
|
}
|
|
|
|
// NewMsgPing returns a new bitcoin ping message that conforms to the Message
|
|
// interface. See MsgPing for details.
|
|
func NewMsgPing(nonce uint64) *MsgPing {
|
|
return &MsgPing{
|
|
Nonce: nonce,
|
|
}
|
|
}
|