kit

package
v1.36.1 Latest Latest
Warning

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

 Go to latest Published: Jun 30, 2026 License: Apache-2.0, MIT Imports: 124 Imported by: 4

Documentation

Index

Constants

View Source 
const (
	TestDealStateFailed     = TestDealState(-1)
	TestDealStateInProgress = TestDealState(0)
	TestDealStateComplete   = TestDealState(1)
)
View Source 
const DefaultPresealsPerBootstrapMiner = 2

DefaultPresealsPerBootstrapMiner is the number of preseals that every bootstrap miner has by default. It can be overridden through the PresealSectors option.

View Source 
const EnvRunExpensiveTests = "LOTUS_RUN_EXPENSIVE_TESTS"

EnvRunExpensiveTests is the environment variable that needs to be present and set to value "1" to enable running expensive tests outside of CI.

View Source 
const EnvRunVeryExpensiveTests = "LOTUS_RUN_VERY_EXPENSIVE_TESTS"

EnvRunVeryExpensiveTests is the environment variable that needs to be present and set to value "1" to enable running very expensive tests outside of CI. A "very expensive" test is one that is expected to take too long to run in a standard CI setup, and should be skipped unless explicitly enabled.

View Source 
const TestSpt = abi.RegisteredSealProof_StackedDrg2KiBV1_1
View Source 
const TestSptNi = abi.RegisteredSealProof_StackedDrg2KiBV1_2_Feat_NiPoRep

Variables

View Source 
var (
	BogusPieceCid1 = cid.MustParse("baga6ea4seaqjtovkwk4myyzj56eztkh5pzsk5upksan6f5outesy62bsvl4dsha")
	BogusPieceCid2 = cid.MustParse("baga6ea4seaqlhznlutptgfwhffupyer6txswamerq5fc2jlwf2lys2mm5jtiaeq")
)

TODO: make a randomiser for this

View Source 
var DefaultEnsembleOpts = ensembleOpts{
	// contains filtered or unexported fields
}
View Source 
var DefaultNodeOpts = nodeOpts{
	// contains filtered or unexported fields
}

DefaultNodeOpts are the default options that will be applied to test nodes.

View Source 
var EventMatrixContract = SolidityContractDef{
	Filename: "contracts/EventMatrix.hex",
	Fn: map[string][]byte{
		"logEventZeroData":             EthFunctionHash("logEventZeroData()"),
		"logEventOneData":              EthFunctionHash("logEventOneData(uint256)"),
		"logEventTwoData":              EthFunctionHash("logEventTwoData(uint256,uint256)"),
		"logEventThreeData":            EthFunctionHash("logEventThreeData(uint256,uint256,uint256)"),
		"logEventFourData":             EthFunctionHash("logEventFourData(uint256,uint256,uint256,uint256)"),
		"logEventOneIndexed":           EthFunctionHash("logEventOneIndexed(uint256)"),
		"logEventTwoIndexed":           EthFunctionHash("logEventTwoIndexed(uint256,uint256)"),
		"logEventThreeIndexed":         EthFunctionHash("logEventThreeIndexed(uint256,uint256,uint256)"),
		"logEventOneIndexedWithData":   EthFunctionHash("logEventOneIndexedWithData(uint256,uint256)"),
		"logEventTwoIndexedWithData":   EthFunctionHash("logEventTwoIndexedWithData(uint256,uint256,uint256)"),
		"logEventThreeIndexedWithData": EthFunctionHash("logEventThreeIndexedWithData(uint256,uint256,uint256,uint256)"),
	},
	Ev: map[string]ethtypes.EthHash{
		"EventZeroData":             EthTopicHash("EventZeroData()"),
		"EventOneData":              EthTopicHash("EventOneData(uint256)"),
		"EventTwoData":              EthTopicHash("EventTwoData(uint256,uint256)"),
		"EventThreeData":            EthTopicHash("EventThreeData(uint256,uint256,uint256)"),
		"EventFourData":             EthTopicHash("EventFourData(uint256,uint256,uint256,uint256)"),
		"EventOneIndexed":           EthTopicHash("EventOneIndexed(uint256)"),
		"EventTwoIndexed":           EthTopicHash("EventTwoIndexed(uint256,uint256)"),
		"EventThreeIndexed":         EthTopicHash("EventThreeIndexed(uint256,uint256,uint256)"),
		"EventOneIndexedWithData":   EthTopicHash("EventOneIndexedWithData(uint256,uint256)"),
		"EventTwoIndexedWithData":   EthTopicHash("EventTwoIndexedWithData(uint256,uint256,uint256)"),
		"EventThreeIndexedWithData": EthTopicHash("EventThreeIndexedWithData(uint256,uint256,uint256,uint256)"),
	},
}
View Source 
var EventsContract = SolidityContractDef{
	Filename: "contracts/events.bin",
	Fn: map[string][]byte{
		"log_zero_data":   {0x00, 0x00, 0x00, 0x00},
		"log_zero_nodata": {0x00, 0x00, 0x00, 0x01},
		"log_four_data":   {0x00, 0x00, 0x00, 0x02},
	},
	Ev: map[string]ethtypes.EthHash{},
}
View Source 
var WithSealWorkerTasks = WithTaskTypes(append([]sealtasks.TaskType{sealtasks.TTAddPiece, sealtasks.TTDataCid, sealtasks.TTPreCommit1, sealtasks.TTPreCommit2, sealtasks.TTCommit2, sealtasks.TTUnseal}, DefaultNodeOpts.workerTasks...))

Functions

func AssertFilesEqual 

func AssertFilesEqual(t *testing.T, left, right string)

AssertFilesEqual compares two files by blake2b hash equality and fails the test if unequal.

func CalcFuncSignature added in v1.20.0 

func CalcFuncSignature(funcName string) []byte

CalcFuncSignature returns the first 4 bytes of the hash of the function name and types

func CreateRandomFile 

func CreateRandomFile(t *testing.T, rseed, size int) (path string)

CreateRandomFile creates a random file with the provided seed and the provided size.

func CurrentDeadlineIndex added in v1.29.0 

func CurrentDeadlineIndex(di *dline.Info) uint64

CurrentDeadlineIndex manually calculates the current deadline index. This may be useful in situations where the miner hasn't been enrolled in cron and the deadline index isn't ticking so dline.Info.Index may not be accurate.

