go-ffi

command
v1.4.3 Latest Latest
Warning

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

Go to latest
Published: Jun 3, 2024 License: MIT, MIT Imports: 22 Imported by: 0

README

go-ffi

A lightweight binary for utilities accessed via forge's ffi cheatcode in the contracts test suite.

├── go-ffi
│   ├── bin: `go-ffi`'s binary
│   ├── trie: Utility for generating random merkle trie roots / inclusion proofs
│   └── diff-testing: Utility for differential testing Solidity implementations against their respective Go implementations.

Usage

To build, run pnpm build:go-ffi from this directory or the contract package.

In a Forge Test

To use go-ffi in a forge test, simply invoke the binary via the vm.ffi cheatcode.

function myFFITest() public {
    string[] memory commands = new string[](3);
    commands[0] = "./scripts/go-ffi/go-ffi";
    commands[1] = "trie";
    commands[2] = "valid";
    bytes memory result = vm.ffi(commands);

    // Do something with the result of the command
}
Available Modes

There are two modes available in go-ffi: diff and trie. Each are present as a subcommand to the go-ffi binary, with their own set of variants.

diff

Note Variant required for diff mode.

Variant Description
decodeVersionedNonce Decodes a versioned nonce and prints the decoded arguments
encodeCrossDomainMessage Encodes a cross domain message and prints the encoded message
hashCrossDomainMessage Encodes and hashes a cross domain message and prints the digest
hashDepositTransaction Encodes and hashes a deposit transaction and prints the digest
encodeDepositTransaction RLP encodes a deposit transaction
hashWithdrawal Hashes a withdrawal message and prints the digest
hashOutputRootProof Hashes an output root proof and prints the digest
getProveWithdrawalTransactionInputs Generates the inputs for a getProveWithdrawalTransaction call to the KromaPortal given a withdrawal message
trie

Note Variant required for trie mode.

Variant Description
valid Generate a test case with a valid proof of inclusion for the k/v pair in the trie.
extra_proof_elems Generate an invalid test case with an extra proof element attached to an otherwise valid proof of inclusion for the passed k/v.
corrupted_proof Generate an invalid test case where the proof is malformed.
invalid_data_remainder Generate an invalid test case where a random element of the proof has more bytes than the length designates within the RLP list encoding.
invalid_large_internal_hash Generate an invalid test case where a long proof element is incorrect for the root.
invalid_internal_node_hash Generate an invalid test case where a small proof element is incorrect for the root.
prefixed_valid_key Generate a valid test case with a key that has been given a random prefix
empty_key Generate a valid test case with a proof of inclusion for an empty key.
partial_proof Generate an invalid test case with a partially correct proof

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL