tbc

package
v0.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 3, 2024 License: MIT Imports: 44 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	UtxoIndexHashKey = []byte("utxoindexhash") // last indexed utxo hash
	TxIndexHashKey   = []byte("txindexhash")   // last indexed tx hash

	ErrAlreadyIndexing = errors.New("already indexing")
)
View Source 
var (
	ErrReset            = errors.New("reset")
	ErrNoAddresses      = errors.New("no addresses")
	ErrDNSSeed          = errors.New("could not dns seed")
	ErrNoConnectedPeers = errors.New("no connected peers")
)
View Source 
var (
	ErrTxAlreadyBroadcast = errors.New("tx already broadcast")
	ErrTxBroadcastNoPeers = errors.New("can't broadcast tx, no peers")
)
View Source 
var ErrNotLinear = NotLinearError("not linear")

Functions

This section is empty.

Types

type Config 

type Config struct {
	AutoIndex               bool
	BlockCache              int
	BlockheaderCache        int
	BlockSanity             bool
	LevelDBHome             string
	ListenAddress           string
	LogLevel                string
	MaxCachedTxs            int
	MempoolEnabled          bool
	Network                 string
	PeersWanted             int
	PrometheusListenAddress string
	PprofListenAddress      string
	Seeds                   []string

	// Fields used for running TBC in External Header Mode, where P2P is disabled
	// and TBC is used to determine consensus based on headers fed from external
	// code that manages the TBC node.
	ExternalHeaderMode      bool              // Whether Header-Only Mode is enabled
	EffectiveGenesisBlock   *wire.BlockHeader // The header to use as the first block in TBC's consensus view
	GenesisHeightOffset     uint64            // The height of the effective genesis block
	GenesisDifficultyOffset big.Int           // The cumulative difficulty of the effective genesis block
}

func NewDefaultConfig 

func NewDefaultConfig() *Config

type HashHeight added in v0.2.0 

type HashHeight struct {
	Hash   chainhash.Hash
	Height uint64
}

func (HashHeight) String added in v0.2.0 

func (h HashHeight) String() string

type NotLinearError added in v0.6.0 

type NotLinearError string

func (NotLinearError) Error added in v0.6.0 

func (e NotLinearError) Error() string

func (NotLinearError) Is added in v0.6.0 

func (e NotLinearError) Is(target error) bool

type PeerManager added in v0.3.0 

type PeerManager struct {
	// contains filtered or unexported fields
}

PeerManager keeps track of the available peers and their quality.

func NewPeerManager added in v0.5.0 

func NewPeerManager(net wire.BitcoinNet, seeds []string, want int) (*PeerManager, error)

NewPeerManager returns a new peer manager.

func (*PeerManager) All added in v0.5.0 

func (pm *PeerManager) All(ctx context.Context, f func(ctx context.Context, p *rawpeer.RawPeer))

All runs a call back on all connected peers.

func (*PeerManager) AllBlock added in v0.5.0 

func (pm *PeerManager) AllBlock(ctx context.Context, f func(ctx context.Context, p *rawpeer.RawPeer))

func (*PeerManager) Bad added in v0.5.0 

func (pm *PeerManager) Bad(ctx context.Context, address string) error

Bad marks the peer as bad.

func (*PeerManager) Good added in v0.5.0 

func (pm *PeerManager) Good(address string) error

Good adds peer to good list if it does not exist in connected and good list already.

func (*PeerManager) HandleAddr added in v0.5.0 

func (pm *PeerManager) HandleAddr(peers []string)

HandleAddr adds peers to good list.

func (*PeerManager) Random added in v0.5.0 

func (pm *PeerManager) Random() (*rawpeer.RawPeer, error)

Random returns a random connected peer.

func (*PeerManager) RandomConnect added in v0.5.0 

func (pm *PeerManager) RandomConnect(ctx context.Context) (*rawpeer.RawPeer, error)

RandomConnect blocks until there is a peer ready to use.

func (*PeerManager) Run added in v0.5.0 

func (pm *PeerManager) Run(ctx context.Context) error

func (*PeerManager) Stats added in v0.3.0 

func (pm *PeerManager) Stats() (int, int, int)

Stats returns peer statistics.

func (*PeerManager) String added in v0.5.0 

func (pm *PeerManager) String() string

type Server 

type Server struct {
	// contains filtered or unexported fields
}

func NewServer 

func NewServer(cfg *Config) (*Server, error)

func (*Server) AddExternalHeaders added in v0.7.0 

func (s *Server) AddExternalHeaders(ctx context.Context, headers *wire.MsgHeaders, upstreamStateId []byte) (tbcd.InsertType, *tbcd.BlockHeader, *tbcd.BlockHeader, int, error)

AddExternalHeaders XXX if we are passing in upstreamStateId then why does the default live in tbcd?

func (*Server) BalanceByAddress 

func (s *Server) BalanceByAddress(ctx context.Context, encodedAddress string) (uint64, error)

func (*Server) BalanceByScriptHash added in v0.4.4 

