disputegame

Oct 8, 2024

Changes in this version

type DisputeSystem

+ AllocType func() config.AllocType

+ type FactoryCfg struct

+ PrivKey *ecdsa.PrivateKey

type FactoryHelper

+ AllocType config.AllocType

+ func (h *FactoryHelper) StartPermissionedGame(ctx context.Context, l2Node string, l2BlockNumber uint64, ...) *OutputCannonGameHelper

+ type FactoryOption func(c *FactoryCfg)

+ func WithFactoryPrivKey(privKey *ecdsa.PrivateKey) FactoryOption

+ type HonestActorConfig struct

+ ChallengerOpts []challenger.Option

+ PoststateBlock uint64

+ PrestateBlock uint64

Sep 5, 2024

Changes in this version

type ClaimHelper

+ func (c *ClaimHelper) RequireInvalidStatusCode()

Aug 28, 2024

Changes in this version

+ type HonestActorOpt func(cfg *honestActorConfig)

+ func WithClaimedL2BlockNumber(num uint64) HonestActorOpt

+ func WithPrivKey(privKey *ecdsa.PrivateKey) HonestActorOpt

Jun 5, 2024

Changes in this version

type FactoryHelper

+ PrivKey *ecdsa.PrivateKey

type OutputGameHelper

+ PrivKey *ecdsa.PrivateKey

May 23, 2024

Changes in this version

type ClaimHelper

+ Index int64

+ ParentIndex int

+ Position types.Position

type FactoryHelper

+ Client *ethclient.Client

+ Factory *bindings.DisputeGameFactory

+ FactoryAddr common.Address

+ Opts *bind.TransactOpts

+ Require *require.Assertions

+ System DisputeSystem

+ T *testing.T

+ func (h *FactoryHelper) CreateBisectionGameExtraData(l2Node string, l2BlockNumber uint64, cfg *GameCfg) []byte

+ func (h *FactoryHelper) GetL1Head(ctx context.Context, game contracts.FaultDisputeGameContract) eth.BlockID

+ func (h *FactoryHelper) WaitForBlock(l2Node string, l2BlockNumber uint64, cfg *GameCfg)

+ type GameCfg struct

+ func NewGameCfg(opts ...GameOpt) *GameCfg

type OutputGameHelper

+ Client *ethclient.Client

+ CorrectOutputProvider *outputs.OutputTraceProvider

+ FactoryAddr common.Address

+ Game contracts.FaultDisputeGameContract

+ GameBindings *bindings.FaultDisputeGame

+ Opts *bind.TransactOpts

+ Require *require.Assertions

+ System DisputeSystem

+ T *testing.T

+ func NewOutputGameHelper(t *testing.T, require *require.Assertions, client *ethclient.Client, ...) *OutputGameHelper

+ func (g *OutputGameHelper) GameData(ctx context.Context) string

+ func (g *OutputGameHelper) GetL1Head(ctx context.Context) eth.BlockID

+ func (g *OutputGameHelper) UploadPreimage(ctx context.Context, data *types.PreimageOracleData, ...)

+ func (g *OutputGameHelper) WaitForL2BlockNumberChallenged(ctx context.Context)

+ func (g *OutputGameHelper) WaitForPreimageInOracle(ctx context.Context, data *types.PreimageOracleData)

type OutputHonestHelper

+ func NewOutputHonestHelper(t *testing.T, require *require.Assertions, game *OutputGameHelper, ...) *OutputHonestHelper

Apr 23, 2024

Changes in this version

+ var TestAddress = crypto.PubkeyToAddress(TestKey.PublicKey)

+ var TestKey = crypto.HexToECDSA("b71c71a67e1177ad4e901695e1b4b9ee17ae16c6668d313eac2f96dbcda3f291")

type FaultGameHelper

+ func (g *FaultGameHelper) MaxClockDuration(ctx context.Context) time.Duration

type OutputGameHelper

+ func (g *OutputGameHelper) MaxClockDuration(ctx context.Context) time.Duration

Mar 20, 2024

Changes in this version

+ type GameOpt interface

+ Apply func(cfg *gameCfg)

+ func WithFutureProposal() GameOpt

+ func WithUnsafeProposal() GameOpt

+ type MoveOpt interface

+ Apply func(cfg *moveCfg)

+ func WithIgnoreDuplicates() MoveOpt

