build

Documentation

Index

• Constants
• Variables
• func BlocksTopic(netName dtypes.NetworkName) string
• func BuildTypeString() string
• func BuiltinBootstrap() ([]peer.AddrInfo, error)
• func DhtProtocolName(netName dtypes.NetworkName) protocol.ID
• func DrandConfigSchedule() dtypes.DrandSchedule
• func GeneratePanicReport(persistPath, repoPath, label string)
• func IndexerIngestTopic(netName dtypes.NetworkName) string
• func IsNearUpgrade(epoch, upgradeEpoch abi.ChainEpoch) bool
• func MaybeGenesis() []byte
• func MessagesTopic(netName dtypes.NetworkName) string
• func MustParseAddress(addr string) address.Address
• func MustParseCid(c string) cid.Cid
• func OpenRPCDiscoverJSON_Full() apitypes.OpenRPCDocument
• func OpenRPCDiscoverJSON_Miner() apitypes.OpenRPCDocument
• func OpenRPCDiscoverJSON_Worker() apitypes.OpenRPCDocument
• func ParametersJSON() []byte
• func SetAddressNetwork(n address.Network)
• func SrsJSON() []byte
• func UserVersion() string
• type DrandEnum

Constants

const (
	BuildDefault      = 0
	BuildMainnet      = 0x1
	Build2k           = 0x2
	BuildDebug        = 0x3
	BuildCalibnet     = 0x4
	BuildInteropnet   = 0x5
	BuildButterflynet = 0x7
)

const AddressMainnetEnvVar = "_mainnet_"

const AllowableClockDriftSecs = uint64(1)

const BadBlockCacheSize = 1 << 15

Sync

const BaseFeeMaxChangeDenom = 8 // 12.5%

const BlockDelaySecs = uint64(builtin2.EpochDurationSeconds)

const BlockGasLimit = 10_000_000_000

const BlockGasTarget = BlockGasLimit / 2

const BlockMessageLimit = 10000

TODO: If this is gonna stay, it should move to specs-actors

const BlsSignatureCacheSize = 40000

assuming 4000 messages per round, this lets us not lose any messages across a 10 block reorg.

const BootstrapPeerThreshold = 4

BootstrapPeerThreshold is the minimum number peers we need to track for a sync worker to start

const BootstrappersFile = "mainnet.pi"

const BreezeGasTampingDuration = 120

const BuildVersion = "1.15.1-rc6"

BuildVersion is the local build version

const FilAllocStorageMining = uint64(1_100_000_000)

const FilBase = uint64(2_000_000_000)

const FilReserved = uint64(300_000_000)

const FilecoinPrecision = uint64(1_000_000_000_000_000_000)

const Finality = policy.ChainFinality

Epochs

const ForkLengthThreshold = Finality

Epochs

const GenesisFile = "mainnet.car"

const GenesisNetworkVersion = network.Version0

const InitialBaseFee = 100e6

const MessageConfidence = uint64(5)

const MinimumBaseFee = 100

const NewestNetworkVersion = network.Version15

const PackingEfficiencyDenom = 5

const PackingEfficiencyNum = 4

const PropagationDelaySecs = uint64(6)

const SealRandomnessLookback = policy.SealRandomnessLookback

Epochs TODO: unused

const TicketRandomnessLookback = abi.ChainEpoch(1)

Epochs

const UnixfsChunkSize uint64 = 1 << 20

const UnixfsLinksPerLevel = 1024

const UpgradeAssemblyHeight = 138720

const UpgradeBreezeHeight = 41280

const UpgradeCalicoHeight = 265200

const UpgradeChocolateHeight = 1231620

2021-10-26T13:30:00Z

const UpgradeHyperdriveHeight = 892800

2021-06-30T22:00:00Z

const UpgradeIgnitionHeight = 94000

const UpgradeKumquatHeight = 170000

const UpgradeLiftoffHeight = 148888

This signals our tentative epoch for mainnet launch. Can make it later, but not earlier. Miners, clients, developers, custodians all need time to prepare. We still have upgrades and state changes to do, but can happen after signaling timing here.

const UpgradeNorwegianHeight = 665280

2021-04-12T22:00:00Z