func (s *Server) BalanceByScriptHash(ctx context.Context, hash tbcd.ScriptHash) (uint64, error)

func (*Server) BlockByHash added in v0.3.8 

func (s *Server) BlockByHash(ctx context.Context, hash *chainhash.Hash) (*btcutil.Block, error)

BlockByHash returns a block with the given hash.

func (*Server) BlockHashByTxId added in v0.4.4 

func (s *Server) BlockHashByTxId(ctx context.Context, txId *chainhash.Hash) (*chainhash.Hash, error)

func (*Server) BlockHeaderBest added in v0.2.0 

func (s *Server) BlockHeaderBest(ctx context.Context) (uint64, *wire.BlockHeader, error)

BlockHeaderBest returns the headers for the best known blocks.

func (*Server) BlockHeaderByHash 

func (s *Server) BlockHeaderByHash(ctx context.Context, hash *chainhash.Hash) (*wire.BlockHeader, uint64, error)

XXX should we return a form of tbcd.BlockHeader which contains all info? and note that the return parameters here are reversed from BlockHeaderBest call.

func (*Server) BlockHeadersByHeight 

func (s *Server) BlockHeadersByHeight(ctx context.Context, height uint64) ([]*wire.BlockHeader, error)

func (*Server) BlockInTxIndex added in v0.4.4 

func (s *Server) BlockInTxIndex(ctx context.Context, blkid *chainhash.Hash) (bool, error)

func (*Server) BlockInsert added in v0.6.0 

func (s *Server) BlockInsert(ctx context.Context, blk *wire.MsgBlock) (int64, error)

func (*Server) BlocksMissing added in v0.4.4 

func (s *Server) BlocksMissing(ctx context.Context, count int) ([]tbcd.BlockIdentifier, error)

func (*Server) DBClose 

func (s *Server) DBClose() error

XXX remove and find a different way to do this.

func (*Server) DBOpen 

func (s *Server) DBOpen(ctx context.Context) error

DBOpen opens the underlying server database. It has been put in its own function to make it available during tests and hemictl. It would be good if it can be deleted. XXX remove and find a different way to do this.

func (*Server) DifficultyAtHash added in v0.2.0 

func (s *Server) DifficultyAtHash(ctx context.Context, hash *chainhash.Hash) (*big.Int, error)

func (*Server) DownloadBlockFromRandomPeers added in v0.6.0 

func (s *Server) DownloadBlockFromRandomPeers(ctx context.Context, block *chainhash.Hash, count uint) (*btcutil.Block, error)

func (*Server) ExternalHeaderSetup added in v0.7.0 

func (s *Server) ExternalHeaderSetup(ctx context.Context, upstreamStateId []byte) error

func (*Server) ExternalHeaderTearDown added in v0.7.0 

func (s *Server) ExternalHeaderTearDown() error

func (*Server) FeesAtHeight 

func (s *Server) FeesAtHeight(ctx context.Context, height, count int64) (uint64, error)

func (*Server) FullBlockAvailable added in v0.7.0 

func (s *Server) FullBlockAvailable(ctx context.Context, hash *chainhash.Hash) (bool, error)

FullBlockAvailable returns whether TBC has the full block corresponding to the specified hash available in its database.

func (*Server) IndexIsLinear added in v0.2.8 

func (s *Server) IndexIsLinear(ctx context.Context, startHash, endHash *chainhash.Hash) (int, error)

func (*Server) RawBlockHeaderBest added in v0.2.0 

func (s *Server) RawBlockHeaderBest(ctx context.Context) (uint64, api.ByteSlice, error)

RawBlockHeaderBest returns the raw header for the best known block. XXX should we return cumulative difficulty, hash?

func (*Server) RawBlockHeadersByHeight 

func (s *Server) RawBlockHeadersByHeight(ctx context.Context, height uint64) ([]api.ByteSlice, error)

func (*Server) RemoveExternalHeaders added in v0.7.0 

func (s *Server) RemoveExternalHeaders(ctx context.Context, headers *wire.MsgHeaders, tipAfterRemoval *wire.BlockHeader, upstreamStateId []byte) (tbcd.RemoveType, *tbcd.BlockHeader, error)

RemoveExternalHeaders removes the provided headers from TBC's state knowledge, setting the canonical tip to the provided tip. This method can only be used when TBC is running in External Header Mode.

The upstream state id is an optional identifier that the caller can use to track some upstream state which represents TBC's own state once this removal is performed. For example, op-geth uses this to track the hash of the EVM block which cumulatively represents TBC's entire header knowledge after the removal is processed, such that re-applying all Bitcoin Attributes Deposited transactions in the EVM from genesis to that hash would result in TBC having this state.

This upstream state id is tracked in TBC rather than upstream in the caller so that updates to the upstreamCursor are always made atomically with the corresponding TBC database state transition. Otherwise, an unexpected termination between updating TBC state and recording the updated upstreamCursor could cause state corruption.

func (*Server) Run 

func (s *Server) Run(pctx context.Context) error

func (*Server) ScriptHashAvailableToSpend added in v0.7.0 

