Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

blockchain

package

Go to main page

Versions in this module

v0

v0.3.1

May 7, 2024

v0.3.0

May 3, 2024

v0.2.3

Apr 22, 2024

v0.2.2

Apr 17, 2024

v0.2.1

Apr 5, 2024

Changes in this version

+ const PtrSize

v0.2.0

Mar 20, 2024

Changes in this version

+ type CachedLeavesBackEnd struct

+ func InitCachedLeavesBackEnd(datadir string, maxMemoryUsage int64) (*CachedLeavesBackEnd, error)

+ func (m *CachedLeavesBackEnd) Close() error

+ func (m *CachedLeavesBackEnd) Delete(k utreexo.Hash)

+ func (m *CachedLeavesBackEnd) ForEach(fn func(utreexo.Hash, uint64) error) error

+ func (m *CachedLeavesBackEnd) Get(k utreexo.Hash) (uint64, bool)

+ func (m *CachedLeavesBackEnd) Length() int

+ func (m *CachedLeavesBackEnd) Put(k utreexo.Hash, v uint64)

+ type NodesBackEnd struct

+ func InitNodesBackEnd(datadir string, maxTotalMemoryUsage int64) (*NodesBackEnd, error)

+ func (m *NodesBackEnd) Close() error

+ func (m *NodesBackEnd) Delete(k uint64)

+ func (m *NodesBackEnd) ForEach(fn func(uint64, utreexo.Leaf) error) error

+ func (m *NodesBackEnd) Get(k uint64) (utreexo.Leaf, bool)

+ func (m *NodesBackEnd) Length() int

+ func (m *NodesBackEnd) Put(k uint64, v utreexo.Leaf)

v0.1.0

Feb 4, 2024

Changes in this version

+ const CheckpointConfirmations

+ const CoinbaseWitnessDataLen

+ const CoinbaseWitnessPkScriptLength

+ const MaxBlockBaseSize

+ const MaxBlockSigOpsCost

+ const MaxBlockWeight

+ const MaxCoinbaseScriptLen

+ const MaxOutputsPerBlock

+ const MaxTimeOffsetSeconds

+ const MaxUintptr

+ const MinCoinbaseScriptLen

+ const MinTxOutputWeight

+ const WitnessScaleFactor

+ var WitnessMagicBytes = []byte

+ func BigToCompact(n *big.Int) uint32

+ func BlockToAddLeaves(block *btcutil.Block, skiplist []uint32, remembers []uint32, outCount int) []utreexo.Leaf

+ func BlockToDelOPs(blk *btcutil.Block) []wire.OutPoint

+ func BuildMerkleTreeStore(transactions []*btcutil.Tx, witness bool) []*chainhash.Hash

+ func CalcBlockSubsidy(height int32, chainParams *chaincfg.Params) int64

+ func CalcWork(bits uint32) *big.Int

+ func ChainstateInitialized(dbTx database.Tx) bool

+ func CheckBlockSanity(block *btcutil.Block, powLimit *big.Int, timeSource MedianTimeSource) error

+ func CheckProofOfWork(block *btcutil.Block, powLimit *big.Int) error

+ func CheckTransactionInputs(tx *btcutil.Tx, txHeight int32, utxoView *UtxoViewpoint, ...) (int64, error)

+ func CheckTransactionSanity(tx *btcutil.Tx) error

+ func CompactToBig(compact uint32) *big.Int

+ func CountP2SHSigOps(tx *btcutil.Tx, isCoinBaseTx bool, utxoView *UtxoViewpoint) (int, error)

+ func CountSigOps(tx *btcutil.Tx) int

+ func DedupeBlock(blk *btcutil.Block) (inCount, outCount int, inskip []uint32, outskip []uint32)

+ func DeserializeUtreexoRoots(serializedUView []byte) (uint64, []utreexo.Hash, error)

+ func DisableLog()

+ func ExtractAccumulatorAddDels(block *btcutil.Block, bestChain *chainView, remembers []uint32) ([]utreexo.Leaf, []utreexo.Hash, error)

+ func ExtractCoinbaseHeight(coinbaseTx *btcutil.Tx) (int32, error)

+ func ExtractMerkleBranch(merkles []*chainhash.Hash, txHash chainhash.Hash) []*chainhash.Hash

+ func ExtractWitnessCommitment(tx *btcutil.Tx) ([]byte, bool)

+ func FileExists(name string) bool