+ func WithTransactOpts(opts *bind.TransactOpts) MoveOpt

type OutputCannonGameHelper

+ func (g *OutputCannonGameHelper) VerifyPreimage(ctx context.Context, outputRootClaim *ClaimHelper, preimageKey preimage.Key)

type OutputGameHelper

+ func (g *OutputGameHelper) AvailableCredit(ctx context.Context, addr common.Address) *big.Int

+ func (g *OutputGameHelper) CreditUnlockDuration(ctx context.Context) time.Duration

+ func (g *OutputGameHelper) StartingBlockNum(ctx context.Context) uint64

+ func (g *OutputGameHelper) WaitForNoAvailableCredit(ctx context.Context, addr common.Address)

+ func (g *OutputGameHelper) WethBalance(ctx context.Context, addr common.Address) *big.Int

type OutputHonestHelper

+ func (h *OutputHonestHelper) CounterClaim(ctx context.Context, claim *ClaimHelper, opts ...MoveOpt) *ClaimHelper

Feb 8, 2024

Changes in this version

type ClaimHelper

+ func (c *ClaimHelper) AttackWithTransactOpts(ctx context.Context, value common.Hash, opts *bind.TransactOpts) *ClaimHelper

+ func (c *ClaimHelper) DefendWithTransactOpts(ctx context.Context, value common.Hash, opts *bind.TransactOpts) *ClaimHelper

+ type DefendClaimOpt func(cfg *defendClaimCfg)

+ func WithoutWaitingForStep() DefendClaimOpt

type DisputeSystem

+ AdvanceTime func(time.Duration)

+ L1BeaconEndpoint func() string

type OutputCannonGameHelper

+ func (g *OutputCannonGameHelper) ChallengeToPreimageLoad(ctx context.Context, outputRootClaim *ClaimHelper, ...)

+ func (g *OutputCannonGameHelper) CreateStepLargePreimageLoadCheck(ctx context.Context, sender common.Address) PreimageLoadCheck

+ func (g *OutputCannonGameHelper) CreateStepPreimageLoadCheck(ctx context.Context) PreimageLoadCheck

type OutputGameHelper

+ func (g *OutputGameHelper) AttackWithTransactOpts(ctx context.Context, claimIdx int64, claim common.Hash, ...)

+ func (g *OutputGameHelper) ChallengePeriod(ctx context.Context) uint64

+ func (g *OutputGameHelper) ChallengePeriodStartTime(ctx context.Context, sender common.Address, data *types.PreimageOracleData) uint64

+ func (g *OutputGameHelper) Credit(ctx context.Context, addr common.Address) *big.Int

+ func (g *OutputGameHelper) DefendWithTransactOpts(ctx context.Context, claimIdx int64, claim common.Hash, ...)

+ func (g *OutputGameHelper) DisputeBlock(ctx context.Context, disputeBlockNum uint64) *ClaimHelper

+ func (g *OutputGameHelper) WaitForChallengePeriodStart(ctx context.Context, sender common.Address, data *types.PreimageOracleData)

type OutputHonestHelper

+ func (h *OutputHonestHelper) AttackClaimWithTransactOpts(ctx context.Context, claim *ClaimHelper, opts *bind.TransactOpts) *ClaimHelper

+ func (h *OutputHonestHelper) AttackWithTransactOpts(ctx context.Context, claimIdx int64, opts *bind.TransactOpts)

+ type PreimageLoadCheck func(types.TraceProvider, uint64) error

Jan 31, 2024

Changes in this version

type FactoryHelper

+ func (h *FactoryHelper) PreimageHelper(ctx context.Context) *preimage.Helper

type OutputCannonGameHelper

+ func (g *OutputCannonGameHelper) ChallengeToFirstGlobalPreimageLoad(ctx context.Context, outputRootClaim *ClaimHelper, ...)

type OutputGameHelper

+ func (g *OutputGameHelper) ExecDepth(ctx context.Context) types.Depth

Jan 6, 2024

Changes in this version

type ClaimHelper

+ func (c *ClaimHelper) Depth() types.Depth

+ func (c *ClaimHelper) IsBottomGameRoot(ctx context.Context) bool

+ func (c *ClaimHelper) IsRootClaim() bool

+ func (c *ClaimHelper) RequireOnlyCounteredBy(ctx context.Context, expected ...*ClaimHelper)

