mirror of
https://github.com/FlipsideCrypto/dcrd.git
synced 2026-02-06 10:56:47 +00:00
71500c80f2
This change begins the work of bringing committed filters to the network consensus daemon. Committed filters are designed to enable light wallets without many of the privacy issues associated with server-side bloom filtering. The new gcs package provides the primitives for creating and matching against Golomb-coded sets (GCS) filters while the blockcf package provides creation of filters and filter entries for data structures found in blocks. The wire package has been updated to define a new protocol version and service flag for advertising CF support and includes types for the following new messages: cfheaders, cfilter, cftypes, getcfheaders, getcfilter, getcftypes. The peer package and server implementation have been updated to include support for the new protocol version and messages. Filters are created using a collision probability of 2^-20 and are saved to a new optional database index when running with committed filter support enabled (the default). At first startup, if support is not disabled, the index will be created and populated with filters and filter headers for all preexisting blocks, and new filters will be recorded for processed blocks. Multiple filter types are supported. The regular filter commits to output scripts and previous outpoints that any non-voting wallet will require access to. Scripts and previous outpoints that can only be spent by votes and revocations are not committed to the filter. The extended filter is a supplementary filter which commits to all transaction hashes and script data pushes from the input scripts of non-coinbase regular and ticket purchase transactions. Creating these filters is based on the algorithm defined by BIP0158 but is modified to only commit "regular" data in stake transactions to prevent committed filters from being used to create SPV voting wallets.
77 lines
2.3 KiB
Go
77 lines
2.3 KiB
Go
// Copyright (c) 2017 The btcsuite developers
|
|
// Copyright (c) 2017 The Lightning Network Developers
|
|
// Copyright (c) 2018 The Decred developers
|
|
// Use of this source code is governed by an ISC
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package wire
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
|
|
"github.com/decred/dcrd/chaincfg/chainhash"
|
|
)
|
|
|
|
// MsgGetCFilter implements the Message interface and represents a getcfilter
|
|
// message. It is used to request a committed filter for a block.
|
|
type MsgGetCFilter struct {
|
|
BlockHash chainhash.Hash
|
|
FilterType FilterType
|
|
}
|
|
|
|
// BtcDecode decodes r using the wire protocol encoding into the receiver.
|
|
// This is part of the Message interface implementation.
|
|
func (msg *MsgGetCFilter) BtcDecode(r io.Reader, pver uint32) error {
|
|
if pver < NodeCFVersion {
|
|
str := fmt.Sprintf("getcfilter message invalid for protocol "+
|
|
"version %d", pver)
|
|
return messageError("MsgGetCFilter.BtcDecode", str)
|
|
}
|
|
|
|
err := readElement(r, &msg.BlockHash)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return readElement(r, (*uint8)(&msg.FilterType))
|
|
}
|
|
|
|
// BtcEncode encodes the receiver to w using the wire protocol encoding.
|
|
// This is part of the Message interface implementation.
|
|
func (msg *MsgGetCFilter) BtcEncode(w io.Writer, pver uint32) error {
|
|
if pver < NodeCFVersion {
|
|
str := fmt.Sprintf("getcfilter message invalid for protocol "+
|
|
"version %d", pver)
|
|
return messageError("MsgGetCFilter.BtcEncode", str)
|
|
}
|
|
|
|
err := writeElement(w, &msg.BlockHash)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return binarySerializer.PutUint8(w, uint8(msg.FilterType))
|
|
}
|
|
|
|
// Command returns the protocol command string for the message. This is part
|
|
// of the Message interface implementation.
|
|
func (msg *MsgGetCFilter) Command() string {
|
|
return CmdGetCFilter
|
|
}
|
|
|
|
// MaxPayloadLength returns the maximum length the payload can be for the
|
|
// receiver. This is part of the Message interface implementation.
|
|
func (msg *MsgGetCFilter) MaxPayloadLength(pver uint32) uint32 {
|
|
// Block hash + filter type.
|
|
return chainhash.HashSize + 1
|
|
}
|
|
|
|
// NewMsgGetCFilter returns a new getcfilter message that conforms to the
|
|
// Message interface using the passed parameters and defaults for the remaining
|
|
// fields.
|
|
func NewMsgGetCFilter(blockHash *chainhash.Hash, filterType FilterType) *MsgGetCFilter {
|
|
return &MsgGetCFilter{
|
|
BlockHash: *blockHash,
|
|
FilterType: filterType,
|
|
}
|
|
}
|