+ func GetBlockWeight(blk *btcutil.Block) int64

+ func GetSigOpCost(tx *btcutil.Tx, isCoinBaseTx bool, utxoView *UtxoViewpoint, bip16, segWit bool) (int, error)

+ func GetTransactionWeight(tx *btcutil.Tx) int64

+ func HashMerkleBranches(left *chainhash.Hash, right *chainhash.Hash) *chainhash.Hash

+ func HashMerkleRoot(merkles []*chainhash.Hash, target chainhash.Hash, pos int) chainhash.Hash

+ func HashToBig(hash *chainhash.Hash) *big.Int

+ func IsCoinBase(tx *btcutil.Tx) bool

+ func IsCoinBaseTx(msgTx *wire.MsgTx) bool

+ func IsFinalizedTransaction(tx *btcutil.Tx, blockHeight int32, blockTime time.Time) bool

+ func IsSupportedDbType(dbType string) bool

+ func IsUnspendable(o *wire.TxOut) bool

+ func LockTimeToSequence(isSeconds bool, locktime uint32) uint32

+ func OutpointKey(outpoint wire.OutPoint) *[]byte

+ func ProofSanity(ud *wire.UData, outPoints []wire.OutPoint) error

+ func RecycleOutpointKey(key *[]byte)

+ func SequenceLockActive(sequenceLock *SequenceLock, blockHeight int32, medianTimePast time.Time) bool

+ func SerializeUtreexoRoots(numLeaves uint64, roots []utreexo.Hash) ([]byte, error)

+ func ShouldHaveSerializedBlockHeight(header *wire.BlockHeader) bool

+ func SolveBlock(header *wire.BlockHeader) bool

+ func TxToDelLeaves(tx *btcutil.Tx, chain *BlockChain) ([]wire.LeafData, error)

+ func UseLogger(logger btclog.Logger)

+ func UtxoCacheInitialized(dbTx database.Tx) bool

+ func ValidateTransactionScripts(tx *btcutil.Tx, utxoView *UtxoViewpoint, flags txscript.ScriptFlags, ...) error

+ func ValidateWitnessCommitment(blk *btcutil.Block) error

+ type AssertError string

+ func (e AssertError) Error() string

+ type BehaviorFlags uint32

+ const BFFastAdd

+ const BFNoPoWCheck

+ const BFNone

+ type BestState struct

+ Bits uint32

+ BlockSize uint64

+ BlockWeight uint64

+ Hash chainhash.Hash

+ Height int32

+ MedianTime time.Time

+ NumTxns uint64

+ TotalTxns uint64

+ type BlockChain struct

+ func ChainSetup(dbName string, params *chaincfg.Params) (*BlockChain, func(), error)

+ func New(config *Config) (*BlockChain, error)

+ func (b *BlockChain) AssumeUtreexoHash() chainhash.Hash

+ func (b *BlockChain) AssumeUtreexoHeight() int32

+ func (b *BlockChain) BestSnapshot() *BestState

+ func (b *BlockChain) BlockByHash(hash *chainhash.Hash) (*btcutil.Block, error)

+ func (b *BlockChain) BlockByHeight(blockHeight int32) (*btcutil.Block, error)

+ func (b *BlockChain) BlockHashByHeight(blockHeight int32) (*chainhash.Hash, error)

+ func (b *BlockChain) BlockHeightByHash(hash *chainhash.Hash) (int32, error)

+ func (b *BlockChain) BlockLocatorFromHash(hash *chainhash.Hash) BlockLocator

+ func (b *BlockChain) CachedStateSize() uint64

+ func (b *BlockChain) CalcNextBlockVersion() (int32, error)

+ func (b *BlockChain) CalcNextRequiredDifficulty(timestamp time.Time) (uint32, error)

+ func (b *BlockChain) CalcSequenceLock(tx *btcutil.Tx, utxoView *UtxoViewpoint, mempool bool) (*SequenceLock, error)

+ func (b *BlockChain) ChainTips() []ChainTip

+ func (b *BlockChain) CheckConnectBlockTemplate(block *btcutil.Block) error

+ func (b *BlockChain) Checkpoints() []chaincfg.Checkpoint

+ func (b *BlockChain) FetchSpendJournal(targetBlock *btcutil.Block) ([]SpentTxOut, error)

+ func (b *BlockChain) FetchSpendJournalUnsafe(targetBlock *btcutil.Block) ([]SpentTxOut, error)