func (s *Server) ScriptHashAvailableToSpend(ctx context.Context, txId *chainhash.Hash, index uint32) (bool, error)

ScriptHashAvailableToSpend returns a boolean which indicates whether a specific output (uniquely identified by TxId output index) is available for spending in the UTXO table. This function can return false for two reasons:

  1. The outpoint was already spent
  2. The outpoint never existed

func (*Server) SetUpstreamStateId added in v0.7.0 

func (s *Server) SetUpstreamStateId(ctx context.Context, upstreamStateId *[32]byte) error

SetUpstreamStateId sets a new upstream state ID without making any other state changes to TBC, used when the upstream state is updated without requiring any TBC updates.

func (*Server) SpentOutputsByTxId added in v0.2.8 

func (s *Server) SpentOutputsByTxId(ctx context.Context, txId *chainhash.Hash) ([]tbcd.SpentInfo, error)

func (*Server) SyncIndexersToBest added in v0.4.4 

func (s *Server) SyncIndexersToBest(ctx context.Context) error

func (*Server) SyncIndexersToHash added in v0.2.0 

func (s *Server) SyncIndexersToHash(ctx context.Context, hash *chainhash.Hash) error

SyncIndexersToHash tries to move the various indexers to the supplied hash (inclusive). Note: on unwind it means that it WILL unwind the the various indexers including the hash that was passed in. E.g. if this unwinds from 1001 to 1000 the indexes for block 1000 WILL be updated as well.

func (*Server) Synced 

func (s *Server) Synced(ctx context.Context) SyncInfo

Synced returns true if all block headers, blocks and all indexes are caught up.

func (*Server) TxBroadcast added in v0.5.0 

func (s *Server) TxBroadcast(ctx context.Context, tx *wire.MsgTx, force bool) (*chainhash.Hash, error)

func (*Server) TxBroadcastAllToPeer added in v0.5.0 

func (s *Server) TxBroadcastAllToPeer(ctx context.Context, p *rawpeer.RawPeer) error

func (*Server) TxById 

func (s *Server) TxById(ctx context.Context, txId *chainhash.Hash) (*wire.MsgTx, error)

func (*Server) TxIndexHash added in v0.2.0 

func (s *Server) TxIndexHash(ctx context.Context) (*HashHeight, error)

TxIndexHash returns the last hash that has been been Tx indexed.

func (*Server) TxIndexIsLinear added in v0.2.8 

func (s *Server) TxIndexIsLinear(ctx context.Context, endHash *chainhash.Hash) (int, error)

func (*Server) TxIndexer 

func (s *Server) TxIndexer(ctx context.Context, endHash *chainhash.Hash) error

func (*Server) TxIndexerUnwind added in v0.2.8 

func (s *Server) TxIndexerUnwind(ctx context.Context, startBH, endBH *tbcd.BlockHeader) error

func (*Server) TxIndexerWind added in v0.2.8 

func (s *Server) TxIndexerWind(ctx context.Context, startBH, endBH *tbcd.BlockHeader) error

func (*Server) UpstreamStateId added in v0.7.0 

func (s *Server) UpstreamStateId(ctx context.Context) (*[32]byte, error)

UpstreamStateId fetches the last-stored upstream state ID. If the last header insertion/removal did not specify an upstream state ID, this will return the default upstream state ID.

func (*Server) UtxoIndexHash added in v0.2.0 

func (s *Server) UtxoIndexHash(ctx context.Context) (*HashHeight, error)

UtxoIndexHash returns the last hash that has been been UTxO indexed.

func (*Server) UtxoIndexIsLinear added in v0.2.8 

func (s *Server) UtxoIndexIsLinear(ctx context.Context, endHash *chainhash.Hash) (int, error)

func (*Server) UtxoIndexer 

func (s *Server) UtxoIndexer(ctx context.Context, endHash *chainhash.Hash) error

func (*Server) UtxoIndexerUnwind added in v0.2.8 

func (s *Server) UtxoIndexerUnwind(ctx context.Context, startBH, endBH *tbcd.BlockHeader) error

func (*Server) UtxoIndexerWind added in v0.2.8 

func (s *Server) UtxoIndexerWind(ctx context.Context, startBH, endBH *tbcd.BlockHeader) error

func (*Server) UtxosByAddress 

func (s *Server) UtxosByAddress(ctx context.Context, encodedAddress string, start uint64, count uint64) ([]tbcd.Utxo, error)

func (*Server) UtxosByScriptHash added in v0.4.4 

func (s *Server) UtxosByScriptHash(ctx context.Context, hash tbcd.ScriptHash, start uint64, count uint64) ([]tbcd.Utxo, error)

type SyncInfo 

type SyncInfo struct {
	Synced      bool // True when all indexing is caught up
	BlockHeader HashHeight
	Utxo        HashHeight
	Tx          HashHeight
}

Source Files

View all Source files

Directories

Path Synopsis
rawpeer
Package rawpeer provides low level access to a bitcoin p2p node.
 Package rawpeer provides low level access to a bitcoin p2p node.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.