func EnsembleMinimal 

func EnsembleMinimal(t *testing.T, opts ...interface{}) (*TestFullNode, *TestMiner, *Ensemble)

EnsembleMinimal creates and starts an Ensemble with a single full node and a single miner. It does not interconnect nodes nor does it begin mining.

This function supports passing both ensemble and node functional options. Functional options are applied to all nodes.

func EnsembleOneTwo 

func EnsembleOneTwo(t *testing.T, opts ...interface{}) (*TestFullNode, *TestMiner, *TestMiner, *Ensemble)

EnsembleOneTwo creates and starts an Ensemble with one full node and two miners. It does not interconnect nodes nor does it begin mining.

This function supports passing both ensemble and node functional options. Functional options are applied to all nodes.

func EnsembleTwoOne 

func EnsembleTwoOne(t *testing.T, opts ...interface{}) (*TestFullNode, *TestFullNode, *TestMiner, *Ensemble)

EnsembleTwoOne creates and starts an Ensemble with two full nodes and one miner. It does not interconnect nodes nor does it begin mining.

This function supports passing both ensemble and node functional options. Functional options are applied to all nodes.

func EnsembleWorker added in v1.15.2 

func EnsembleWorker(t *testing.T, opts ...interface{}) (*TestFullNode, *TestMiner, *TestWorker, *Ensemble)

func EthFunctionHash added in v1.20.0 

func EthFunctionHash(sig string) []byte

func EthTopicHash added in v1.20.0 

func EthTopicHash(sig string) ethtypes.EthHash

func EvmDecodeUint64 added in v1.36.0 

func EvmDecodeUint64(output []byte) (uint64, error)

EvmDecodeUint64 interprets the low 8 bytes of an EVM word as a big-endian uint64. Returns an error if output is shorter than 8 bytes.

func EvmWordBytes added in v1.36.0 

func EvmWordBytes(input []byte) []byte

EvmWordBytes right-aligns input into a 32-byte big-endian EVM word. Panics if input is longer than 32 bytes.

func EvmWordFromAddr added in v1.36.0 

func EvmWordFromAddr(ctx context.Context, t *testing.T, client *TestFullNode, from address.Address) []byte

EvmWordFromAddr resolves a Filecoin address to its corresponding Ethereum address and returns it as a 32-byte big-endian EVM word.

func EvmWordUint64 added in v1.36.0 

func EvmWordUint64(n uint64) []byte

EvmWordUint64 encodes n as a 32-byte big-endian EVM word.

func Expensive 

func Expensive(t *testing.T)

Expensive marks a test as expensive, skipping it immediately if not running in a CI environment or if the LOTUS_RUN_EXPENSIVE_TESTS environment variable is not set to "1".

func MakeStableExecute added in v1.34.0 

func MakeStableExecute(ctx context.Context, t *testing.T, getTipSet func(t *testing.T) *types.TipSet) func(fn func()) *types.TipSet

MakeStableExecute is a helper that will execute a function required by a test case repeatedly until the tipset observed before is the same as after execution of the function. This helps reduce flakies that come from reorgs between capturing the tipset and executing the function. Unfortunately it doesn't remove the problem entirely as we could have multiple reorgs off the tipset we observe and then back to it, but it should be extremely rare.

func QuietAllLogsExcept added in v1.20.0 

func QuietAllLogsExcept(names ...string)

func QuietMiningLogs 

func QuietMiningLogs()

func SendFunds 

func SendFunds(ctx context.Context, t *testing.T, sender *TestFullNode, recipient address.Address, amount abi.TokenAmount)

SendFunds sends funds from the default wallet of the specified sender node to the recipient address.

func SetupAllocation added in v1.32.0 

func SetupAllocation(
	ctx context.Context,
	t *testing.T,
	node api.FullNode,
	minerId uint64,
	dc abi.PieceInfo,
	verifiedClientAddr address.Address,
	expiration abi.ChainEpoch,
	termMax abi.ChainEpoch,
) (clientID abi.ActorID, allocationID verifregtypes13.AllocationId)

func SetupVerifiedClients added in v1.32.0 

func SetupVerifiedClients(ctx context.Context, t *testing.T, client *TestFullNode, rootKey *key.Key, verifierKey *key.Key, verifiedClientKeys []*key.Key) (verifierAddr address.Address, ret []address.Address)

SetupVerifiedClients assumes that rootKey has been set in the ensemble's genesis and that verifierKey and verifiedClientKeys exist as accounts. It first sets up the verifier with datacap to allocate, and then allocates datacap to each of the verified clients. It returns the address of the verifier and the addresses of the verified clients.

func VeryExpensive added in v1.28.0 

func VeryExpensive(t *testing.T)

VeryExpensive marks a test as VERY expensive, skipping it immediately if the LOTUS_RUN_VERY_EXPENSIVE_TESTS environment variable is not set to "1".

Types

type BlockMiner 

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

BlockMiner is a utility that makes a test miner Mine blocks on a timer.

func NewBlockMiner 

func NewBlockMiner(t *testing.T, miner *TestMiner) *BlockMiner

func (*BlockMiner) InjectNulls 

func (bm *BlockMiner) InjectNulls(rounds abi.ChainEpoch)

InjectNulls injects the specified amount of null rounds in the next mining rounds.

func (*BlockMiner) MineBlocks 

func (bm *BlockMiner) MineBlocks(ctx context.Context, blocktime time.Duration)

func (*BlockMiner) MineBlocksMustPost added in v1.14.0 

func (bm *BlockMiner) MineBlocksMustPost(ctx context.Context, blocktime time.Duration)

MineBlocksMustPost is like MineBlocks but refuses to mine until the window post scheduler has wdpost messages in the mempool and everything shuts down if a post fails. It also enforces that every block mined succeeds

func (*BlockMiner) MineUntilBlock 

func (bm *BlockMiner) MineUntilBlock(ctx context.Context, fn *TestFullNode, cb func(abi.ChainEpoch))

func (*BlockMiner) Pause added in v1.17.1 

func (bm *BlockMiner) Pause()

Pause compels the miner to wait for a signal to restart

func (*BlockMiner) Restart added in v1.17.1 

func (bm *BlockMiner) Restart()

Restart continues mining after a pause. This will hang if called before pause

func (*BlockMiner) Stop 

func (bm *BlockMiner) Stop()

Stop stops the block miner.