+ func (b *BlockChain) FetchUtreexoViewpoint(blockHash *chainhash.Hash) (*UtreexoViewpoint, error)

+ func (b *BlockChain) FetchUtxoEntry(outpoint wire.OutPoint) (*UtxoEntry, error)

+ func (b *BlockChain) FetchUtxoView(tx *btcutil.Tx) (*UtxoViewpoint, error)

+ func (b *BlockChain) FlushUtxoCache(mode FlushMode) error

+ func (b *BlockChain) GenerateUData(dels []wire.LeafData) (*wire.UData, error)

+ func (b *BlockChain) GenerateUDataPartial(dels []wire.LeafData, positions []uint64) (*wire.UData, error)

+ func (b *BlockChain) GetLeafHashPositions(leafHashes []utreexo.Hash) []uint64

+ func (b *BlockChain) GetNeededPositions(packedPositions []chainhash.Hash) []chainhash.Hash

+ func (b *BlockChain) GetOrphanRoot(hash *chainhash.Hash) *chainhash.Hash

+ func (b *BlockChain) GetUtreexoView() *UtreexoViewpoint

+ func (b *BlockChain) HasCheckpoints() bool

+ func (b *BlockChain) HaveBlock(hash *chainhash.Hash) (bool, error)

+ func (b *BlockChain) HeaderByHash(hash *chainhash.Hash) (wire.BlockHeader, error)

+ func (b *BlockChain) HeightRange(startHeight, endHeight int32) ([]chainhash.Hash, error)

+ func (b *BlockChain) HeightToHashRange(startHeight int32, endHash *chainhash.Hash, maxResults int) ([]chainhash.Hash, error)

+ func (b *BlockChain) IndexLookupNode(hash *chainhash.Hash) *blockNode

+ func (b *BlockChain) IndexNodeStatus(node *blockNode) blockStatus

+ func (b *BlockChain) InitConsistentState(tip *blockNode, interrupt <-chan struct{}) error

+ func (b *BlockChain) IntervalBlockHashes(endHash *chainhash.Hash, interval int) ([]chainhash.Hash, error)

+ func (b *BlockChain) InvalidateBlock(hash *chainhash.Hash) error

+ func (b *BlockChain) IsAssumeUtreexo() bool

+ func (b *BlockChain) IsCheckpointCandidate(block *btcutil.Block) (bool, error)

+ func (b *BlockChain) IsCurrent() bool

+ func (b *BlockChain) IsDeploymentActive(deploymentID uint32) (bool, error)

+ func (b *BlockChain) IsKnownOrphan(hash *chainhash.Hash) bool

+ func (b *BlockChain) IsUtreexoViewActive() bool

+ func (b *BlockChain) LatestBlockLocator() (BlockLocator, error)

+ func (b *BlockChain) LatestCheckpoint() *chaincfg.Checkpoint

+ func (b *BlockChain) LocateBlocks(locator BlockLocator, hashStop *chainhash.Hash, maxHashes uint32) []chainhash.Hash

+ func (b *BlockChain) LocateHeaders(locator BlockLocator, hashStop *chainhash.Hash) []wire.BlockHeader

+ func (b *BlockChain) MainChainHasBlock(hash *chainhash.Hash) bool

+ func (b *BlockChain) PackedPositions(leafHashes []utreexo.Hash) []chainhash.Hash

+ func (b *BlockChain) PastMedianTime(blockHeader *wire.BlockHeader) (time.Time, error)

+ func (b *BlockChain) ProcessBlock(block *btcutil.Block, flags BehaviorFlags) (bool, bool, error)

+ func (b *BlockChain) ProcessBlockHeader(header *wire.BlockHeader) error

+ func (b *BlockChain) PruneFromAccumulator(leaves []wire.LeafData) error

+ func (b *BlockChain) ReconsiderBlock(hash *chainhash.Hash) error

+ func (b *BlockChain) ReconstructUData(ud *wire.UData, blockHash chainhash.Hash) ([]utreexo.Hash, error)

+ func (b *BlockChain) SetNewBestStateFromAssumedUtreexoPoint()

+ func (b *BlockChain) SetUtreexoStateFromAssumePoint()

+ func (b *BlockChain) Subscribe(callback NotificationCallback)

+ func (b *BlockChain) ThresholdState(deploymentID uint32) (ThresholdState, error)

