evmtest

func AssertBankBalanceEqualWithDescription ¶

func AssertBankBalanceEqualWithDescription(
	t *testing.T,
	deps TestDeps,
	denom string,
	account gethcommon.Address,
	expectedBalance *big.Int,
	description string,
)

func AssertERC20BalanceEqualWithDescription ¶

func AssertERC20BalanceEqualWithDescription(
	t *testing.T,
	deps TestDeps,
	evmObj *vm.EVM,
	erc20, account gethcommon.Address,
	expectedBalance *big.Int,
	description string,
)

func BuildTx ¶

func BuildTx(
	deps *TestDeps,
	ethExtentions bool,
	gasLimit uint64,
	fees sdk.Coins,
	msgs ...sdk.Msg,
) sdk.FeeTx

func CreateFunTokenForBankCoin ¶

func CreateFunTokenForBankCoin(
	deps TestDeps, bankDenom string, s *suite.Suite,
) (funtoken evm.FunToken)

CreateFunTokenForBankCoin: Uses the "TestDeps.Sender" account to create a "FunToken" mapping for a new coin

func DeployAndExecuteERC20Transfer ¶

func DeployAndExecuteERC20Transfer(
	deps *TestDeps, t *testing.T,
) (
	erc20Transfer *evm.MsgEthereumTx,
	predecessors []*evm.MsgEthereumTx,
	contractAddr gethcommon.Address,
)

DeployAndExecuteERC20Transfer deploys a test ERC-20, executes one transfer, and returns the transfer tx, the deploy tx (as a predecessor), and the contract address.

## Determinism: Why we use a fixed recipient address

Intrinsic gas charges depend on calldata bytes. Since Istanbul (EIP-2028), each zero byte is 4 gas and each non-zero byte is 16 gas (+12 per non-zero byte). In an ERC-20 transfer(address,uint256), the address occupies the last 20 bytes of a 32-byte word (left-padded with zeros). Random recipients change the count of non-zero bytes and make gas/gasUsed assertions flaky.

To keep tests stable, this helper uses a fixed recipient address whose byte pattern is constant. The intrinsic gas term is then reproducible.

References:

• EIP-2028: https://eips.ethereum.org/EIPS/eip-2028
• Solidity ABI padding rules: https://docs.soliditylang.org/en/latest/abi-spec.html

func EnsureNibiruPrefix ¶ added in v2.8.0

func EnsureNibiruPrefix()

Ensures that the Bech32 address prefix is configured to "nibi" instead of a another one like "cosmos", which will panic on Nibiru.

func ExecuteNibiTransfer ¶

func ExecuteNibiTransfer(deps *TestDeps, t *testing.T) (*evm.MsgEthereumTx, *evm.MsgEthereumTxResponse)

ExecuteNibiTransfer executes nibi transfer

func GasLimitCreateContract ¶

func GasLimitCreateContract() *big.Int

func GenerateEthTxMsgAndSigner ¶

func GenerateEthTxMsgAndSigner(
	jsonTxArgs evm.JsonTxArgs, deps *TestDeps, sender EthPrivKeyAcc,
) (evmTxMsg *evm.MsgEthereumTx, gethSigner gethcore.Signer, krSigner keyring.Signer, err error)

GenerateEthTxMsgAndSigner estimates gas, sets gas limit and returns signer for the tx.

Usage:

```go
evmTxMsg, gethSigner, krSigner, _ := GenerateEthTxMsgAndSigner(
    jsonTxArgs, &deps, sender,
)
err := evmTxMsg.Sign(gethSigner, sender.KeyringSigner)
```

func HappyCreateContractTx ¶

func HappyCreateContractTx(deps *TestDeps) *evm.MsgEthereumTx

func HappyTransferTx ¶

func HappyTransferTx(deps *TestDeps, nonce uint64) *evm.MsgEthereumTx

func LogLiteEventErc20Transfer ¶ added in v2.8.0

func LogLiteEventErc20Transfer(
	contract gethcommon.Address,
	from, to gethcommon.Address, amt *big.Int,
) evm.LogLite

Constructs an ERC20 Transfer event

func LogLiteEventWnibiDeposit ¶ added in v2.8.0

func LogLiteEventWnibiDeposit(contract, dst gethcommon.Address, amt *big.Int) evm.LogLite

Constructs a WNIBI.sol Deposit event

func NewEthTxMsgAsCmt ¶

func NewEthTxMsgAsCmt(t *testing.T) (
	txBz cmttypes.Tx,
	ethTxMsgs []*evm.MsgEthereumTx,
	clientCtx client.Context,
)

NewEthTxMsgAsCmt: Helper that returns an Ethereum tx msg converted into tx bytes used in the Consensus Engine.

func NewEthTxMsgFromTxData ¶

func NewEthTxMsgFromTxData(
	deps *TestDeps,
	txType GethTxType,
	innerTxData []byte,
	nonce uint64,
	to *gethcommon.Address,
	value *big.Int,
	gas uint64,
	accessList gethcore.AccessList,
) (*evm.MsgEthereumTx, error)

NewEthTxMsgFromTxData creates an Ethereum transaction message based on the specified txType (Legacy, AccessList, or DynamicFee). This function populates transaction fields like nonce, recipient, value, and gas, with an optional access list for AccessList and DynamicFee types. The transaction is signed using the provided dependencies.

Parameters:

• deps: Required dependencies including the sender address and signer.
• txType: Transaction type (Legacy, AccessList, or DynamicFee).
• innerTxData: Byte slice of transaction data (input).
• nonce: Transaction nonce.
• to: Recipient address.
• value: ETH value (in wei) to transfer.
• gas: Gas limit for the transaction.
• accessList: Access list for AccessList and DynamicFee types.

Returns:

• *evm.MsgEthereumTx: Ethereum transaction message ready for submission.
• error: Any error encountered during creation or signing.

func NewEthTxMsgs ¶

func NewEthTxMsgs(count uint64) (ethTxMsgs []*evm.MsgEthereumTx)

func NewMsgEthereumTx ¶ added in v2.8.0

func NewMsgEthereumTx(
	args ArgsEthTx,
) (msgEthereumTx *evm.MsgEthereumTx, err error)

func NewSigner ¶

func NewSigner(sk cryptotypes.PrivKey) keyring.Signer

func NonEvmMsgTx ¶

func NonEvmMsgTx(deps *TestDeps) sdk.Tx

func TxTemplateAccessListTx ¶

func TxTemplateAccessListTx() *gethcore.AccessListTx

func TxTemplateDynamicFeeTx ¶

func TxTemplateDynamicFeeTx() *gethcore.DynamicFeeTx

func TxTemplateLegacyTx ¶

func TxTemplateLegacyTx() *gethcore.LegacyTx

func ValidLegacyTx ¶

func ValidLegacyTx() *evm.LegacyTx

ValidLegacyTx: Useful initial condition for tests Exported only for use in tests.