func (*BlockMiner) WatchMinerForPost added in v1.27.1 

func (bm *BlockMiner) WatchMinerForPost(minerAddr address.Address)

WatchMinerForPost adds a miner to the list of miners that the BlockMiner will watch for window post submissions when using MineBlocksMustPost. This is useful when we have more than just the BlockMiner submitting posts, particularly in the case of UnmanagedMiners which don't participate in block mining.

type CfgOption added in v1.17.1 

type CfgOption func(cfg *config.FullNode) error

type ChainPredicate 

type ChainPredicate func(set *types.TipSet) bool

ChainPredicate encapsulates a chain condition.

func BlocksMinedByAll added in v1.20.0 

func BlocksMinedByAll(miner ...address.Address) ChainPredicate

BlocksMinedByAll returns a ChainPredicate that is satisfied when we observe a tipset including blocks from all the specified miners, in no particular order.

func HeightAtLeast 

func HeightAtLeast(target abi.ChainEpoch) ChainPredicate

HeightAtLeast returns a ChainPredicate that is satisfied when the chain height is equal or higher to the target.

type Closer added in v1.19.0 

type Closer func()

func CreateRPCServer 

func CreateRPCServer(t *testing.T, handler http.Handler, listener net.Listener) (*httptest.Server, multiaddr.Multiaddr, Closer)

type EVM added in v1.20.0 

type EVM struct{ *TestFullNode }

EVM groups EVM-related actions.

func (*EVM) AssertAddressBalanceConsistent added in v1.20.0 

func (e *EVM) AssertAddressBalanceConsistent(ctx context.Context, addr address.Address) big.Int

AssertAddressBalanceConsistent checks that the balance reported via the Filecoin and Ethereum operations for an f410 address is identical, returning the balance.

func (*EVM) ComputeContractAddress added in v1.20.0 

func (e *EVM) ComputeContractAddress(deployer ethtypes.EthAddress, nonce uint64) ethtypes.EthAddress

ComputeContractAddress computes the address of a contract deployed by the specified address with the specified nonce.

func (*EVM) DeployContract added in v1.20.0 

func (e *EVM) DeployContract(ctx context.Context, sender address.Address, bytecode []byte) eam.CreateReturn

func (*EVM) DeployContractFromFilename added in v1.20.0 

func (e *EVM) DeployContractFromFilename(ctx context.Context, binFilename string) (address.Address, address.Address)

func (*EVM) DeployContractFromFilenameWithValue added in v1.20.0 

func (e *EVM) DeployContractFromFilenameWithValue(ctx context.Context, binFilename string, value big.Int) (address.Address, address.Address)

func (*EVM) DeployContractWithValue added in v1.20.0 

func (e *EVM) DeployContractWithValue(ctx context.Context, sender address.Address, bytecode []byte, value big.Int) eam.CreateReturn

func (*EVM) GetEthBlockFromWait added in v1.20.0 

func (e *EVM) GetEthBlockFromWait(ctx context.Context, wait *api.MsgLookup) ethtypes.EthBlock

GetEthBlockFromWait returns and eth block from a wait return. This necessarily goes back one parent in the chain because wait is one block ahead of execution.

func (*EVM) InvokeContractByFuncName added in v1.20.0 

func (e *EVM) InvokeContractByFuncName(ctx context.Context, fromAddr address.Address, idAddr address.Address, funcSignature string, inputData []byte) ([]byte, *api.MsgLookup, error)

func (*EVM) InvokeContractByFuncNameExpectExit added in v1.20.0 

func (e *EVM) InvokeContractByFuncNameExpectExit(ctx context.Context, fromAddr address.Address, idAddr address.Address, funcSignature string, inputData []byte, exit exitcode.ExitCode)

func (*EVM) InvokeSolidity added in v1.20.0 

func (e *EVM) InvokeSolidity(ctx context.Context, sender address.Address, target address.Address, selector []byte, inputData []byte) (*api.MsgLookup, error)

func (*EVM) InvokeSolidityWithValue added in v1.23.0 

func (e *EVM) InvokeSolidityWithValue(ctx context.Context, sender address.Address, target address.Address, selector []byte, inputData []byte, value big.Int) (*api.MsgLookup, error)

func (*EVM) LoadEvents added in v1.20.0 

func (e *EVM) LoadEvents(ctx context.Context, eventsRoot cid.Cid) []types.Event

LoadEvents loads all events in an event AMT.

func (*EVM) NewAccount added in v1.20.0 

func (e *EVM) NewAccount() (*key.Key, ethtypes.EthAddress, address.Address)

func (*EVM) SignLegacyEIP155Transaction added in v1.27.1 

func (e *EVM) SignLegacyEIP155Transaction(tx *ethtypes.EthLegacy155TxArgs, privKey []byte, chainID big.Int)

SignLegacyEIP155Transaction signs a legacy Homstead Ethereum transaction in place with the supplied private key.

func (*EVM) SignLegacyHomesteadTransaction added in v1.27.1 

func (e *EVM) SignLegacyHomesteadTransaction(tx *ethtypes.EthLegacyHomesteadTxArgs, privKey []byte)

SignLegacyHomesteadTransaction signs a legacy Homstead Ethereum transaction in place with the supplied private key.

func (*EVM) SignTransaction added in v1.20.0 

func (e *EVM) SignTransaction(tx *ethtypes.Eth1559TxArgs, privKey []byte)

SignTransaction signs an Ethereum transaction in place with the supplied private key.

func (*EVM) SubmitTransaction added in v1.20.0 

func (e *EVM) SubmitTransaction(ctx context.Context, tx ethtypes.EthTransaction) ethtypes.EthHash

SubmitTransaction submits the transaction via the Eth endpoint.

func (*EVM) TransferValueOrFail added in v1.20.0 

func (e *EVM) TransferValueOrFail(ctx context.Context, fromAddr address.Address, toAddr address.Address, sendAmount big.Int) *api.MsgLookup

func (*EVM) WaitTransaction added in v1.25.2 

func (e *EVM) WaitTransaction(ctx context.Context, hash ethtypes.EthHash) (*ethtypes.EthTxReceipt, error)

type Ensemble 

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

Ensemble is a collection of nodes instantiated within a test.

Create a new ensemble with: 

ens := kit.NewEnsemble()

Create full nodes and miners: 