+ func (b *BlockChain) TstSetCoinbaseMaturity(maturity uint16)

+ func (b *BlockChain) VerifyUData(ud *wire.UData, txIns []*wire.TxIn, remember bool) error

+ type BlockLocator []*chainhash.Hash

+ type ChainTip struct

+ BlockHash chainhash.Hash

+ BranchLen int32

+ Height int32

+ Status TipStatus

+ type ChainTipProof struct

+ AccProof *utreexo.Proof

+ HashesProven []utreexo.Hash

+ ProvedAtHash *chainhash.Hash

+ func (ctp *ChainTipProof) DecodeString(proof string) error

+ func (ctp *ChainTipProof) Deserialize(r io.Reader) error

+ func (ctp *ChainTipProof) Serialize(w io.Writer) error

+ func (ctp *ChainTipProof) String() string

+ type Config struct

+ AssumeUtreexoPoint chaincfg.AssumeUtreexo

+ ChainParams *chaincfg.Params

+ Checkpoints []chaincfg.Checkpoint

+ DB database.DB

+ HashCache *txscript.HashCache

+ IndexManager IndexManager

+ Interrupt <-chan struct{}

+ Prune uint64

+ SigCache *txscript.SigCache

+ TimeSource MedianTimeSource

+ UtreexoView *UtreexoViewpoint

+ UtxoCacheMaxSize uint64

+ type DeploymentError uint32

+ func (e DeploymentError) Error() string

+ type ErrorCode int

+ const ErrBadCheckpoint

+ const ErrBadCoinbaseHeight

+ const ErrBadCoinbaseScriptLen

+ const ErrBadCoinbaseValue

+ const ErrBadFees

+ const ErrBadMerkleRoot

+ const ErrBadTxInput

+ const ErrBadTxOutValue

+ const ErrBlockTooBig

+ const ErrBlockVersionTooOld

+ const ErrBlockWeightTooHigh

+ const ErrCheckpointTimeTooOld

+ const ErrDifficultyTooLow

+ const ErrDuplicateBlock

+ const ErrDuplicateTx

+ const ErrDuplicateTxInputs

+ const ErrFirstTxNotCoinbase

+ const ErrForkTooOld

+ const ErrHighHash

+ const ErrImmatureSpend

+ const ErrInvalidAncestorBlock

+ const ErrInvalidTime

+ const ErrInvalidWitnessCommitment

+ const ErrKnownInvalidBlock

+ const ErrMissingCoinbaseHeight

+ const ErrMissingParent

+ const ErrMissingTxOut

+ const ErrMultipleCoinbases

+ const ErrNoTransactions

+ const ErrNoTxInputs

+ const ErrNoTxOutputs

+ const ErrOverwriteTx

+ const ErrPrevBlockNotBest

+ const ErrPreviousBlockUnknown

+ const ErrScriptMalformed

+ const ErrScriptValidation

+ const ErrSpendTooHigh

+ const ErrTimeTooNew

+ const ErrTimeTooOld

+ const ErrTooManySigOps

+ const ErrTxTooBig

+ const ErrUnexpectedDifficulty

+ const ErrUnexpectedWitness

+ const ErrUnfinalizedTx

+ const ErrWitnessCommitmentMismatch

+ func (e ErrorCode) String() string

+ type ExcludedUtxo struct

+ Height int32

+ Outpoint wire.OutPoint

+ func BlockToDelLeaves(stxos []SpentTxOut, chain *BlockChain, block *btcutil.Block, inskip []uint32, ...) (delLeaves []wire.LeafData, excluded []ExcludedUtxo, err error)

+ type FlushMode uint8

+ const FlushIfNeeded

+ const FlushPeriodic

+ const FlushRequired

+ type IndexManager interface

+ ConnectBlock func(database.Tx, *btcutil.Block, []SpentTxOut) error

+ DisconnectBlock func(database.Tx, *btcutil.Block, []SpentTxOut) error

+ Init func(*BlockChain, <-chan struct{}) error

+ PruneBlocks func(database.Tx, int32, func(int32) (*chainhash.Hash, error)) error

+ type MedianTimeSource interface

+ AddTimeSample func(id string, timeVal time.Time)

+ AdjustedTime func() time.Time

+ Offset func() time.Duration

+ func NewMedianTime() MedianTimeSource

+ type Notification struct

+ Data interface{}

+ Type NotificationType

+ type NotificationCallback func(*Notification)

