mirror of
https://gitlab.com/pulsechaincom/prysm-pulse.git
synced 2025-01-15 14:38:20 +00:00
963acefe12
Co-authored-by: Raul Jordan <raul@prysmaticlabs.com> Co-authored-by: prylabs-bulldozer[bot] <58059840+prylabs-bulldozer[bot]@users.noreply.github.com> Co-authored-by: terence tsao <terence@prysmaticlabs.com> Co-authored-by: Kasey Kirkham <kasey@users.noreply.github.com> Co-authored-by: Preston Van Loon <preston@prysmaticlabs.com> Co-authored-by: kasey <489222+kasey@users.noreply.github.com> Co-authored-by: Dan Loewenherz <dloewenherz.adm@gmail.com> Co-authored-by: prestonvanloon <preston@prysmaticlabs.com> Co-authored-by: Fredrik Svantes <fredrik@ethereum.org> Co-authored-by: Leo Lara <leolara@users.noreply.github.com>
41 lines
1.4 KiB
Go
41 lines
1.4 KiB
Go
// Package v1 defines how the beacon chain state for Ethereum
|
|
// functions in the running beacon node, using an advanced,
|
|
// immutable implementation of the state data structure.
|
|
//
|
|
// BeaconState getters may be accessed from inside or outside the package. To
|
|
// avoid duplicating locks, we have internal and external versions of the
|
|
// getter The external function carries out the short-circuit conditions,
|
|
// obtains a read lock, then calls the internal function. The internal function
|
|
// carries out the short-circuit conditions and returns the required data
|
|
// without further locking, allowing it to be used by other package-level
|
|
// functions that already hold a lock. Hence the functions look something
|
|
// like this:
|
|
//
|
|
// func (b *BeaconState) Foo() uint64 {
|
|
// // Short-circuit conditions.
|
|
// if !b.hasInnerState() {
|
|
// return 0
|
|
// }
|
|
//
|
|
// // Read lock.
|
|
// b.lock.RLock()
|
|
// defer b.lock.RUnlock()
|
|
//
|
|
// // Internal getter.
|
|
// return b.foo()
|
|
// }
|
|
//
|
|
// func (b *BeaconState) foo() uint64 {
|
|
// // Short-circuit conditions.
|
|
// if !b.hasInnerState() {
|
|
// return 0
|
|
// }
|
|
//
|
|
// return b.state.foo
|
|
// }
|
|
//
|
|
// Although it is technically possible to remove the short-circuit conditions
|
|
// from the external function, that would require every read to obtain a lock
|
|
// even if the data was not present, leading to potential slowdowns.
|
|
package v1
|