var full TestFullNode
var miner TestMiner
ens.FullNode(&full, opts...)       // populates a full node
ens.Miner(&miner, &full, opts...)  // populates a miner, using the full node as its chain daemon

It is possible to pass functional options to set initial balances, presealed sectors, owner keys, etc.

After the initial nodes are added, call `ens.Start()` to forge genesis and start the network. Mining will NOT be started automatically. It needs to be started explicitly by calling `BeginMining`.

Nodes also need to be connected with one another, either via `ens.Connect()` or `ens.InterconnectAll()`. A common inchantation for simple tests is to do: 

ens.InterconnectAll().BeginMining(blocktime)

You can continue to add more nodes, but you must always follow with `ens.Start()` to activate the new nodes.

The API is chainable, so it's possible to do a lot in a very succinct way: 

kit.NewEnsemble().FullNode(&full).Miner(&miner, &full).Start().InterconnectAll().BeginMining()

You can also find convenient fullnode:miner presets, such as 1:1, 1:2, and 2:1, e.g.: 

kit.EnsembleMinimal()
kit.EnsembleOneTwo()
kit.EnsembleTwoOne()

func NewEnsemble 

func NewEnsemble(t *testing.T, opts ...EnsembleOpt) *Ensemble

NewEnsemble instantiates a new blank Ensemble.

func (*Ensemble) AddInactiveMiner added in v1.19.0 

func (n *Ensemble) AddInactiveMiner(m *TestMiner)

func (*Ensemble) AddInactiveUnmanagedMiner added in v1.27.1 

func (n *Ensemble) AddInactiveUnmanagedMiner(m *TestUnmanagedMiner)

func (*Ensemble) BeginMining 

func (n *Ensemble) BeginMining(blocktime time.Duration, miners ...*TestMiner) []*BlockMiner

BeginMining kicks off mining for the specified miners. If nil or 0-length, it will kick off mining for all enrolled and active miners. It also adds a cleanup function to stop all mining operations on test teardown.

func (*Ensemble) BeginMiningMustPost added in v1.14.0 

func (n *Ensemble) BeginMiningMustPost(blocktime time.Duration, miners ...*TestMiner) []*BlockMiner

func (*Ensemble) Connect 

func (n *Ensemble) Connect(from api.Net, to ...api.Net) *Ensemble

Connect connects one full node to the provided full nodes.

func (*Ensemble) FullNode 

func (n *Ensemble) FullNode(full *TestFullNode, opts ...NodeOpt) *Ensemble

FullNode enrolls a new full node.

func (*Ensemble) InterconnectAll 

func (n *Ensemble) InterconnectAll() *Ensemble

InterconnectAll connects all miners and full nodes to one another.

func (*Ensemble) Miner 

func (n *Ensemble) Miner(minerNode *TestMiner, full *TestFullNode, opts ...NodeOpt) *Ensemble

func (*Ensemble) MinerEnroll added in v1.19.0 

func (n *Ensemble) MinerEnroll(minerNode *TestMiner, full *TestFullNode, opts ...NodeOpt) *Ensemble

MinerEnroll enrolls a new miner, using the provided full node for chain interactions.

func (*Ensemble) Mocknet added in v1.15.1 

func (n *Ensemble) Mocknet() mocknet.Mocknet

Mocknet returns the underlying mocknet.

func (*Ensemble) NewPrivKey added in v1.19.0 

func (n *Ensemble) NewPrivKey() (libp2pcrypto.PrivKey, peer.ID)

func (*Ensemble) Start 

func (n *Ensemble) Start() *Ensemble

Start starts all enrolled nodes.

func (*Ensemble) UnmanagedMiner added in v1.27.1 

func (n *Ensemble) UnmanagedMiner(ctx context.Context, full *TestFullNode, opts ...NodeOpt) (*TestUnmanagedMiner, *Ensemble)

func (*Ensemble) Worker added in v1.15.2 

func (n *Ensemble) Worker(minerNode *TestMiner, worker *TestWorker, opts ...NodeOpt) *Ensemble

Worker enrolls a new worker, using the provided full node for chain interactions.

type EnsembleOpt 

type EnsembleOpt func(opts *ensembleOpts) error

func Account 

func Account(key *key.Key, balance abi.TokenAmount) EnsembleOpt

Account sets up an account at genesis with the specified key and balance.

func GenesisNetworkVersion added in v1.11.2 

func GenesisNetworkVersion(nv network.Version) EnsembleOpt

GenesisNetworkVersion sets the network version of genesis.

func LatestActorsAt 

func LatestActorsAt(upgradeHeight abi.ChainEpoch) EnsembleOpt

func MockProofs 

func MockProofs(e ...bool) EnsembleOpt

MockProofs activates mock proofs for the entire ensemble.

func NetworkName added in v1.32.2 

func NetworkName(name string) EnsembleOpt

NetworkName sets the network name for the ensemble in the genesis template.

func RootVerifier 

func RootVerifier(key *key.Key, balance abi.TokenAmount) EnsembleOpt

RootVerifier specifies the key to be enlisted as the verified registry root, as well as the initial balance to be attributed during genesis.

func UpgradeSchedule added in v1.11.2 

func UpgradeSchedule(upgrades ...stmgr.Upgrade) EnsembleOpt

type EthFilterBuilder added in v1.20.0 

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

func NewEthFilterBuilder added in v1.20.0 

func NewEthFilterBuilder() *EthFilterBuilder

func (*EthFilterBuilder) AddressOneOf added in v1.20.0 

func (e *EthFilterBuilder) AddressOneOf(as ...ethtypes.EthAddress) *EthFilterBuilder

func (*EthFilterBuilder) BlockHash added in v1.20.0 

func (e *EthFilterBuilder) BlockHash(h ethtypes.EthHash) *EthFilterBuilder

func (*EthFilterBuilder) Filter added in v1.20.0 

func (e *EthFilterBuilder) Filter() *ethtypes.EthFilterSpec

func (*EthFilterBuilder) FromBlock added in v1.20.0 

func (e *EthFilterBuilder) FromBlock(v string) *EthFilterBuilder

func (*EthFilterBuilder) FromBlockEpoch added in v1.20.0 

func (e *EthFilterBuilder) FromBlockEpoch(v abi.ChainEpoch) *EthFilterBuilder

func (*EthFilterBuilder) ToBlock added in v1.20.0 