type ContractClaim

+ Bond *big.Int

+ Claimant common.Address

+ CounteredBy common.Address

type FactoryHelper

+ func (h *FactoryHelper) StartOutputAlphabetGameWithCorrectRoot(ctx context.Context, l2Node string, l2BlockNumber uint64) *OutputAlphabetGameHelper

type OutputAlphabetGameHelper

+ func (g *OutputAlphabetGameHelper) CreateDishonestHelper(ctx context.Context, l2Node string, defender bool) *DishonestHelper

+ func (g *OutputAlphabetGameHelper) CreateHonestActor(ctx context.Context, l2Node string) *OutputHonestHelper

type OutputGameHelper

+ func (g *OutputGameHelper) ChallengeClaim(ctx context.Context, claim *ClaimHelper, performMove Mover, ...)

+ func (g *OutputGameHelper) DefendClaim(ctx context.Context, claim *ClaimHelper, performMove Mover)

type OutputHonestHelper

+ func (h *OutputHonestHelper) AttackClaim(ctx context.Context, claim *ClaimHelper) *ClaimHelper

+ func (h *OutputHonestHelper) DefendClaim(ctx context.Context, claim *ClaimHelper) *ClaimHelper

+ func (h *OutputHonestHelper) StepClaimFails(ctx context.Context, claim *ClaimHelper, isAttack bool)

Dec 22, 2023

Changes in this version

+ type ClaimHelper struct

+ func (c *ClaimHelper) AgreesWithOutputRoot() bool

+ func (c *ClaimHelper) Attack(ctx context.Context, value common.Hash) *ClaimHelper

+ func (c *ClaimHelper) Defend(ctx context.Context, value common.Hash) *ClaimHelper

+ func (c *ClaimHelper) IsMaxDepth(ctx context.Context) bool

+ func (c *ClaimHelper) IsOutputRoot(ctx context.Context) bool

+ func (c *ClaimHelper) IsOutputRootLeaf(ctx context.Context) bool

+ func (c *ClaimHelper) RequireCorrectOutputRoot(ctx context.Context)

+ func (c *ClaimHelper) RequireDifferentClaimValue(other *ClaimHelper)

+ func (c *ClaimHelper) WaitForCounterClaim(ctx context.Context) *ClaimHelper

+ func (c *ClaimHelper) WaitForCountered(ctx context.Context)

+ type DisputeSystem interface

+ L1Deployments func() *genesis.L1Deployments

+ L2Genesis func() *core.Genesis

+ NodeClient func(name string) *ethclient.Client

+ NodeEndpoint func(name string) string

+ RollupCfg func() *rollup.Config

+ RollupClient func(name string) *sources.RollupClient

+ RollupEndpoint func(name string) string

type FactoryHelper

+ func (h *FactoryHelper) StartOutputAlphabetGame(ctx context.Context, l2Node string, l2BlockNumber uint64, ...) *OutputAlphabetGameHelper

+ func (h *FactoryHelper) StartOutputCannonGame(ctx context.Context, l2Node string, l2BlockNumber uint64, ...) *OutputCannonGameHelper

+ func (h *FactoryHelper) StartOutputCannonGameWithCorrectRoot(ctx context.Context, l2Node string, l2BlockNumber uint64) *OutputCannonGameHelper

+ type OutputAlphabetGameHelper struct

+ func (g *OutputAlphabetGameHelper) StartChallenger(ctx context.Context, l2Node string, name string, options ...challenger.Option) *challenger.Helper

+ type OutputCannonGameHelper struct

+ func (g *OutputCannonGameHelper) CreateHonestActor(ctx context.Context, l2Node string, options ...challenger.Option) *OutputHonestHelper

+ func (g *OutputCannonGameHelper) StartChallenger(ctx context.Context, l2Node string, name string, options ...challenger.Option) *challenger.Helper

+ type OutputGameHelper struct

+ func (g *OutputGameHelper) Addr() common.Address

+ func (g *OutputGameHelper) Attack(ctx context.Context, claimIdx int64, claim common.Hash)

+ func (g *OutputGameHelper) ChallengeRootClaim(ctx context.Context, performMove Mover, attemptStep Stepper)

+ func (g *OutputGameHelper) Defend(ctx context.Context, claimIdx int64, claim common.Hash)

+ func (g *OutputGameHelper) DefendRootClaim(ctx context.Context, performMove Mover)