+ type NotificationType int

+ const NTBlockAccepted

+ const NTBlockConnected

+ const NTBlockDisconnected

+ func (n NotificationType) String() string

+ type RuleError struct

+ Description string

+ ErrorCode ErrorCode

+ func (e RuleError) Error() string

+ type SequenceLock struct

+ BlockHeight int32

+ Seconds int64

+ type SpendableOut struct

+ Amount btcutil.Amount

+ PrevOut wire.OutPoint

+ func AddBlock(chain *BlockChain, prev *btcutil.Block, spends []*SpendableOut) (*btcutil.Block, []*SpendableOut, error)

+ func MakeSpendableOutForTx(tx *wire.MsgTx, txOutIndex uint32) SpendableOut

+ func NewBlock(chain *BlockChain, prev *btcutil.Block, spends []*SpendableOut) (*btcutil.Block, []*SpendableOut)

+ type SpentTxOut struct

+ Amount int64

+ Height int32

+ IsCoinBase bool

+ PkScript []byte

+ type ThresholdState byte

+ const ThresholdActive

+ const ThresholdDefined

+ const ThresholdFailed

+ const ThresholdLockedIn

+ const ThresholdStarted

+ func (t ThresholdState) String() string

+ type TipStatus byte

+ const StatusActive

+ const StatusInvalid

+ const StatusUnknown

+ const StatusValidFork

+ func (ts TipStatus) String() string

+ type UtreexoViewpoint struct

+ func NewUtreexoViewpoint() *UtreexoViewpoint

+ func (uview *UtreexoViewpoint) AddProof(delHashes []utreexo.Hash, accProof *utreexo.Proof) error

+ func (uview *UtreexoViewpoint) CopyWithRoots() *UtreexoViewpoint

+ func (uview *UtreexoViewpoint) Equal(compRoots []*chainhash.Hash) bool

+ func (uview *UtreexoViewpoint) GetProofInterval() int32

+ func (uview *UtreexoViewpoint) GetRoots() []*chainhash.Hash

+ func (uview *UtreexoViewpoint) Modify(ud *wire.UData, adds []utreexo.Leaf, dels []utreexo.Hash) (*utreexo.UpdateData, error)

+ func (uview *UtreexoViewpoint) NumLeaves() uint64

+ func (uview *UtreexoViewpoint) ProcessUData(block *btcutil.Block, bestChain *chainView, ud *wire.UData) error

+ func (uview *UtreexoViewpoint) PruneAll()

+ func (uview *UtreexoViewpoint) SetProofInterval(proofInterval int32)

+ func (uview *UtreexoViewpoint) ToString() string

+ func (uview *UtreexoViewpoint) VerifyAccProof(toProve []utreexo.Hash, proof *utreexo.Proof) error

+ type UtxoEntry struct

+ func NewUtxoEntry(txOut *wire.TxOut, blockHeight int32, isCoinbase bool) *UtxoEntry

+ func (entry *UtxoEntry) Amount() int64

+ func (entry *UtxoEntry) BlockHeight() int32

+ func (entry *UtxoEntry) Clone() *UtxoEntry

+ func (entry *UtxoEntry) IsCoinBase() bool

+ func (entry *UtxoEntry) IsSpent() bool

+ func (entry *UtxoEntry) PkScript() []byte

+ func (entry *UtxoEntry) Spend()

+ type UtxoViewpoint struct

+ func NewUtxoViewpoint() *UtxoViewpoint

+ func (view *UtxoViewpoint) AddTxOut(tx *btcutil.Tx, txOutIdx uint32, blockHeight int32)

+ func (view *UtxoViewpoint) AddTxOuts(tx *btcutil.Tx, blockHeight int32)

+ func (view *UtxoViewpoint) BestHash() *chainhash.Hash

+ func (view *UtxoViewpoint) BlockToUtxoView(block *btcutil.Block) error

+ func (view *UtxoViewpoint) Entries() map[wire.OutPoint]*UtxoEntry

+ func (view *UtxoViewpoint) FetchPrevOutput(op wire.OutPoint) *wire.TxOut

+ func (view *UtxoViewpoint) LookupEntry(outpoint wire.OutPoint) *UtxoEntry

+ func (view *UtxoViewpoint) RemoveEntry(outpoint wire.OutPoint)

+ func (view *UtxoViewpoint) SetBestHash(hash *chainhash.Hash)