func (e *EthFilterBuilder) ToBlock(v string) *EthFilterBuilder

func (*EthFilterBuilder) ToBlockEpoch added in v1.20.0 

func (e *EthFilterBuilder) ToBlockEpoch(v abi.ChainEpoch) *EthFilterBuilder

func (*EthFilterBuilder) Topic1OneOf added in v1.20.0 

func (e *EthFilterBuilder) Topic1OneOf(hs ...ethtypes.EthHash) *EthFilterBuilder

func (*EthFilterBuilder) Topic2OneOf added in v1.20.0 

func (e *EthFilterBuilder) Topic2OneOf(hs ...ethtypes.EthHash) *EthFilterBuilder

func (*EthFilterBuilder) Topic3OneOf added in v1.20.0 

func (e *EthFilterBuilder) Topic3OneOf(hs ...ethtypes.EthHash) *EthFilterBuilder

func (*EthFilterBuilder) Topic4OneOf added in v1.20.0 

func (e *EthFilterBuilder) Topic4OneOf(hs ...ethtypes.EthHash) *EthFilterBuilder

type ItestdNotif added in v1.15.1 

type ItestdNotif struct {
	NodeType string // api env var name
	TestName string
	Api      string
}

type Libp2p added in v1.19.0 

type Libp2p struct {
	PeerID  peer.ID
	PrivKey libp2pcrypto.PrivKey
}

type MinerSubsystem added in v1.11.1 

type MinerSubsystem int
const (
	SMining MinerSubsystem = 1 << iota
	SSealing
	SSectorStorage

	MinerSubsystems = 0
)

func (MinerSubsystem) Add added in v1.11.1 

func (ms MinerSubsystem) Add(single MinerSubsystem) MinerSubsystem

func (MinerSubsystem) All added in v1.11.1 

func (ms MinerSubsystem) All() [MinerSubsystems]bool

func (MinerSubsystem) Has added in v1.11.1 

func (ms MinerSubsystem) Has(single MinerSubsystem) bool

type MockCLI 

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

func NewMockCLI 

func NewMockCLI(ctx context.Context, t *testing.T, cmds []*lcli.Command, nodeType api.NodeType) *MockCLI

func (*MockCLI) Client 

func (c *MockCLI) Client(addr multiaddr.Multiaddr) *MockCLIClient

type MockCLIClient 

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

MockCLIClient runs commands against a particular node

func (*MockCLIClient) RunCmd 

func (c *MockCLIClient) RunCmd(input ...string) string

func (*MockCLIClient) RunCmdRaw 

func (c *MockCLIClient) RunCmdRaw(input ...string) (string, error)

func (*MockCLIClient) RunInteractiveCmd 

func (c *MockCLIClient) RunInteractiveCmd(cmd []string, interactive []string) string

type MockECFinalityProvider added in v1.35.1 

type MockECFinalityProvider struct {
	FinalizedTipSet *types.TipSet
	ThresholdDepth  int
	Err             error
}

MockECFinalityProvider satisfies ecfinality.ECFinalityCalculator (for ChainModuleV2) and eth.ECFinalityProvider (for tipSetResolver), allowing tests to control the EC finality calculator response without the additional cost of running the FRC-0089 calculator across 905 tipsets on every head change when the block time is tiny.

Set FinalizedTipSet and ThresholdDepth to control the response. Set Err to simulate a calculator failure.

func NewMockECFinalityProvider added in v1.35.1 

func NewMockECFinalityProvider() *MockECFinalityProvider

func (*MockECFinalityProvider) GetFinalizedTipSet added in v1.35.1 

func (m *MockECFinalityProvider) GetFinalizedTipSet(_ context.Context) (*types.TipSet, error)

func (*MockECFinalityProvider) GetStatus added in v1.35.1 

func (m *MockECFinalityProvider) GetStatus(_ context.Context) (*ecfinality.ECFinalityStatus, error)

type MockF3Backend added in v1.33.0 

type MockF3Backend struct {
	Running       bool
	LatestCert    *certs.FinalityCertificate
	LatestCertErr error
	Finalizing    bool
	// contains filtered or unexported fields
}

func NewMockF3Backend added in v1.33.0 

func NewMockF3Backend() *MockF3Backend

func (*MockF3Backend) GetCert added in v1.33.0 

func (t *MockF3Backend) GetCert(_ context.Context, instance uint64) (*certs.FinalityCertificate, error)

func (*MockF3Backend) GetF3PowerTable added in v1.33.0 

func (t *MockF3Backend) GetF3PowerTable(context.Context, types.TipSetKey) (gpbft.PowerEntries, error)

func (*MockF3Backend) GetLatestCert added in v1.33.0 

func (t *MockF3Backend) GetLatestCert(context.Context) (*certs.FinalityCertificate, error)

func (*MockF3Backend) GetManifest added in v1.33.0 

func (t *MockF3Backend) GetManifest(context.Context) (*manifest.Manifest, error)

func (*MockF3Backend) GetOrRenewParticipationTicket added in v1.33.0 

func (t *MockF3Backend) GetOrRenewParticipationTicket(_ context.Context, minerID uint64, _ api.F3ParticipationTicket, _ uint64) (api.F3ParticipationTicket, error)

func (*MockF3Backend) GetPowerTable added in v1.33.0 

func (t *MockF3Backend) GetPowerTable(context.Context, types.TipSetKey) (gpbft.PowerEntries, error)

func (*MockF3Backend) GetPowerTableByInstance added in v1.33.1 

func (t *MockF3Backend) GetPowerTableByInstance(context.Context, uint64) (gpbft.PowerEntries, error)

func (*MockF3Backend) IsRunning added in v1.33.0 

func (t *MockF3Backend) IsRunning() bool

func (*MockF3Backend) ListParticipants added in v1.33.0 

func (t *MockF3Backend) ListParticipants() []api.F3Participant

func (*MockF3Backend) Participate added in v1.33.0 

func (t *MockF3Backend) Participate(_ context.Context, ticket api.F3ParticipationTicket) (api.F3ParticipationLease, error)

func (*MockF3Backend) Progress added in v1.33.0 

func (t *MockF3Backend) Progress() gpbft.InstanceProgress

type NodeOpt 

type NodeOpt func(opts *nodeOpts) error

NodeOpt is a functional option for test nodes.

func ConstructorOpts 

