Interop: SuperSystem for E2E Tests (#11850)

* op-e2e: interop test setup (work in progress)

* op-e2e: interop test setup

* organization and comment updates

* refactor creation code into WIP system2

* save secrets per L2

* Add SuperSystem Interface ; Add Users and Transactions

* Further Refactoring ; Fix Test

* Add Supervisor

* Add Supervisor Client

* Comment out Proposer

* Add AddL2RPC to Supervisor Client

* Fully link Supervisor and OP Node in E2E Test

* correct RPC call supervisor_checkBlock

* Make EOF acceptable for backend check

* final structure names

* Change unused functions to _ for linter

* fix import order

* Add Github Issue Numbers to TODOs

* tynes comments: add World Resource as configurable

---------

Co-authored-by: protolambda <[email protected]>

op-e2e/e2eutils/setuputils/utils.go

@@ -0,0 +1,31 @@
+package setuputils
+
+import (
+	"crypto/ecdsa"
+	"time"
+
+	"github.com/ethereum/go-ethereum/common/hexutil"
+
+	"github.com/ethereum-optimism/optimism/op-e2e/e2eutils"
+	"github.com/ethereum-optimism/optimism/op-service/endpoint"
+	"github.com/ethereum-optimism/optimism/op-service/txmgr"
+)
+
+func hexPriv(in *ecdsa.PrivateKey) string {
+	b := e2eutils.EncodePrivKey(in)
+	return hexutil.Encode(b)
+}
+
+func NewTxMgrConfig(l1Addr endpoint.RPC, privKey *ecdsa.PrivateKey) txmgr.CLIConfig {
+	return txmgr.CLIConfig{
+		L1RPCURL:                  l1Addr.RPC(),
+		PrivateKey:                hexPriv(privKey),
+		NumConfirmations:          1,
+		SafeAbortNonceTooLowCount: 3,
+		FeeLimitMultiplier:        5,
+		ResubmissionTimeout:       3 * time.Second,
+		ReceiptQueryInterval:      50 * time.Millisecond,
+		NetworkTimeout:            2 * time.Second,
+		TxNotInMempoolTimeout:     2 * time.Minute,
+	}
+}

op-e2e/interop/interop_test.go

@@ -0,0 +1,85 @@
+package interop
+
+import (
+	"context"
+	"math/big"
+	"testing"
+	"time"
+
+	"github.com/ethereum-optimism/optimism/op-chain-ops/interopgen"
+	op_e2e "github.com/ethereum-optimism/optimism/op-e2e"
+	"github.com/stretchr/testify/require"
+)
+
+// TestInteropTrivial tests a simple interop scenario
+// Chains A and B exist, but no messages are sent between them
+// and in fact no event-logs are emitted by either chain at all.
+// A transaction is sent from Alice to Bob on Chain A.
+// The balance of Bob on Chain A is checked before and after the tx.
+// The balance of Bob on Chain B is checked after the tx.
+func TestInteropTrivial(t *testing.T) {
+	recipe := interopgen.InteropDevRecipe{
+		L1ChainID:        900100,
+		L2ChainIDs:       []uint64{900200, 900201},
+		GenesisTimestamp: uint64(time.Now().Unix() + 3), // start chain 3 seconds from now
+	}
+	worldResources := worldResourcePaths{
+		foundryArtifacts: "../../packages/contracts-bedrock/forge-artifacts",
+		sourceMap:        "../../packages/contracts-bedrock",
+	}
+
+	// create a super system from the recipe
+	// and get the L2 IDs for use in the test
+	s2 := NewSuperSystem(t, &recipe, worldResources)
+	ids := s2.L2IDs()
+
+	// chainA is the first L2 chain
+	chainA := ids[0]
+	// chainB is the second L2 chain
+	chainB := ids[1]
+
+	// create two users on all L2 chains
+	s2.AddUser("Alice")
+	s2.AddUser("Bob")
+
+	bobAddr := s2.Address(chainA, "Bob")
+
+	// check the balance of Bob
+	clientA := s2.L2GethClient(chainA)
+	ctx, cancel := context.WithTimeout(context.Background(), 1*time.Second)
+	defer cancel()
+	bobBalance, err := clientA.BalanceAt(ctx, bobAddr, nil)
+	require.NoError(t, err)
+	expectedBalance, _ := big.NewInt(0).SetString("10000000000000000000000000", 10)
+	require.Equal(t, expectedBalance, bobBalance)
+
+	// send a tx from Alice to Bob
+	s2.SendL2Tx(
+		chainA,
+		"Alice",
+		func(l2Opts *op_e2e.TxOpts) {
+			l2Opts.ToAddr = &bobAddr
+			l2Opts.Value = big.NewInt(1000000)
+			l2Opts.GasFeeCap = big.NewInt(1_000_000_000)
+			l2Opts.GasTipCap = big.NewInt(1_000_000_000)
+		},
+	)
+
+	// check the balance of Bob after the tx
+	ctx, cancel = context.WithTimeout(context.Background(), 1*time.Second)
+	defer cancel()
+	bobBalance, err = clientA.BalanceAt(ctx, bobAddr, nil)
+	require.NoError(t, err)
+	expectedBalance, _ = big.NewInt(0).SetString("10000000000000000001000000", 10)
+	require.Equal(t, expectedBalance, bobBalance)
+
+	// check that the balance of Bob on ChainB hasn't changed
+	bobAddrB := s2.Address(chainB, "Bob")
+	clientB := s2.L2GethClient(chainB)
+	ctx, cancel = context.WithTimeout(context.Background(), 1*time.Second)
+	defer cancel()
+	bobBalance, err = clientB.BalanceAt(ctx, bobAddrB, nil)
+	require.NoError(t, err)
+	expectedBalance, _ = big.NewInt(0).SetString("10000000000000000000000000", 10)
+	require.Equal(t, expectedBalance, bobBalance)
+}