const UpgradeOrangeHeight = 336458

const UpgradePersianHeight = UpgradeCalicoHeight + (builtin2.EpochsInHour * 60)

const UpgradeRefuelHeight = 130800

const UpgradeSmokeHeight = 51000

const UpgradeTapeHeight = 140760

const UpgradeTrustHeight = 550321

2021-03-04T00:00:30Z

const UpgradeTurboHeight = 712320

2021-04-29T06:00:00Z

const VerifSigCacheSize = 32000

Size of signature verification cache 32k keeps the cache around 10MB in size, max

const WRatioDen = uint64(2)

const WRatioNum = int64(1)

constants for Weight calculation The ratio of weight contributed by short-term vs long-term factors in a given round

Variables

var (
	DefaultFDLimit uint64 = 16 << 10
	MinerFDLimit   uint64 = 100_000
)

var BlocksPerEpoch = uint64(builtin2.ExpectedLeadersPerEpoch)

Blocks (e)

var BuildType int

var Clock = clock.New()

Clock is the global clock for the system. In standard builds, we use a real-time clock, which maps to the `time` package.

Tests that need control of time can replace this variable with clock.NewMock(). Always use real time for socket/stream deadlines.

var CurrentCommit string

var Devnet = true

var DisableBuiltinAssets = false

DisableBuiltinAssets disables the resolution of go.rice boxes that store built-in assets, such as proof parameters, bootstrap peers, genesis blocks, etc.

When this value is set to true, it is expected that the user will provide any such configurations through the Lotus API itself.

This is useful when you're using Lotus as a library, such as to orchestrate test scenarios, or for other purposes where you don't need to use the defaults shipped with the binary.

For this flag to be effective, it must be enabled _before_ instantiating Lotus.

var DrandConfigs = map[DrandEnum]dtypes.DrandConfig{
	DrandMainnet: {
		Servers: []string{
			"https://api.drand.sh",
			"https://api2.drand.sh",
			"https://api3.drand.sh",
			"https://drand.cloudflare.com",
		},
		Relays: []string{
			"/dnsaddr/api.drand.sh/",
			"/dnsaddr/api2.drand.sh/",
			"/dnsaddr/api3.drand.sh/",
		},
		ChainInfoJSON: `{"public_key":"868f005eb8e6e4ca0a47c8a77ceaa5309a47978a7c71bc5cce96366b5d7a569937c529eeda66c7293784a9402801af31","period":30,"genesis_time":1595431050,"hash":"8990e7a9aaed2ffed73dbd7092123d6f289930540d7651336225dc172e51b2ce","groupHash":"176f93498eac9ca337150b46d21dd58673ea4e3581185f869672e59fa4cb390a"}`,
	},
	DrandTestnet: {
		Servers: []string{
			"https://pl-eu.testnet.drand.sh",
			"https://pl-us.testnet.drand.sh",
			"https://pl-sin.testnet.drand.sh",
		},
		Relays: []string{
			"/dnsaddr/pl-eu.testnet.drand.sh/",
			"/dnsaddr/pl-us.testnet.drand.sh/",
			"/dnsaddr/pl-sin.testnet.drand.sh/",
		},
		ChainInfoJSON: `{"public_key":"922a2e93828ff83345bae533f5172669a26c02dc76d6bf59c80892e12ab1455c229211886f35bb56af6d5bea981024df","period":25,"genesis_time":1590445175,"hash":"84b2234fb34e835dccd048255d7ad3194b81af7d978c3bf157e3469592ae4e02","groupHash":"4dd408e5fdff9323c76a9b6f087ba8fdc5a6da907bd9217d9d10f2287d081957"}`,
	},
	DrandDevnet: {
		Servers: []string{
			"https://dev1.drand.sh",
			"https://dev2.drand.sh",
		},
		Relays: []string{
			"/dnsaddr/dev1.drand.sh/",
			"/dnsaddr/dev2.drand.sh/",
		},
		ChainInfoJSON: `{"public_key":"8cda589f88914aa728fd183f383980b35789ce81b274e5daee1f338b77d02566ef4d3fb0098af1f844f10f9c803c1827","period":25,"genesis_time":1595348225,"hash":"e73b7dc3c4f6a236378220c0dd6aa110eb16eed26c11259606e07ee122838d4f","groupHash":"567d4785122a5a3e75a9bc9911d7ea807dd85ff76b78dc4ff06b075712898607"}`,
	},
	DrandIncentinet: {
		ChainInfoJSON: `{"public_key":"8cad0c72c606ab27d36ee06de1d5b2db1faf92e447025ca37575ab3a8aac2eaae83192f846fc9e158bc738423753d000","period":30,"genesis_time":1595873820,"hash":"80c8b872c714f4c00fdd3daa465d5514049f457f01f85a4caf68cdcd394ba039","groupHash":"d9406aaed487f7af71851b4399448e311f2328923d454e971536c05398ce2d9b"}`,
	},
}