func ConstructorOpts(extra ...node.Option) NodeOpt

ConstructorOpts are Lotus node constructor options that are passed as-is to the node.

func DisableETHBlockCache added in v1.29.0 

func DisableETHBlockCache() NodeOpt

func DisableEthRPC added in v1.20.0 

func DisableEthRPC() NodeOpt

func DisableLibp2p added in v1.11.1 

func DisableLibp2p() NodeOpt

func ECFinalityProvider added in v1.35.1 

func ECFinalityProvider(provider *MockECFinalityProvider) NodeOpt

ECFinalityProvider overrides the EC finality calculator used by the test node with the given mock, replacing the real ECFinalityCache which walks 905 tipsets on every head change.

func F3Backend added in v1.33.0 

func F3Backend(backend lf3.F3Backend) NodeOpt

F3Backend overrides the F3 backend implementation used by test node.

func F3Config added in v1.33.0 

func F3Config(cfg *lf3.Config) NodeOpt

F3Config sets the F3 configuration to be used by test node.

func F3Disabled added in v1.33.0 

func F3Disabled() NodeOpt

F3Disabled disables the F3 subsystem for this node.

func FsRepo added in v1.17.1 

func FsRepo() NodeOpt

func LiteNode 

func LiteNode() NodeOpt

LiteNode specifies that this node will be a lite node. Only relevant when creating a fullnode.

func MainMiner added in v1.11.1 

func MainMiner(m *TestMiner) NodeOpt

func MutateSealingConfig added in v1.15.2 

func MutateSealingConfig(mut func(sc *config.SealingConfig)) NodeOpt

func NoStorage added in v1.17.1 

func NoStorage() NodeOpt

NoStorage initializes miners with no writable storage paths (just read-only preseal paths)

func OwnerAddr 

func OwnerAddr(wk *key.Key) NodeOpt

OwnerAddr sets the owner address of a miner. Only relevant when creating a miner.

func OwnerBalance 

func OwnerBalance(balance abi.TokenAmount) NodeOpt

OwnerBalance specifies the balance to be attributed to a miner's owner account. Only relevant when creating a miner.

func PresealSectors 

func PresealSectors(sectors int) NodeOpt

PresealSectors specifies the amount of preseal sectors to give to a miner at genesis. Only relevant when creating a miner.

func SectorSize added in v1.11.3 

func SectorSize(sectorSize abi.SectorSize) NodeOpt

SectorSize sets the sector size for this miner. Start() will populate the corresponding proof type depending on the network version (genesis network version if the Ensemble is unstarted, or the current network version if started).

func SplitstoreDisable added in v1.25.0 

func SplitstoreDisable() NodeOpt

func SplitstoreDiscard added in v1.17.1 

func SplitstoreDiscard() NodeOpt

func SplitstoreMessges added in v1.19.0 

func SplitstoreMessges() NodeOpt

func SplitstoreUniversal added in v1.17.1 

func SplitstoreUniversal() NodeOpt

func ThroughRPC 

func ThroughRPC() NodeOpt

ThroughRPC makes interactions with this node throughout the test flow through the JSON-RPC API.

func WithAllSubsystems added in v1.11.1 

func WithAllSubsystems() NodeOpt

func WithAssigner added in v1.17.0 

func WithAssigner(a string) NodeOpt

func WithCfgOpt added in v1.17.1 

func WithCfgOpt(opt CfgOption) NodeOpt

func WithDisallowRemoteFinalize added in v1.17.0 

func WithDisallowRemoteFinalize(d bool) NodeOpt

func WithEthRPC added in v1.20.0 

func WithEthRPC() NodeOpt

func WithNoLocalSealing added in v1.15.2 

func WithNoLocalSealing(nope bool) NodeOpt

func WithSubsystems added in v1.11.1 

func WithSubsystems(systems ...MinerSubsystem) NodeOpt

func WithTaskTypes added in v1.15.2 

func WithTaskTypes(tt []sealtasks.TaskType) NodeOpt

func WithWorkerName added in v1.17.1 

func WithWorkerName(n string) NodeOpt

func WithWorkerStorage added in v1.15.2 

func WithWorkerStorage(transform func(paths.Store) paths.Store) NodeOpt

type OnboardOpt added in v1.29.0 

type OnboardOpt func(opts *onboardOpt) error

func WithExpectedExitCodes added in v1.29.0 

func WithExpectedExitCodes(exitCodes []exitcode.ExitCode) OnboardOpt

func WithModifyNIActivationsBeforeSubmit added in v1.29.0 

func WithModifyNIActivationsBeforeSubmit(f func([]miner14.SectorNIActivationInfo) []miner14.SectorNIActivationInfo) OnboardOpt

func WithRequireActivationSuccess added in v1.29.0 

func WithRequireActivationSuccess(requireActivationSuccess bool) OnboardOpt

type OptBuilder 

type OptBuilder func(activeNodes []*TestFullNode) node.Option

OptBuilder is used to create an option after some other node is already active. Takes all active nodes as a parameter.

type SchedInfo added in v1.20.0 

type SchedInfo struct {
	CallToWork   struct{}
	EarlyRet     interface{}
	ReturnedWork interface{}
	SchedInfo    struct {
		OpenWindows []string
		Requests    []struct {
			Priority int
			SchedId  uuid.UUID
			Sector   struct {
				Miner  int
				Number int
			}
			TaskType string
		}
	}
	Waiting interface{}
}

SchedInfo comes from https://github.com/filecoin-project/lotus/blob/8ba4355cabd25e5f65261aaa561ff676321ffbd8/storage/sealer/manager.go#L1226 todo: have this defined in one place

type SectorBatch added in v1.32.0 

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

SectorBatch is a builder for creating sector manifests

func NewSectorBatch added in v1.32.0 

func NewSectorBatch() *SectorBatch

NewSectorBatch creates an empty sector batch

func (*SectorBatch) AddEmptySectors added in v1.32.0 

func (sb *SectorBatch) AddEmptySectors(count int) *SectorBatch

AddEmptySectors adds the specified number of CC sectors to the batch

func (*SectorBatch) AddSector added in v1.32.0 

func (sb *SectorBatch) AddSector(manifest SectorManifest) *SectorBatch

AddSector adds a custom sector manifest

func (*SectorBatch) AddSectorsWithRandomPieces added in v1.32.0 