+ func (g *OutputGameHelper) DisputeLastBlock(ctx context.Context) *ClaimHelper

+ func (g *OutputGameHelper) GameDuration(ctx context.Context) time.Duration

+ func (g *OutputGameHelper) GenesisBlockNum(ctx context.Context) uint64

+ func (g *OutputGameHelper) GetClaimPosition(ctx context.Context, claimIdx int64) types.Position

+ func (g *OutputGameHelper) GetClaimValue(ctx context.Context, claimIdx int64) common.Hash

+ func (g *OutputGameHelper) L2BlockNum(ctx context.Context) uint64

+ func (g *OutputGameHelper) LogGameData(ctx context.Context)

+ func (g *OutputGameHelper) MaxDepth(ctx context.Context) int64

+ func (g *OutputGameHelper) Resolve(ctx context.Context)

+ func (g *OutputGameHelper) ResolveClaim(ctx context.Context, claimIdx int64)

+ func (g *OutputGameHelper) RootClaim(ctx context.Context) *ClaimHelper

+ func (g *OutputGameHelper) SplitDepth(ctx context.Context) int64

+ func (g *OutputGameHelper) Status(ctx context.Context) Status

+ func (g *OutputGameHelper) StepFails(claimIdx int64, isAttack bool, stateData []byte, proof []byte)

+ func (g *OutputGameHelper) WaitForAllClaimsCountered(ctx context.Context)

+ func (g *OutputGameHelper) WaitForClaimAtDepth(ctx context.Context, depth int)

+ func (g *OutputGameHelper) WaitForClaimAtMaxDepth(ctx context.Context, countered bool)

+ func (g *OutputGameHelper) WaitForClaimCount(ctx context.Context, count int64)

+ func (g *OutputGameHelper) WaitForCorrectOutputRoot(ctx context.Context, claimIdx int64)

+ func (g *OutputGameHelper) WaitForGameStatus(ctx context.Context, expected Status)

+ func (g *OutputGameHelper) WaitForInactivity(ctx context.Context, numInactiveBlocks int, untilGameEnds bool)

+ func (g *OutputGameHelper) WaitForNewClaim(ctx context.Context, checkPoint int64) (int64, error)

+ type OutputHonestHelper struct

+ func (h *OutputHonestHelper) Attack(ctx context.Context, claimIdx int64)

+ func (h *OutputHonestHelper) Defend(ctx context.Context, claimIdx int64)

+ func (h *OutputHonestHelper) StepFails(ctx context.Context, claimIdx int64, isAttack bool)

Oct 6, 2023

Changes in this version

type AlphabetGameHelper

+ func (g *AlphabetGameHelper) CreateDishonestHelper(alphabetTrace string, depth uint64, defender bool) *DishonestHelper

type FaultGameHelper

+ func (g *FaultGameHelper) GetClaimPosition(ctx context.Context, claimIdx int64) types.Position

Sep 25, 2023

Changes in this version

type AlphabetGameHelper

+ func (g *AlphabetGameHelper) CreateHonestActor(ctx context.Context, alphabetTrace string, depth uint64) *HonestHelper

+ type DishonestHelper struct

+ func NewDishonestHelper(g *FaultGameHelper, correctTrace *HonestHelper, defender bool) *DishonestHelper

+ func (d *DishonestHelper) ExhaustDishonestClaims(ctx context.Context)

+ func (t *DishonestHelper) Attack(ctx context.Context, claimIndex int64)

+ func (t *DishonestHelper) AttackCorrect(ctx context.Context, claimIndex int64)

+ func (t *DishonestHelper) Defend(ctx context.Context, claimIndex int64)

+ func (t *DishonestHelper) DefendCorrect(ctx context.Context, claimIndex int64)

+ type ErrWithData interface

+ ErrorData func() interface{}

type FactoryHelper

+ func (h *FactoryHelper) StartCannonGameWithCorrectRoot(ctx context.Context, rollupCfg *rollup.Config, l2Genesis *core.Genesis, ...) (*CannonGameHelper, *HonestHelper)

type FaultGameHelper

+ func (g *FaultGameHelper) Addr() common.Address

+ func (g *FaultGameHelper) ChallengeRootClaim(ctx context.Context, performMove Mover, attemptStep Stepper)