var DrandSchedule = map[abi.ChainEpoch]DrandEnum{
	0:                  DrandIncentinet,
	UpgradeSmokeHeight: DrandMainnet,
}

var InitialFilReserved *big.Int

var InitialRewardBalance *big.Int

var InsecurePoStValidation = false

var MinDealDuration, MaxDealDuration = policy.DealDurationBounds(0)

Actor consts TODO: pieceSize unused from actors

var PanicReportJournalTail = defaultJournalTail

PanicReportJournalTail is the number of lines captured from the end of the lotus journal to be included in the panic report.

var PanicReportingPath = "panic-reports"

PanicReportingPath is the name of the subdir created within the repoPath path provided to GeneratePanicReport

var UpgradeClausHeight = abi.ChainEpoch(343200)

2020-12-22T02:00:00Z

var UpgradeOhSnapHeight = abi.ChainEpoch(1594680)

2022-03-01T15:00:00Z

var WhitelistedBlock = MustParseCid("bafy2bzaceapyg2uyzk7vueh3xccxkuwbz3nxewjyguoxvhx77malc2lzn2ybi")

we skip checks on message validity in this block to sidestep the zero-bls signature

var ZeroAddress = MustParseAddress("f3yaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaby2smx7a")

the 'f' prefix doesn't matter

Functions

func BlocksTopic

func BlocksTopic(netName dtypes.NetworkName) string

func BuildTypeString

func BuildTypeString() string

func BuiltinBootstrap

func BuiltinBootstrap() ([]peer.AddrInfo, error)

func DhtProtocolName

func DhtProtocolName(netName dtypes.NetworkName) protocol.ID

func DrandConfigSchedule

func DrandConfigSchedule() dtypes.DrandSchedule

func GeneratePanicReport

func GeneratePanicReport(persistPath, repoPath, label string)

GeneratePanicReport produces a timestamped dump of the application state for inspection and debugging purposes. Call this function from any place where a panic or severe error needs to be examined. `persistPath` is the path where the reports should be saved. `repoPath` is the path where the journal should be read from. `label` is an optional string to include next to the report timestamp.

func IndexerIngestTopic

func IndexerIngestTopic(netName dtypes.NetworkName) string

func IsNearUpgrade

func IsNearUpgrade(epoch, upgradeEpoch abi.ChainEpoch) bool

func MaybeGenesis

func MaybeGenesis() []byte

func MessagesTopic

func MessagesTopic(netName dtypes.NetworkName) string

func MustParseAddress

func MustParseAddress(addr string) address.Address

func MustParseCid

func MustParseCid(c string) cid.Cid

func OpenRPCDiscoverJSON_Full

func OpenRPCDiscoverJSON_Full() apitypes.OpenRPCDocument

func OpenRPCDiscoverJSON_Miner

func OpenRPCDiscoverJSON_Miner() apitypes.OpenRPCDocument

func OpenRPCDiscoverJSON_Worker

func OpenRPCDiscoverJSON_Worker() apitypes.OpenRPCDocument

func ParametersJSON

func ParametersJSON() []byte

func SetAddressNetwork

func SetAddressNetwork(n address.Network)

func SrsJSON

func SrsJSON() []byte

func UserVersion

func UserVersion() string

Types

type DrandEnum

type DrandEnum int

const (
	DrandMainnet DrandEnum = iota + 1
	DrandTestnet
	DrandDevnet
	DrandLocalnet
	DrandIncentinet
)