func (sb *SectorBatch) AddSectorsWithRandomPieces(count int) *SectorBatch

AddSectorsWithRandomPieces adds sectors with random pieces

type SectorManifest added in v1.32.0 

type SectorManifest struct {
	Piece    cid.Cid
	Verified *miner14.VerifiedAllocationKey
	Duration abi.ChainEpoch
}

SectorManifest is (currently) a simplified SectorAllocationManifest, allowing zero or one pieces to be built into a sector, where that one piece may be verified. Undefined Piece and nil Verified onboards a CC sector. Duration changes the default sector expiration of 300 days past the minimum.

func EmptySector added in v1.32.0 

func EmptySector() SectorManifest

EmptySector creates an empty (CC) sector with no pieces

func SectorWithPiece added in v1.32.0 

func SectorWithPiece(piece cid.Cid) SectorManifest

SectorWithPiece creates a sector with the specified piece CID

func SectorWithVerifiedPiece added in v1.32.0 

func SectorWithVerifiedPiece(piece cid.Cid, key *miner14.VerifiedAllocationKey) SectorManifest

SectorWithVerifiedPiece creates a sector with a verified allocation

type SendCall added in v1.20.0 

type SendCall struct {
	Method abi.MethodNum
	Params []byte
}

type SolidityContractDef added in v1.20.0 

type SolidityContractDef struct {
	Filename string                      // filename of the hex of the contract, e.g. contracts/EventMatrix.hex
	Fn       map[string][]byte           // mapping of function names to 32-bit selector
	Ev       map[string]ethtypes.EthHash // mapping of event names to 256-bit signature hashes
}

SolidityContractDef holds information about one of the test contracts

type TestDealState 

type TestDealState int

func CategorizeDealState 

func CategorizeDealState(dealStatus string) TestDealState

CategorizeDealState categorizes deal states into one of three states: Complete, InProgress, Failed.

type TestFullNode 

type TestFullNode struct {
	v1api.FullNode
	V2 v2api.FullNode

	// ListenAddr is the address on which an API server is listening, if an
	// API server is created for this Node.
	ListenAddr multiaddr.Multiaddr
	ListenURL  string
	DefaultKey *key.Key

	Pkey *Libp2p

	Stop node.StopFunc

	// gateway handler makes it convenient to register callbalks per topic, so we
	// also use it for tests
	EthSubRouter *gateway.EthSubHandler
	// contains filtered or unexported fields
}

TestFullNode represents a full node enrolled in an Ensemble.

func MergeFullNodes added in v1.19.0 

func MergeFullNodes(fullNodes []*TestFullNode) *TestFullNode

func SetupFEVMTest added in v1.20.0 

func SetupFEVMTest(t *testing.T, opts ...interface{}) (context.Context, context.CancelFunc, *TestFullNode)

func (*TestFullNode) AssertActorType added in v1.20.0 

func (f *TestFullNode) AssertActorType(ctx context.Context, addr address.Address, actorType string)

AssertActorType verifies that the supplied address is an actor of the specified type (as per its manifest key).

func (*TestFullNode) AssignPrivKey added in v1.19.0 

func (f *TestFullNode) AssignPrivKey(pkey *Libp2p)

func (*TestFullNode) DoRawRPCRequest added in v1.33.0 

func (full *TestFullNode) DoRawRPCRequest(t *testing.T, version int, body string) (int, []byte)

func (*TestFullNode) EVM added in v1.20.0 

func (f *TestFullNode) EVM() *EVM

func (*TestFullNode) ExpectSend added in v1.20.0 

func (f *TestFullNode) ExpectSend(ctx context.Context, from, to address.Address, value types.BigInt, errContains string, sc ...SendCall) *types.SignedMessage

func (*TestFullNode) MakeSendCall added in v1.20.0 

func (f *TestFullNode) MakeSendCall(m abi.MethodNum, params cbg.CBORMarshaler) SendCall

func (TestFullNode) Shutdown added in v1.19.0 

func (f TestFullNode) Shutdown(ctx context.Context) error

func (*TestFullNode) WaitForSectorActive added in v1.15.2 

func (f *TestFullNode) WaitForSectorActive(ctx context.Context, t *testing.T, sn abi.SectorNumber, maddr address.Address)

func (*TestFullNode) WaitMsg added in v1.11.1 

func (f *TestFullNode) WaitMsg(ctx context.Context, msg cid.Cid)

func (*TestFullNode) WaitTillChain 

func (f *TestFullNode) WaitTillChain(ctx context.Context, pred ChainPredicate) *types.TipSet

WaitTillChain waits until a specified chain condition is met. It returns the first tipset where the condition is met.

func (*TestFullNode) WaitTillChainOrError added in v1.27.1 

func (f *TestFullNode) WaitTillChainOrError(ctx context.Context, pred ChainPredicate) (*types.TipSet, error)

WaitTillChainOrError waits until a specified chain condition is met. It returns the first tipset where the condition is met. In the case of an error it will return the error.

type TestMiner 

type TestMiner struct {
	api.StorageMiner

	BaseAPI api.StorageMiner

	// ListenAddr is the address on which an API server is listening, if an
	// API server is created for this Node
	ListenAddr multiaddr.Multiaddr

	ActorAddr address.Address
	OwnerKey  *key.Key
	MineOne   func(context.Context, miner.MineReq) error
	Stop      func(context.Context) error

	FullNode       *TestFullNode
	PresealDir     string
	PresealSectors int

	Libp2p struct {
		PeerID  peer.ID
		PrivKey libp2pcrypto.PrivKey
	}

	RemoteListener net.Listener
	// contains filtered or unexported fields
}

TestMiner represents a miner enrolled in an Ensemble.

func (*TestMiner) AddStorage 

func (tm *TestMiner) AddStorage(ctx context.Context, t *testing.T, conf func(*storiface.LocalStorageMeta)) storiface.ID

func (*TestMiner) FlushSealingBatches 

func (tm *TestMiner) FlushSealingBatches(ctx context.Context)

func (*TestMiner) PledgeSectors 

func (tm *TestMiner) PledgeSectors(ctx context.Context, n, existing int, blockNotif <-chan struct{})

func (*TestMiner) SchedInfo added in v1.20.0 

func (tm *TestMiner) SchedInfo(ctx context.Context) SchedInfo

func (*TestMiner) SectorsListNonGenesis added in v1.17.1 