+ func (g *FaultGameHelper) DefendRootClaim(ctx context.Context, performMove Mover)

+ func (g *FaultGameHelper) GetClaimUnsafe(ctx context.Context, claimIdx int64) ContractClaim

+ func (g *FaultGameHelper) GetClaimValue(ctx context.Context, claimIdx int64) common.Hash

+ func (g *FaultGameHelper) ResolveAllClaims(ctx context.Context)

+ func (g *FaultGameHelper) ResolveClaim(ctx context.Context, claimIdx int64)

+ func (g *FaultGameHelper) Status(ctx context.Context) Status

+ func (g *FaultGameHelper) StepFails(claimIdx int64, isAttack bool, stateData []byte, proof []byte)

+ func (g *FaultGameHelper) WaitForAllClaimsCountered(ctx context.Context)

+ func (g *FaultGameHelper) WaitForClaimAtDepth(ctx context.Context, depth int)

+ func (g *FaultGameHelper) WaitForInactivity(ctx context.Context, numInactiveBlocks int, untilGameEnds bool)

+ func (g *FaultGameHelper) WaitForNewClaim(ctx context.Context, checkPoint int64) (int64, error)

type HonestHelper

+ func (h *HonestHelper) StepFails(ctx context.Context, claimIdx int64, isAttack bool)

+ type Mover func(parentClaimIdx int64)

+ type Stepper func(parentClaimIdx int64)

Aug 16, 2023

Changes in this version

+ type AlphabetGameHelper struct

+ func (g *AlphabetGameHelper) StartChallenger(ctx context.Context, l1Endpoint string, name string, ...) *challenger.Helper

+ type CannonGameHelper struct

+ func (g *CannonGameHelper) CreateHonestActor(ctx context.Context, rollupCfg *rollup.Config, l2Genesis *core.Genesis, ...) *HonestHelper

+ func (g *CannonGameHelper) StartChallenger(ctx context.Context, rollupCfg *rollup.Config, l2Genesis *core.Genesis, ...) *challenger.Helper

type FactoryHelper

+ func (h *FactoryHelper) StartCannonGame(ctx context.Context, rootClaim common.Hash) *CannonGameHelper

+ func (h *FactoryHelper) StartChallenger(ctx context.Context, l1Endpoint string, name string, ...) *challenger.Helper

type FaultGameHelper

+ func (g *FaultGameHelper) Attack(ctx context.Context, claimIdx int64, claim common.Hash)

+ func (g *FaultGameHelper) Defend(ctx context.Context, claimIdx int64, claim common.Hash)

+ func (g *FaultGameHelper) GameDuration(ctx context.Context) time.Duration

+ func (g *FaultGameHelper) LogGameData(ctx context.Context)

+ func (g *FaultGameHelper) MaxDepth(ctx context.Context) int64

+ type HonestHelper struct

+ func (h *HonestHelper) Attack(ctx context.Context, claimIdx int64)

+ func (h *HonestHelper) Defend(ctx context.Context, claimIdx int64)

type Status

+ func (s Status) String() string

Jul 25, 2023

Changes in this version

+ var CorrectAlphabet = "abcdefghijklmnop"

+ type ContractClaim struct

+ Claim [32]byte

+ Clock *big.Int

+ Countered bool

+ ParentIndex uint32

+ Position *big.Int

+ type FactoryHelper struct

+ func NewFactoryHelper(t *testing.T, ctx context.Context, client *ethclient.Client, ...) *FactoryHelper

+ func (h *FactoryHelper) StartAlphabetGame(ctx context.Context, claimedAlphabet string) *FaultGameHelper

+ type FaultGameHelper struct

+ func (g *FaultGameHelper) Resolve(ctx context.Context)

+ func (g *FaultGameHelper) StartChallenger(ctx context.Context, l1Endpoint string, name string, ...) *challenger.Helper

+ func (g *FaultGameHelper) WaitForClaim(ctx context.Context, predicate func(claim ContractClaim) bool)

+ func (g *FaultGameHelper) WaitForClaimAtMaxDepth(ctx context.Context, countered bool)

+ func (g *FaultGameHelper) WaitForClaimCount(ctx context.Context, count int64)

+ func (g *FaultGameHelper) WaitForGameStatus(ctx context.Context, expected Status)

+ type Status uint8

+ const StatusChallengerWins

+ const StatusDefenderWins

+ const StatusInProgress