func (tm *TestMiner) SectorsListNonGenesis(ctx context.Context) ([]abi.SectorNumber, error)

func (*TestMiner) SetControlAddresses added in v1.11.1 

func (tm *TestMiner) SetControlAddresses(addrs ...addr.Address)

func (*TestMiner) StartPledge 

func (tm *TestMiner) StartPledge(ctx context.Context, n, existing int, blockNotif <-chan struct{}) map[abi.SectorNumber]struct{}

func (*TestMiner) WaitSectorsProving added in v1.14.0 

func (tm *TestMiner) WaitSectorsProving(ctx context.Context, toCheck map[abi.SectorNumber]struct{})

func (*TestMiner) WaitSectorsProvingAllowFails added in v1.17.2 

func (tm *TestMiner) WaitSectorsProvingAllowFails(ctx context.Context, toCheck map[abi.SectorNumber]struct{}, okFails map[api.SectorState]struct{})

type TestUnmanagedMiner added in v1.27.1 

type TestUnmanagedMiner struct {
	ActorAddr address.Address
	OwnerKey  *key.Key
	FullNode  *TestFullNode
	Libp2p    struct {
		PeerID  peer.ID
		PrivKey libp2pcrypto.PrivKey
	}
	// contains filtered or unexported fields
}

TestUnmanagedMiner is a miner that's not managed by the storage/infrastructure, all tasks must be manually executed, managed and scheduled by the test or test kit. Note: `TestUnmanagedMiner` is not thread safe and assumes linear access of its methods

func NewTestUnmanagedMiner added in v1.27.1 

func NewTestUnmanagedMiner(ctx context.Context, t *testing.T, full *TestFullNode, actorAddr address.Address, mockProofs bool, opts ...NodeOpt) *TestUnmanagedMiner

func (*TestUnmanagedMiner) AssertDisputeFails added in v1.28.0 

func (tm *TestUnmanagedMiner) AssertDisputeFails(sector abi.SectorNumber)

func (*TestUnmanagedMiner) AssertNoPower added in v1.27.1 

func (tm *TestUnmanagedMiner) AssertNoPower()

func (*TestUnmanagedMiner) AssertNoWindowPostError added in v1.29.0 

func (tm *TestUnmanagedMiner) AssertNoWindowPostError()

func (*TestUnmanagedMiner) AssertPower added in v1.27.1 

func (tm *TestUnmanagedMiner) AssertPower(raw uint64, qa uint64)

func (*TestUnmanagedMiner) CurrentPower added in v1.27.1 

func (tm *TestUnmanagedMiner) CurrentPower() *api.MinerPower

func (*TestUnmanagedMiner) ExtendSectorExpiration added in v1.32.0 

func (tm *TestUnmanagedMiner) ExtendSectorExpiration(sectorNumber abi.SectorNumber, expiration abi.ChainEpoch) types.TipSetKey

func (*TestUnmanagedMiner) GetPostCount added in v1.32.0 

func (tm *TestUnmanagedMiner) GetPostCount(sectorNumber abi.SectorNumber) int

func (*TestUnmanagedMiner) GetPostCountSince added in v1.32.0 

func (tm *TestUnmanagedMiner) GetPostCountSince(epoch abi.ChainEpoch, sectorNumber abi.SectorNumber) int

func (*TestUnmanagedMiner) MaybeImmutableDeadline added in v1.33.1 

func (tm *TestUnmanagedMiner) MaybeImmutableDeadline(deadlineIndex uint64) bool

MaybeImmutableDeadline checks if the deadline index is immutable. Immutable deadlines are defined as being the current deadline for the miner or their next deadline. But we also include the deadline after the next deadline in our check here to be conservative to avoid race conditions of the chain progressing before messages land.

func (*TestUnmanagedMiner) OnboardSectors added in v1.29.0 

func (tm *TestUnmanagedMiner) OnboardSectors(
	proofType abi.RegisteredSealProof,
	sectorBatch *SectorBatch,
	opts ...OnboardOpt,
) ([]abi.SectorNumber, types.TipSetKey)

OnboardSectors onboards the specified number of sectors to the miner using the specified proof type. If `withPieces` is true and the proof type supports it, the sectors will be onboarded with pieces, otherwise they will be CC.

This method is synchronous but each sector is prepared in a separate goroutine to speed up the process with real proofs.

func (*TestUnmanagedMiner) SnapDeal added in v1.28.0 

func (tm *TestUnmanagedMiner) SnapDeal(sectorNumber abi.SectorNumber, sm SectorManifest) ([]abi.PieceInfo, types.TipSetKey)

SnapDeal snaps a deal into a sector, generating a new sealed sector and updating the sector's state. WindowPoSt should continue to operate after this operation if required. The SectorManifest argument (currently) only impacts mock proofs, and is ignored otherwise.

func (*TestUnmanagedMiner) Stop added in v1.29.0 

func (tm *TestUnmanagedMiner) Stop()

func (*TestUnmanagedMiner) SubmitMessage added in v1.28.0 

func (tm *TestUnmanagedMiner) SubmitMessage(
	params cbg.CBORMarshaler,
	value uint64,
	method abi.MethodNum,
) (*api.MsgLookup, error)

func (*TestUnmanagedMiner) WaitTillActivatedAndAssertPower added in v1.28.0 

func (tm *TestUnmanagedMiner) WaitTillActivatedAndAssertPower(sectors []abi.SectorNumber, raw uint64, qa uint64)

func (*TestUnmanagedMiner) WaitTillPostCount added in v1.32.0 

func (tm *TestUnmanagedMiner) WaitTillPostCount(sectorNumber abi.SectorNumber, count int)

type TestWorker added in v1.15.2 

type TestWorker struct {
	api.Worker

	// ListenAddr is the address on which an API server is listening, if an
	// API server is created for this Node
	ListenAddr multiaddr.Multiaddr

	Stop func(context.Context) error

	FetchHandler   http.HandlerFunc
	MinerNode      *TestMiner
	RemoteListener net.Listener
	// contains filtered or unexported fields
}

TestWorker represents a worker enrolled in an Ensemble.

func (*TestWorker) AddStorage added in v1.17.1 

func (tm *TestWorker) AddStorage(ctx context.Context, t *testing.T, conf func(*storiface.LocalStorageMeta)) storiface.ID

Source Files

View all Source files

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.